Objetivo #

Dejar funcionando un sitio personal con Hugo en Windows, usando Git, el tema Congo y publicación en GitHub Pages, dejando además el camino preparado para usar dominio propio más adelante.

Punto de partida #

El proceso empezó con estos objetivos:

usar una plataforma abierta
evitar servicios cerrados tipo Blogger
mantener costo casi cero
escribir en Markdown
tener un sitio limpio, legible y fácil de mantener
dejar abierta la posibilidad de conectar dominio propio más adelante
renegar un poco con casos prácticos para aprender la tecnología de verdad

Entorno usado #

Windows
Hugo Extended
Git for Windows
tema Congo
asistencia de ChatGPT 5.4 Thinking, y algo de Gemini

Proceso realizado #

1. Instalación de Hugo #

Primero descargué Hugo para Windows, dejé el ejecutable en una carpeta local y lo agregué al PATH. La verificación inicial fue con:

hugo version

Ese paso confirmó que Hugo ya estaba disponible desde la consola.

2. Instalación de Git #

Después instalé Git for Windows y verifiqué la instalación con:

git --version

Al principio usé Git Bash, pero para este trabajo terminé pasando a CMD, simplemente porque me resultó más cómodo para copiar y pegar comandos en Windows.

3. Creación del proyecto #

Con Hugo funcionando, creé el proyecto inicial con:

hugo new project sitio-personal

Después inicialicé Git dentro de la carpeta del proyecto con:

git init

A partir de ahí ya tenía una base local sobre la cual empezar a trabajar.

4. Elección del tema #

La elección del tema llevó más vueltas de las que parecía. Hubo discusión entre Gemini, ChatGPT y yo haciendo de árbitro, y la decisión final fue usar Congo.

La elección quedó basada en un equilibrio entre:

sobriedad
flexibilidad
soporte para notas, imágenes y esquemas
mantenimiento razonable

No era el tema más básico, pero tampoco uno exageradamente cargado ni orientado a algo corporativo.

5. Instalación del tema #

Una vez elegido, agregué Congo como submódulo del proyecto con:

git submodule add https://github.com/jpanther/congo.git themes/congo

Con eso el tema quedó incorporado al repositorio sin mezclar su código directamente con el del sitio.

6. Cambio a Hugo Extended #

La primera contrariedad apareció enseguida: Congo requiere Hugo Extended.
Yo había arrancado con la edición estándar de Hugo, así que tuve que reemplazarla por la versión Extended para que el tema pudiera compilar correctamente.

7. Configuración inicial #

Después armé un hugo.toml mínimo para que el sitio arrancara con una configuración básica y usable.
La idea en esta etapa no fue dejar todo perfecto, sino simplemente lograr una base funcional sobre la cual seguir ajustando el resto más adelante.

8. Corrección de compatibilidad #

La segunda contrariedad fue más concreta: apareció un error de compatibilidad entre la versión actual de Hugo y un partial del tema Congo.
La solución aplicada fue anular localmente ese partial creando el archivo:

layouts/partials/functions/warnings.html

vacío, para que el sitio pudiera renderizar sin romper.
No fue la clase de problema que uno imagina al empezar, pero justamente también formó parte del aprendizaje práctico del proceso.

9. Prueba local #

Una vez resueltos esos puntos, el sitio quedó levantado localmente con:

hugo server -D

y accesible en:

http://localhost:1313/

Ese -D fue importante porque permite ver también los contenidos que siguen marcados como borrador.

10. Publicación en GitHub #

Con el sitio funcionando localmente, el paso siguiente fue inicializar el repositorio correctamente, hacer el primer commit y subir el proyecto a GitHub.
Después se configuró el despliegue con GitHub Pages usando GitHub Actions, de forma que cada push a la rama principal vuelva a compilar y publicar el sitio automáticamente.

11. Primera publicación visible en línea #

Finalmente, el sitio quedó visible en línea en:

https://pablomarchiori.github.io/sitio-personal/

Con eso quedó resuelta la primera meta completa: pasar de una carpeta vacía en Windows a un sitio estático publicado y accesible desde Internet.

12. Ajuste visual final #

Ya con el sitio funcionando, apareció un detalle menor pero molesto: el espaciado entre bullets dentro de las notas quedaba demasiado abierto.
Primero intenté resolverlo con un archivo assets/css/custom.css, pero en este caso no estaba siendo tomado por el tema como esperaba.

La solución que sí funcionó fue otra:

crear static/css/custom.css
cargarlo explícitamente desde layouts/partials/extend-head.html

Con eso pude ajustar el espaciado de listas sin tocar el tema Congo directamente. Fue un buen cierre para la instalación, porque dejó resuelto no solo el despliegue del sitio, sino también un primer ajuste visual real sobre la presentación del contenido.

Estado actual #

En este punto, el sitio ya quedó:

funcionando localmente
publicado en GitHub Pages
con una portada básica
con la sección Notas visible
con la primera nota publicada
y con una base lista para seguir creciendo

Qué sigue después #

Los pasos siguientes ya quedan fuera de esta primera etapa, pero forman parte natural de la continuación del proyecto:

conectar el sitio con dominio propio
ordenar mejor las secciones reales del sitio
documentar cómo mantenerlo y publicar nuevas notas
definir una estructura más estable para categorías y contenido

Cierre #

La primera etapa quedó resuelta: ya existe una base funcional, editable localmente y publicada en línea.
Más importante todavía: el proceso no quedó solo como resultado técnico, sino también como registro de instalación, errores reales, decisiones tomadas y soluciones aplicadas. Y eso, para un sitio que también quiere servir como archivo personal de trabajo, ya es parte del proyecto.

Ahora hay que aprenderse esto! 😅

git add content\notas\instalacion-del-sitio.md
git commit -m "Actualizar nota de instalación del sitio"
git push