Website del sitio de la comunidad de Artesanos de Software
CSS HTML Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
archetypes
content
data
foo
layouts
static
themes/default
.gitignore
LICENSE
README.md
build.sh
config.toml
deploy-test.sh
remote-deploy.sh
run.sh

README.md

Artesanos de Software

Build Status

Este es el código fuente del sitio de Artesanos de Software. Antes usábamos Wordpress pero se convirtió en un problema cuando recibimos muchos ataques y mantener un CMS fue un problema que no queríamos tener.

Ahora el sitio de construye con Hugo que realmente necesita archivos Markdown y la definición de plantillas para generar un sitio estático.

También empezamos a usar Disqus para los comentarios.

Si deseas participar, has fork, agrega tu entrada y manda un Pull Request.

Como correr el sitio en tu computadora

  1. Descarga los fuentes del proyecto
  2. Instala Hugo
    • Asegurate que la versión de Hugo sea por lo menos la 0.13, de no ser así y si instalaste con brew, entonces haz un brew update e intenta de nuevo la instalación.
  3. En la raiz del proyecto en una terminal ejecuta:

    rm -rf public && hugo server --watch --verbose 

    Tambien puedes ejecutar el siguiente shell script:

    ./run.sh
  4. Navega aquí
  5. ¡Disfruta!

Como crear una nueva entrada

  1. Tener instalado Hugo
  2. En la raiz del proyecto en una terminal ejecuta:

    hugo new post/el-nombre-de-tu-nueva-entrada.md

    Es importante que el archivo termine con la extensión .md

  3. El archivo de tu entrada se localizara en:

    ./content/post/el-nombre-de-tu-nueva-entrada.md
    

    Ahora puedes editarlo usando Markdown

  4. Ejecutar el sitio, revisa la sección anterior. Ya debería estar disponible tu nueva entrada.

Reglas para crear nuevas entradas

  • Las entradas deben crearse dentro del directorio ./content/post/
  • El nombre del archivo debe seguir la siguiente estructura:

    {año}-{mes}-{dia}-{nombre}.md
    

    Ejemplos:

    2015-04-11-mi-nueva-entrada.md
    

    el nombre del archivo se sugiere que sea breve, pero que indique claramente sobre que se trata.

  • Se recomienda que el nombre del archivo no incluya caracteres que no sean URL encoded

  • Cualquier entrada de Artesanía de software es bienvenida, anímate y mándanos tu pull request !!!

Front matter

Un feature muy interesante de Hugo es el Front Matter, Hugo agrega al inicio del archivo del post algo parecido a lo siguiente:

  ---
  categories:
    - category
  date: 2015-04-12T14:02:40-05:00
  layout: post
  tags:
    - tag
  title: mi-post
  ---

Se debe agregar la información sobre el post lo más detallada posible. Un ejemplo de ello:

  ---
  title: 1er BarCamp de Testing en la Ciudad de México
  author: cggg88
  layout: post
  date: 2013-11-14
  url: /2013/11/14/1er-barcamp-de-testing-en-la-ciudad-de-mexico/
  categories:
    - Evento
  tags:
    - barcamp
    - testing
  ---

Autoría

Es muy importante saber quien es el autor del post, es por ello es importante que se agregue la información en el campo author del front matter. Tenemos pendiente #5 una página mejor para la información del autor.

URL

En el front matter se debe poner la información de la URL usando el siguiente patrón:

  url: {año}/{mes}/{día}/{slug}

Ejemplo

  url: /2013/11/14/1er-barcamp-de-testing-en-la-ciudad-de-mexico/