Este es el código fuente del sitio de Cloud Native Mexico.
El sitio de construye con Hugo que solamente necesita archivos Markdown y la definición de plantillas para generar un sitio estático.
También usamos 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.47
-
En el directorio
site
del proyecto en una terminal ejecuta:./run.sh
-
Navega aquí
-
¡Disfruta!
-
Tener instalado Hugo
-
En el directorio
site
del proyecto en una terminal ejecuta:hugo new blog/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/blog/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/blog/
-
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 Cloud Native 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:
---
title: "Meetup Enero 2018"
date: 2018-01-04T19:11:05-06:00
featured_image: /media/2018/01/post-thumb-1.png
featured_image_source: https://unsplash.com/photos/bL8MDg0p_nI
author: domix
url: /meetup-enero-2018/
categories:
- Evento
---
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.
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