La mayoría de mis publicaciones de blog son lecciones aprendidas.Estoy tratando de lograr algo, y estoy documentando el proceso que usé para hacerlo.Este es uno de los pocos donde, al final, no logré lo que quería.En este post, intento explicar lo que aprendí de intentar migrar de Jekyll a Hugo, y por qué, al final, no tomé el paso final. Contexto Yo empecé este blog en WordPress. Después de varios años, decidí He estado contento con Está basado en Ruby, y aunque no soy un desarrollador de Ruby, pude crear algunos plugins. Migración a Jekyll Jekyll Estoy alojando la base de código en GitLab, con GitLab CI, y he configurado Renovate para crear un PR cuando una Gem está desactualizada. De esta manera, pago la deuda técnica cada vez, y no la acumulo a lo largo de los años. Dos . 3.4 4.0 He comprobado si Jekyll estaba listo para Ruby 4. Sin embargo, no es sólo Jekyll: el utiliza joyas cuyas versiones no son compatibles con Ruby 4. La cuestión abierta Gemfile Lo que es peor, comprobé la salud general de la Los últimos compromisos fueron hace unas semanas del bot Continuous Integration. pensé que tal vez era el momento de buscar una alternativa. Proyecto Jekyll Hugo Al igual que Jekyll, Es un generador de sitio estático. Hugo 
 
 Hugo es uno de los generadores de sitios estáticos de código abierto más populares.Con su increíble velocidad y flexibilidad, Hugo hace que la construcción de sitios web sea divertida de nuevo. Hugo es uno de los generadores de sitios estáticos de código abierto más populares.Con su increíble velocidad y flexibilidad, Hugo hace que la construcción de sitios web sea divertida de nuevo. A diferencia de Jekyll, Hugo se basa en Go. Se proclama a sí mismo como "increíblemente rápido". Ve mucho más actividad que Jekyll.Aunque no soy un fan de Go, decidí que Hugo era un buen objetivo de migración. Código de base Jekyll a Hugo La migración de Jekyll a Hugo sigue la ley de Pareto. Migración de contenidos Hugo ofrece las siguientes carpetas principales: 
 
 
 
 
 Contenido para contenido que necesita ser procesado estático para los recursos que se copian como Layouts para templos Datos de fuentes de datos Compruebe el por la exhaustividad. Lista completa Jekyll distingue entre y Los primeros tienen una fecha, los últimos no. Por lo tanto, los mensajes son la base de un blog. Las páginas son estables y la estructura del sitio. Postales Páginas Jekyll carpetas estructura mapas como: 
 
 
 
 
 
 
 
 
 
 
 Jekyll 
 Hugo 
 
 
 
 _posts 
 content/posts 
 
 
 
 _pages/<foo.md> 
 content/posts/<foo.md> 
 
 
 
 _data 
 data 
 
 
 
 _layouts 
 layouts 
 
 
 
 assets 
 static _posts content/posts _pages/<foo.md> content/posts/<foo.md> _data data _layouts layouts assets static Cuando el mapa no es suficiente Ofertas de Jekyll Los plugins vienen en varias categorías: Plugins 
 
 
 
 
 
 
 
 
 Generators - Create additional content on your site Converters - Change a markup language into another format Commands - Extend the jekyll executable with subcommands Tags - Create custom Liquid tags Filters - Create custom Liquid filters Hooks - Fine-grained control to extend the build process 
 
 
 
 
 
 
 Generadores - Crea contenido adicional en tu sitio Conversores - Cambiar un lenguaje de marcado a otro formato Comandos - Extender el jekyll ejecutable con subcomandos Tags - Crear etiquetas de liquidez personalizadas Filtros - Crear filtros de líquido personalizados Hooks - Control de grano fino para extender el proceso de construcción En Jekyll, uso generadores, etiquetas, filtros y ganchos. Otros son personalizados para mis propias necesidades. Plugin de Twitter Jekyll tags traducir a En el hugo: Cortometrajes 
 
 
 Un código corto es un modelo invocado dentro de la marcación, que acepta cualquier número de argumentos.Se pueden usar con cualquier formato de contenido para insertar elementos como vídeos, imágenes y redes sociales incorporados a su contenido. Existen tres tipos de códigos cortos: embedded, custom y inline. Un shortcode es un en el marco de la marca, aceptando cualquier número de Pueden usarse con cualquier formato de contenido para insertar elementos como vídeos, imágenes y redes sociales incorporadas a su contenido. El templo Argumentos Existen tres tipos de códigos cortos: embedded, custom y inline. Hugo ofrece una gran colección de códigos cortos fuera de la caja, pero puede desbloquear su propio. Desafortunadamente, los generadores no tienen ningún equivalente en Hugo. He desarrollado generadores para crear boletines y páginas de conversación. El plugin generador genera automáticamente una página por año según mis datos. Migración de GitLab Build La construcción de Jekyll consta de tres pasos: 
 
 
 
 Detecta si alguna de Gemfile.lock, Dockerfile o .gitlab-ci.yml ha cambiado, y construye la imagen de Docker si es el caso Utiliza la imagen de Docker para construir el sitio Despliegue el sitio en GitLab Pages El cambio más importante ocurre en la Aquí está la nueva versión de Hugo para referencia: Dockerfile FROM docker.io/hugomods/hugo:exts

