Groovyando

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.

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.14

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 article/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/article/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/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 !!!

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
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
---

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/