De meeste van mijn blogberichten zijn lessen die ik heb geleerd.Ik probeer iets te bereiken en ik documenter het proces dat ik gebruikte om het te doen.Dit is een van de weinige waar ik uiteindelijk niet heb bereikt wat ik wilde.In dit bericht wil ik uitleggen wat ik heb geleerd van het proberen te migreren van Jekyll naar Hugo, en waarom ik uiteindelijk de laatste stap niet heb gezet. context Ik startte deze blog op WordPress. Na een paar jaar besloot ik om Ik ben blij geweest met Het is gebaseerd op Ruby, en hoewel ik geen Ruby-ontwikkelaar ben, kon ik een paar plugins maken. Migreren naar Jekyll Jekyll Ik hosting de codebase op GitLab, met GitLab CI, en ik heb Renovate geconfigureerd om een PR te maken wanneer een Gem verouderd is. Twee . 3.4 4.0 Ik heb gecontroleerd of Jekyll klaar was voor Ruby 4. Het is echter niet alleen Jekyll: de gebruikt edelstenen waarvan de versies niet compatibel zijn met Ruby 4. Open kwestie Gemfile Erger nog, ik controleerde de algehele gezondheid van de De laatste commits waren een paar weken geleden van de Continuous Integration bot. ik dacht misschien dat het tijd was om een alternatief te zoeken. Het Jekyll project HUGO Net als Jekyll, Het is een statische site generator. HUGO 
 
 Hugo is een van de meest populaire open source statische site generatoren.Met zijn verbazingwekkende snelheid en flexibiliteit, maakt Hugo het bouwen van websites weer leuk. Hugo is een van de meest populaire open source statische site generatoren.Met zijn verbazingwekkende snelheid en flexibiliteit, maakt Hugo het bouwen van websites weer leuk. In tegenstelling tot Jekyll bouwt Hugo op Go. Het roept zichzelf op als "verrassend snel". Hij ziet veel meer activiteit dan Jekyll.Hoewel ik geen Go-fan ben, besloot ik dat Hugo een goed migratiedoel was. Codebase Jekyll naar Hugo De migratie van Jekyll naar Hugo volgt de wet van Pareto. Migrerende inhoud Hugo biedt de volgende hoofdmappen: 
 
 
 
 
 Content voor inhoud die moet worden verwerkt statisch voor bronnen die worden gekopieerd zoals Layouts voor templates Gegevens voor gegevensbronnen Check de Voor de volledigheid. Volledige lijst Jekyll onderscheidt en De eerste hebben een datum, de laatste niet. dus, berichten zijn de basis van een blog. pagina's zijn stabiel en de structuur van de site. Posts pagina’s Jekyll maps structuur kaarten als: 
 
 
 
 
 
 
 
 
 
 
 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 Wanneer mappen niet genoeg is Jekyll biedt Plugins komen in verschillende categorieën: 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 
 
 
 
 
 
 
 Generatoren - Creëer extra inhoud op uw site Converters - Verander een markuptaal naar een ander formaat Commando's - Uitbreiden van de jekyll-uitvoerbaar met subcommandes Tags - Creëer aangepaste Liquid tags Filters - Maak aangepaste vloeibare filters Hooks - Fine-grained controle om het bouwproces uit te breiden Op Jekyll gebruik ik generatoren, tags, filters en hooks. Anderen zijn op maat ontwikkeld voor mijn eigen behoeften. Twitter Plugins Jekyll tags vertaling naar In de Hugo: Shortcodes 
 
 
 Een shortcode is een sjabloon die wordt aangehaald binnen de markering, waarbij een aantal argumenten wordt geaccepteerd. Ze kunnen worden gebruikt met elk inhoudsformaat om elementen zoals video's, afbeeldingen en sociale media in uw inhoud in te voegen. Er zijn drie soorten shortcodes: embedded, custom en inline. Een shortcode is een binnen de markup, het accepteren van een aantal Ze kunnen worden gebruikt met elk inhoudsformaat om elementen zoals video's, afbeeldingen en social media-embeddings in uw inhoud in te voegen. tempel Argumenten Er zijn drie soorten shortcodes: embedded, custom en inline. Hugo biedt een hele verzameling shortcodes uit de doos, maar je kunt je eigen uitrollen. Helaas hebben generatoren geen equivalent in Hugo.Ik heb generatoren ontwikkeld om nieuwsbrieven en chatpagina's te maken.De generator-plugin genereert automatisch een pagina per jaar volgens mijn gegevens. Migratie van de GitLab Build De Jekyll build bestaat uit drie stappen: 
 
 
 
 Detecteert of een van de Gemfile.lock, Dockerfile of .gitlab-ci.yml is gewijzigd en bouwt de Docker-afbeelding als dat het geval is Gebruik de Docker-afbeelding om de site daadwerkelijk te bouwen De site inzetten op GitLab Pages De belangrijkste verandering vindt duidelijk plaats in de Hier is de nieuwe Hugo-versie voor referentie: 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
 
 
 
 Pakketten voor Plantuml Juwelen voor Asciidoctor diagrammen en syntax highlighting Op dit moment had ik iets visachtigs moeten ruiken, maar het werkte, dus ging ik door. De deal breaker Ik migreerde met de hulp van Claude Code en Copilot CLI. Het kostte me een paar sessies, verspreid over een week, meestal in de avonduren en in het weekend. Tijdens de migratie vroeg ik regelmatig om een-op-één vergelijkingen om regressie te voorkomen. Mijn idee was om de sites Jekyll en Hugo naast elkaar te bouwen, ze beide op GitLab Pages te implementeren en beide versies te vergelijken voor de uiteindelijke gaten. Ik heb de build bijgewerkt om dat te doen, en ik triggerde een build: de Jekyll build duurde iets meer dan twee minuten, terwijl de Hugo build meer dan tien duurde! Ik analyseerde de logs om het probleem beter te begrijpen.Naast een paar waarschuwingen zag ik niets dat verklaarde waar de traagheid vandaan kwam.                   │  EN  
