/website-1

Primary LanguageCSSApache License 2.0Apache-2.0

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
  1. 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
  2. Navega aquí

  3. ¡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

  1. 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/