ENV JAVA_HOME=/usr/lib/jvm/java-21-openjdk
ENV PATH=$JAVA_HOME/bin:$PATH

WORKDIR /builds/nfrankel/nfrankel.gitlab.io

RUN apk add --no-cache openjdk21-jre graphviz \                                      #1
 && gem install --no-document asciidoctor-diagram asciidoctor-diagram-plantuml rouge #2
 
 
 
 Paquetes para Plantuml Gems para diagramas de Asciidoctor y resaltar la sintaxis En este momento, debería haber olido algo pescado, pero funcionó, así que continué. El trastorno del trato He migrado con la ayuda de Claude Code y Copilot CLI. Me tomó unas pocas sesiones, dispersas durante una semana, principalmente durante las noches y los fines de semana. Durante la migración, solicité regularmente comparaciones uno a uno para evitar regresiones. Mi idea era construir los sitios Jekyll y Hugo lado a lado, implementarlos ambos en las páginas de GitLab, y comparar ambas versiones implementadas para las brechas finales. Actualizé la edificación para hacer eso, y desencadené una edificación: la edificación de Jekyll tomó un poco más de dos minutos, mientras que la edificación de Hugo tomó más de diez! Analizé los registros para comprender mejor el problema. Además de un par de advertencias, no vi nada que explique de dónde vino la lentitud.                   │  EN  
──────────────────┼──────
 Pages            │ 2838 
 Paginator pages  │  253 
 Non-page files   │    5 
 Static files     │ 2817 
 Processed images │    0 
 Aliases          │  105 
 Cleaned          │    0 
Total in 562962 ms
 Cuando le pregunté a Claude Code, señaló mi uso de Asciidoc en mis publicaciones. ), delega formatos distintos a Markdown a un motor externo. Para Asciidoc, es Resulta que este enfoque funciona bien para un par de documentos de Asciidoc, no tanto para más de 800. Espacio 5 años. Otros formatos asciidoctor Este thread Dice que estaba decepcionado es una subestimación. dejo el trabajo en una rama. probablemente lo borraré en el futuro, una vez que haya enfriado. Conclusión Antes de trabajar en la migración, hice mi debida diligencia y afirmé la viabilidad técnica del trabajo. Lo hice leyendo la documentación y chateando con un LLM. Sin embargo, perdí tiempo haciendo el trabajo antes de volver a rodar. Estoy moderadamente enojado con la documentación de Hugo por no mencionar claramente el comportamiento y el rendimiento golpeado en letras rojas audaces. Sin embargo, es una buena lección recordar comprobar tales cuestiones antes de gastar tanto tiempo, incluso en proyectos personales. Go further: 
 
 
 Cortometrajes de Hugo Funciones de Hugo Publicado originalmente en A Java Geek el 15 de febrero de 2026 El nuevo Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Este audio es producido en el idioma original de la historia!

He migrado mi blog de Jekyll a Hugo - o al menos, casi lo hice

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Valhalla de Floki se une como patrocinador asociado de la gira de la India por Sri Lanka

Nómadas digitales escuchen: lo que necesitan saber sobre la nueva visa DTV de Tailandia

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Valhalla de Floki se une como patrocinador asociado de la gira de la India por Sri Lanka

Nómadas digitales escuchen: lo que necesitan saber sobre la nueva visa DTV de Tailandia

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps