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.
- Haz un clone del repositorio en tu maquina
- Recomendamos que hagas un fork
- 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 post/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/post/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/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 !!!
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
---
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.
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
Si tienes duda sobre como actualizar tu fork del repositorio original, sigue esta guía