Hugo

Hugo es un framework que permite crear websites estáticos de forma muy rápida.

La comunidad de desarrolladores ha creado multitud de temas que puedes usar de forma gratuita para tu blog personal. Desde la web de Hugo puedes acceder a muchos de ellos y si buscas en internet puedes encontrar muchos más.

Un par de temas que me han gustado:

• Tema docport

• Tema Bookworm

Highlight: lista de lenguajes de programación

• highlight

Comandos básicos

Se da por supuesto que Hugo está instalado en el equipo.

Crear un nuevo sitio con Hugo

hugo new site [path] [flags]

Crear un nuevo post

hugo new posts/primer-post.md

Arrancar servidor

# Desde la terminal, y situado en la carpeta del proyecto:
hugo server

Generar sitio

hugo;
## Aunque es mejor usar el comando siguiente para generar el sitio en la carpeta public:
hugo --gc --minify --cleanDestinationDir

• hugo –minify -> Compila y minifica todo en la carpeta public/.
• hugo –gc -> Garbage Collection: Borra archivos temporales y recursos del caché que ya no se usan.
• hugo –cleanDestinationDir -> Borra todo lo que haya en public/ antes de volver a escribir (evita que se queden archivos viejos).

Goldmark ¡Ojo con esto!

Hugo utiliza una biblioteca para renderizar Markdown denominada Goldmark. Por defecto, el parámetro unsafe de goldmark vale false. Esto implica que Goldmark no procesa HTML. Para activarlo, desde el fichero config.toml haga lo siguiente:

[markup.goldmark.renderer]
unsafe= true

Ahora sí se renderizarán los enlaces e imágenes que incluyas en tus ficheros markdown.