Migrando el contenido

Ok, más que "migrando", debería decir "copypasteando" el contenido. Pero bueno, ponele que es más o menos lo mismo.

Empecé por la documentación del Getting Started pero me dio fiaca seguir así que:

• Arranqué el server de Hugo: `hugo server -D`.
• Noté que la "Home" mostraba esto: "Recents posts"
• Me dispuse a encontrar cómo editar esa "Home"

(una aclaración: como planeo hacer un step by step con los artículos que escribo, esta etapa inicial de la migración va a ser sin ningún tweak de diseño o similar, sino simplemente el contenido. Ya lo dice el título pero aclaro por las dudas 😝)

Organización del contenido

Revisando la documentación me encontré con esto: "Organization of Content Source". Me pareció un concepto bastante cómodo:

Comenzando por el directorio content/, todos su subdirectorios van a ser como las URLs del sitio. Es decir, dada esta estructura:

└── content
     └── acerca-de
         └── index.md
     └──posts
         └── primer-post.md

Huguito va a generar las siguientes URLs para navegar:

• https://ejemplo.com/acerca-de/
• https://ejemplo.com/primer-post/

¡Muy bueno! Vamos a usarlo, a ver…

Fijate en el commit las URLs que mapeé del sitio online, chequeo en el local server que funcionen:

• http://localhost:1313/how-i-work/

• http://localhost:1313/experience/
• http://localhost:1313/contact-me/

Excelente, ya tenemos las páginas armadas. Pero todavía me falta saber cómo sacar eso de "Recent Posts" de la Home, volvemos a la documentación a buscar…

Terminé recurriendo al viejo truco

no encontré en la documentación lo que buscaba, así que me fui al VS Code y usé el "Go To File…" (CMD+P) y busqué "index" (por costumbre en la industria así se suelen llamar los archivos de las "Homes" de un sitio web) y encontré uno en la carpeta de layouts/index.html. Lo abrí y tipeé: WATAFUK en la línea 3, para chequear rápidamente en el browser si este es el archivo que efectivamente estoy buscando para editar lo de "Recents posts", me voy al browser y chequeo http://localhost:1313/:

Ok, este es el archivo que necesitamos modificar (si alguien tiene un método más moderno me dice! Así aprendo jajaj)

Borro el WATAFUK (ante la duda usar "TEST" mejor, estas cosas a veces se escapan y terminan en producción, Twitter está lleno de ejemplos, me pregunto cuál será el hashtag) y me dispongo a leer el código.

Después de jugar un poco con el código, preparo mis cambios, va todo hardcodeado por ahora.

Un problemita con Git

Esto es un branch en el artículo. Con mis cambios listos, me voy a la terminal a commitear y pushear, para conseguir el link del commit y así poder usar el link en este artículo, mientras escribo. Cuestión que cuando chequeo mi diff (siempre chequear git diff antes de commitear, se ahorran potenciales bugs o código pusheado que no debería haber sido [WATAFUK]) veo esto:

~/not-real/marcelomazza.com.ar (hugo *) $ d
diff --git a/themes/ananke b/themes/ananke
--- a/themes/ananke
+++ b/themes/ananke
@@ -1 +1 @@
-Subproject commit 8845854aa9ab5af79066e840d8c884fbbb8a269d
+Subproject commit 8845854aa9ab5af79066e840d8c884fbbb8a269d-dirty

Eso es porque si recuerdan en el artículo anterior mencioné que la guía Getting Started nos instruyó a instalar el theme como un Git submodule.

Bueno, lo cierto es que no estoy muy interiorizado en cómo funcionan los Git submodules (tienen sus mañas), traté de pushear y se abrieron una serie de complicaciones…

Así que dejo por hoy y saldrá un próximo artículo de mi lucha contra los Git submodules…