Hola Hugo

Contaba en la anterior un poquito de la tarea en la que me estoy embarcando, si no lo leíste, acá va: https://marcelomazza.medium.com/reviviendo-mi-sitio-web-24f4bfdbeab5

Pensaba antes de escribir el siguiente artículo (este) estudiar un poco sobre Hugo y cómo funciona pero por lo general me gusta ser directo y ponerme a hacer cosas. Así que con el Getting Started de Hugo a mano, arrancamos. Podés chusmear el repo del sitio en GitHub.

Hacemos un branch e instalamos Hugo:

git checkout -b hugo
brew install hugo

Chequeamos que todo esté en orden:

$ hugo version
hugo v0.83.1+extended darwin/amd64 BuildDate=unknown

¡Perfecto! El paso 2 del Getting Started propone este comando: hugo new site quickstart el cual según el mismo instructivo va a crear una carpeta quickstart y crear allí un nuevo sitio. En mi caso, como quiero instalarlo en el "current directory", vamos con la opción--force (https://gohugo.io/commands/hugo_new_site/).

Antes de correr el comando también decidí borrar todos los archivos y contenidos generados por Gatsby para empezar de cero con Hugo.

Vayamos con hugo new site:

$ hugo new site  . --force
Congratulations! Your new Hugo site is created in /Users/marcelo/psl/marcelomazza.com.ar.
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.

A futuro calculo que crearé un theme nuevo, por ahora voy a usar Ananke que es el sugerido por el Getting Started. La guía sugiere agregar el theme como un Git submodule así que allá vamos:

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo theme = \"ananke\" >> config.toml

La guía continúa sugiriendo usar el comando "hugo new" para crear contenido, vamos a probarlo:

hugo new posts/primer-post.md

Bueno, llegamos al momento culmine, a ver el server de Huguito cómo arranca:

$ hugo server -D
Start building sites …
| EN  
-------------------+-----
  Pages            | 10  
  Paginator pages  |  0  
  Non-page files   |  0  
  Static files     |  1  
  Processed images |  0  
  Aliases          |  1  
  Sitemaps         |  1  
  Cleaned          |  0
Built in 24 ms
Watching for changes in /Users/marcelo/psl/marcelomazza.com.ar/{archetypes,content,data,layouts,static,themes}
Watching for config changes in /Users/marcelo/psl/marcelomazza.com.ar/config.toml, /Users/marcelo/psl/marcelomazza.com.ar/themes/ananke/config.yaml
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

Excelente. El sitio puede ser previsualizado en: http://localhost:1313/ y se ve así:

Cómo se ve el sitio siguiendo la guía de Getting Started

Configuramos el sitio con la info inicial en el archivo config.toml

baseURL = "https://marcelomazza.com.ar/"
languageCode = "en-es"
title = "Marcelo Mazza"
theme = "ananke"

Por último la guía Getting started menciona cómo hacer un build pero vamos a estar viendo esto en las próximas entregas.

Continuará

Hasta acá este primer acercamiento a Hugo. Mi objetivo en este punto es migrar el contenido del sitio viejo al nuevo (no es mucho así que lo haré a mano) y luego chequear y configurar el hosting para que https://marcelomazza.com.ar/ ya corra sobre Hugo y poder escribir futuros artículos directamente ahí.

Aunque voy a extrañar lo lindo que es Medium.

Veremos qué depara el destino.