Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:software:hugo [2021/04/03 15:53] – [Crear un nuevo sitio] tempwin
+++ informatica:software:hugo [2021/04/03 16:55] (actual) – [Crear páginas estáticas] tempwin
@@ Línea 4: / Línea 4: @@
   * [[http://gohugo.io/|Web oficial]]
-===== Crear un nuevo sitio =====
+===== Uso =====
+==== Crear un nuevo sitio ====
 <code bash>
@@ Línea 36: / Línea 38: @@
   * ''themes''
-===== Instalar tema =====
+==== Instalar tema ====
-Nos movemos dentro de la carpeta del nuevo sitio y:
+Nos movemos dentro de la carpeta del nuevo sitio e inicializamos un repositorio Git vacío:
 <code bash>
@@ Línea 49: / Línea 51: @@
 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]]