Translate

martes, 25 de febrero de 2020

Generar sitios estáticos con Hugo


Hugo es uno de los generadores de sitios estáticos de código abierto más populares. Con su sorprendente velocidad y flexibilidad, Hugo hace que la creación de sitios web sea divertido.

Homebrew, un administrador de paquetes para macOS y linux, se puede instalar desde brew.sh. Luego de instalar brew

brew install hugo

Para verificar su nueva instalación:

hugo version

Ahora podemos crear el sitio : 

hugo new site quickstart

El sitio se llama quickstart. Ahora vamos a agregar un tema. Primero, debemos descargar el tema de Github y agregarlo al directorio de temas de su sitio Hugo. Podemos ver los temas en themes.gohugo.io. Vamos a utilizar el tema Ananke.

cd quickstart
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

El tema lo podemos descargar desde: https://github.com/budparr/gohugo-theme-ananke/archive/master.zip si no queremos usar git. Extraemos ese archivo .zip para obtener un directorio "gohugo-theme-ananke-master". Luego cambiamos el nombre de ese directorio a "ananke" y lo movemos al directorio "themes /".

Luego, agregue el tema a la configuración del sitio:

echo 'theme = "ananke"' >> config.toml

Ahora agregamos el contenido :

Se puede crear archivos de contenido manualmente (por ejemplo, como contenido / <CATEGORY> / <FILE>. <FORMAT>) y proporcionar metadatos en ellos, sin embargo, puede usar un comando:

hugo new posts/my-first-post.md

Edite el archivo de contenido recién creado si lo desea, comenzará con algo como esto:

---
title: "My First Post"
date: 2019-03-26T08:47:11+01:00
draft: true
---

Ahora, vamos a iniciar el servidor Hugo:

hugo server -D

                   | EN
+------------------+----+
  Pages            | 10
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  3
  Processed images |  0
  Aliases          |  1
  Sitemaps         |  1
  Cleaned          |  0

Total in 11 ms
Watching for changes in /Users/bep/quickstart/{content,data,layouts,static,themes}
Watching for config changes in /Users/bep/quickstart/config.toml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

Podemos navegar en http://localhost:1313/

Podemos editar o agregar contenido nuevo y luego simplemente actualizar el navegador para ver los cambios.

Cuando el sitio este listo, debemos cambiar las configuraciones. Debemos editar config.toml y cambiar los valores:

baseURL = "https://example.org/"
languageCode = "en-us"
title = "My New Hugo Site"
theme = "ananke"

Además, si ya tenemos un dominio listo, podemos configurar baseURL. Tenga en cuenta que este valor no es necesario cuando se ejecuta el servidor de desarrollo local.

Luego debemos reconstruir nuestro sitio con:

hugo -D

La salida estará en el directorio ./public/ de forma predeterminada (-d / - marca de destino para cambiarlo, o establecer publicar dir en el archivo de configuración).

Dejo link: https://gohugo.io/