Este es el código fuente del sitio de Groovyando. 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.
- Descarga los fuentes del proyecto
- Instala Hugo
- Asegurate que la versión de Hugo sea por lo menos la 0.14
-
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
-
Navega aquí
-
¡Disfruta!
-
Tener instalado Hugo
-
En la raiz del proyecto en una terminal ejecuta:
hugo new article/el-nombre-de-tu-nueva-entrada.md
Es importante que el archivo termine con la extensión .md
-
El archivo de tu entrada se localizara en:
./content/article/el-nombre-de-tu-nueva-entrada.md
Ahora puedes editarlo usando Markdown
- Ejecutar el sitio, revisa la sección anterior. Ya debería estar disponible tu nueva entrada.
-
Las entradas deben crearse dentro del directorio ./content/article/
-
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 sobre Groovy y su ecosistema es bienvenida, anímate y mándanos tu pull request !!!
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
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
date: 2013-11-14
url: /2013/11/14/1er-barcamp-de-testing-en-la-ciudad-de-mexico/
categories:
- Evento
tags:
- barcamp
- testing
---
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.
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/