Mostrando las entradas con la etiqueta Hugo. Mostrar todas las entradas
Mostrando las entradas con la etiqueta Hugo. Mostrar todas las entradas

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/