====== Hugo ======

Generador de sitios webs estáticos.

  * [[http://gohugo.io/|Web oficial]]
===== Uso =====

==== Crear un nuevo sitio ====

<code bash>
hugo new site nombre-sitio
</code>

<code>
Congratulations! Your new Hugo site is created in /home/tempwin/www/hugo/foo.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder.
   Choose a theme from https://themes.gohugo.io/ or
   create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

</code>

Esto creará una carpeta llamada ''nombre-sitio'' en la ruta en la que nos encontremos:

  * ''archetypes''
  * ''config.toml''
  * ''content''
  * ''data''
  * ''layouts''
  * ''static''
  * ''themes''

==== Instalar tema ====

Nos movemos dentro de la carpeta del nuevo sitio e inicializamos un repositorio Git vacío:

<code bash>
git init
</code>

Descargamos, en este caso, el tema **Ananke** a la carpeta ''themes'':

<code bash>
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
</code>

Indicamos en la configuración (''config.toml'') que queremos usar ese tema:

<code>
theme = "ananke"
</code>

==== Añadir contenido ====

=== Manual ===

Creamos el contenido dentro de la carpeta ''content'' siguiendo la nomenclatura: 

''<CATEGORIA>/<FICHERO>.<FORMATO>'' y añadiendo metadatos.

=== Automático ===

Lo más cómodo es usar el comando ''new'' para facilitar ciertos datos:

<code bash>
hugo new posts/hola-mundo.md
</code>

Esto hará que se cree el fichero ''content/posts/hola-mundo.md'' con el contenido:

<code>
---
title: "Hola Mundo"
date: 2021-04-03T16:12:51+02:00
draft: true
---

</code>

  * ''title'' indica el título que tendrá la página. Corresponde también a un h1 dentro de la etiqueta header
  * ''date'': fecha
  * ''draft'': indica si el contenido es un borrador o no. Si está en ''true'', cuando vayamos a generar el contenido estático, Hugo se saltará su generación. 
==== Arrancando el servidor ====

<code bash>
hugo server -D
</code>

Esto iniciará un servidor web accesible desde http://localhost:1313/

Podemos ir haciendo cambios y el servidor los detectará y actualizará la web. Procesará tanto la configuración como el contenido en Markdown.

==== Generar páginas estáticas ====

<code bash>
hugo
</code>

Si queremos que también incluya el contenido marcado como borrador (//draft//), le pasamos la opción ''-D''.

La generación del contenido estático creará un directorio llamado ''public'', este será el directorio que tendremos que subir a nuestro servidor web.

<WRAP center round important 60%>
El comando ''hugo'' no elimina lo que ya estuviese generado, así que se debería borrar el directorio ''public'' antes de ejecutar ese comando
</WRAP>

===== Temas =====

  * Repositorio oficial de temas: https://themes.gohugo.io/

Algunas recomendaciones:

  * [[https://themes.gohugo.io/|Geekdoc]]