SpringHispano.org

Este es el código fuente del sitio de SpringHispano.org. Antes usábamos Drupal 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 de este repositorio, agrega tu entrada y manda un Pull Request.

Como correr el sitio en tu computadora

1. Haz un clone del repositorio en tu maquina

• Recomendamos que hagas un fork

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 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-09-03-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 el ecosistema de Spring 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:

---
Section: post
Categories:
- Post
Description: Segundo por
date: 2015-09-04
title: Retomando el camino
url: /post/retomando-el-camino
---

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

---
Section: post
Categories:
- Post
Description: Segundo por
Tags:
- anuncio
- comunidad
date: 2015-09-04
title: Retomando el camino
url: /post/retomando-el-camino
featured_image: /2015/09/03/camino.jpg
featured_text: Avanzando el camino
author_id: domix
author_name: Domingo Suárez Torres
---

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_id y author_name del front matter.

URL

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

url: {categoria}/{slug}

Ejemplo

url: /post/retomando-el-camino

Referencias

Como mantener actualizado tu fork:

Si tienes duda sobre como actualizar tu fork del repositorio original, sigue esta guía