──────────────────┼──────
 Pages            │ 2838 
 Paginator pages  │  253 
 Non-page files   │    5 
 Static files     │ 2817 
 Processed images │    0 
 Aliases          │  105 
 Cleaned          │    0 
Total in 562962 ms
 Toen ik Claude Code vroeg, wees het op mijn gebruik van Asciidoc in mijn berichten. ), delegeren andere formaten dan Markdown aan een externe engine. Het blijkt dat deze aanpak goed werkt voor een paar Asciidoc-documenten, niet zozeer voor meer dan 800. 5 jaar Spaans. Andere formaten asciidoctor Deze thread Zeggen dat ik teleurgesteld was is een onderschatting. ik heb het werk op een tak gelaten. ik zal het waarschijnlijk in de toekomst verwijderen, zodra ik heb afgekoeld. Conclusie Voordat ik aan de migratie werkte, deed ik mijn due diligence en bevestigde ik de technische haalbaarheid van het werk. Ik deed dat door de documentatie te lezen en te chatten met een LLM. Toch heb ik tijd verspild met het doen van het werk alvorens terug te rollen. Ik ben matig boos op de Hugo-documentatie voor het niet duidelijk vermelden van het gedrag en de prestaties getroffen in gedurfde rode letters. Go further: 
 
 
 Hugo korte codes Functies van Hugo Oorspronkelijk gepubliceerd op A Java Geek op 15 februari, 2026 Een Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Deze audio wordt geproduceerd in de originele taal van het verhaal!

Ik migreerde mijn blog van Jekyll naar Hugo - of tenminste, ik bijna

About Author

OPMERKINGEN

LABELS

DIT ARTIKEL WERD GEPRESENTEERD IN

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps