Die meisten meiner Blogbeiträge sind Lektionen, die ich gelernt habe.Ich versuche, etwas zu erreichen, und ich dokumentiere den Prozess, den ich verwendet habe, um es zu tun.Dies ist einer der wenigen, wo ich am Ende nicht das erreicht habe, was ich wollte.In diesem Beitrag möchte ich erklären, was ich gelernt habe, indem ich versuchte, von Jekyll nach Hugo zu migrieren, und warum ich am Ende nicht den letzten Schritt unternahm. Kontext Ich habe diesen Blog auf WordPress gestartet.Nach mehreren Jahren habe ich beschlossen, Ich war zufrieden mit Es basiert auf Ruby, und obwohl ich kein Ruby-Entwickler bin, konnte ich ein paar Plugins erstellen. Migration nach Jekyll Jekyll Ich beherberge die Codebase auf GitLab, mit GitLab CI, und ich habe Renovate konfiguriert, um einen PR zu erstellen, wenn ein Gem veraltet ist. Auf diese Weise bezahle ich jedes Mal technische Schulden, und ich sammle es nicht im Laufe der Jahre. Zwei . 3.4 4.0 Ich habe überprüft, ob Jekyll bereit war für Ruby 4. Es ist nicht, obwohl es eine Allerdings ist es nicht nur Jekyll: die verwendet Edelsteine, deren Versionen nicht mit Ruby 4 kompatibel sind. offene Frage Gemfile Schlimmer noch, ich überprüfte die allgemeine Gesundheit der Die letzten Engagements waren vor ein paar Wochen vom Continuous Integration-Bot. Ich dachte vielleicht, es sei an der Zeit, nach einer Alternative zu suchen. Projekt Jekyll Hugo Wie bei Jekyll, Es handelt sich um einen statischen Site Generator. Hugo 
 
 Hugo ist einer der beliebtesten Open-Source-Static-Site-Generatoren.Mit seiner erstaunlichen Geschwindigkeit und Flexibilität macht Hugo das Erstellen von Websites wieder Spaß. Hugo ist einer der beliebtesten Open-Source-Static-Site-Generatoren.Mit seiner erstaunlichen Geschwindigkeit und Flexibilität macht Hugo das Erstellen von Websites wieder Spaß. Im Gegensatz zu Jekyll baut Hugo auf Go. Es lobt sich als "wunderbar schnell". sieht viel mehr Aktivität als Jekyll. Obwohl ich kein Go-Fan bin, entschied ich, dass Hugo ein gutes Migrationsziel war. Codebasis Jekyll zu Hugo Die Migration von Jekyll nach Hugo folgt dem Pareto-Gesetz. Migration von Inhalten Hugo bietet folgende Hauptordner an: 
 
 
 
 
 Inhalt für Inhalte, die verarbeitet werden müssen statisch für Ressourcen, die so kopiert werden, wie sie Layouts für Tempel Daten für Datenquellen Überprüfen Sie die Für die Vollständigkeit. Vollständige Liste Jekyll unterscheidet zwischen und Die ersten haben ein Datum, die letzteren nicht. So sind Beiträge die Grundlage eines Blogs. Seiten sind stabil und strukturieren die Website. Hugo macht diesen Unterschied nicht. Posten Seiten Jekyll Ordner Strukturkarten wie: 
 
 
 
 
 
 
 
 
 
 
 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 Wenn Mapping nicht genug ist Jekyll Angebote Plugins kommen in mehreren Kategorien: 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 - Erstellen Sie zusätzliche Inhalte auf Ihrer Website Konverter - Ändern einer Markup-Sprache in ein anderes Format Befehle - Erweitern Sie die jekyll ausführbar mit subcommands Tags - Erstellen von benutzerdefinierten Liquid Tags Filter - Erstellen von benutzerdefinierten Flüssigkeitsfiltern Hooks - Feinkornsteuerung zur Verlängerung des Bauprozesses Bei Jekyll verwende ich Generatoren, Tags, Filter und Haken.Einige benutze ich durch bestehende Edelsteine, wie die Andere sind maßgeschneiderte für meine eigenen Bedürfnisse. Twitter Plugins Jekyll Tags übersetzen Für Hugo: Kurzkodex 
 
 
 Ein Shortcode ist eine Vorlage, die innerhalb der Markup angerufen wird und eine beliebige Anzahl von Argumenten akzeptiert. Sie können mit jedem Inhaltsformat verwendet werden, um Elemente wie Videos, Bilder und Social Media-Einbettungen in Ihren Inhalt einzufügen. Es gibt drei Arten von Shortcodes: Embedded, Custom und Inline. Ein Shortcode ist ein innerhalb der Markup angerufen, jede Anzahl von Sie können mit jedem Content-Format verwendet werden, um Elemente wie Videos, Bilder und Social Media-Einbettungen in Ihren Inhalt einzufügen. Tempel Argumente Es gibt drei Arten von Shortcodes: Embedded, Custom und Inline. Hugo bietet eine ganze Sammlung von Shortcodes außerhalb der Box, aber Sie können Ihre eigenen herausbringen. Leider haben Generatoren in Hugo kein Äquivalent. Ich habe Generatoren entwickelt, um Newsletter und Chat-Seiten zu erstellen. Das Generator-Plugin erzeugt nach meinen Daten automatisch eine Seite pro Jahr. Migration des GitLab Build Der Jekyll-Build besteht aus drei Schritten: 
 
 
 
 Erkennt, ob sich Gemfile.lock, Dockerfile oder .gitlab-ci.yml geändert hat, und erstellt das Docker-Image, wenn dies der Fall ist Verwenden Sie das Docker-Image, um die Website tatsächlich zu erstellen Implementieren der Website auf GitLab-Seiten Die größte Veränderung findet offenbar in der Hier die neue Hugo-Version zur Referenz: 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
 
 
 
 Pakete für Plantuml Gems für Asciidoctor-Diagramme und Syntax-Hervorhebung An diesem Punkt hätte ich etwas Fisch riechen sollen, aber es hat funktioniert, also ging ich weiter. Der Deal Breaker Ich migrierte mit Hilfe von Claude Code und Copilot CLI. Es dauerte mir ein paar Sitzungen, die über eine Woche verteilt wurden, hauptsächlich abends und am Wochenende. Während der Migration bat ich regelmäßig um Einzel-zu-Ein-Vergleich, um Regressionen zu vermeiden. Ich aktualisierte den Build, um dies zu tun, und ich löste einen Build aus: Der Jekyll Build dauerte etwas mehr als zwei Minuten, während der Hugo Build mehr als zehn Minuten dauerte! Ich analysierte die Protokolle, um das Problem besser zu verstehen.Außer ein paar Warnungen sah ich nichts, was erklärte, woher die Langsamkeit kam.                   │  EN  
──────────────────┼──────
 Pages            │ 2838 
 Paginator pages  │  253 
 Non-page files   │    5 
 Static files     │ 2817 
 Processed images │    0 
 Aliases          │  105 
 Cleaned          │    0 
Total in 562962 ms
 Als ich Claude Code fragte, wies er auf meine Verwendung von Asciidoc in meinen Beiträgen hin. ), es delegiert andere Formate als Markdown an eine externe Engine. Es stellt sich heraus, dass dieser Ansatz für ein paar Asciidoc-Dokumente gut funktioniert, nicht so viel für mehr als 800. Ich suchte und fand schnell heraus, dass ich nicht der erste bin, der diese Wand trifft: Spannung fünf Jahre. Andere Formate asciidoctor Dieser Thread Zu sagen, dass ich enttäuscht war, ist eine Unterstellung. Ich habe die Arbeit auf einem Zweig verlassen. Ich werde es wahrscheinlich in der Zukunft löschen, sobald ich abgekühlt habe. Schlussfolgerung Bevor ich an der Migration arbeitete, machte ich meine Sorgfalt und bestätigte die technische Machbarkeit der Arbeit. Ich tat dies, indem ich die Dokumentation las und mit einem LLM unterhielt. Dennoch verlor ich Zeit, die Arbeit zu tun, bevor ich zurückrollte. Ich bin mäßig wütend auf die Hugo-Dokumentation, weil sie das Verhalten und die Leistung nicht eindeutig in kühnen roten Buchstaben erwähnt hat. Go further: 
 
 
 Hugo Kurzkodex Hugo Funktionen Ursprünglich veröffentlicht in A Java Geek am 15. Februar 2026 Ein Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

Dieses Audio ist in der Originalsprache der Geschichte produziert!

Ich habe meinen Blog von Jekyll nach Hugo migriert - oder zumindest habe ich es fast getan

About Author

KOMMENTARE

Hängeetiketten

DIESER ARTIKEL WURDE VORGESTELLT IN

Related Stories

HackerNoon Decoded 2024: Celebrating Our AI Community!

HackerNoon Decoded 2024: Celebrating Our Startups Community!

HackerNoon Decoded 2024: Wir feiern unsere Remote-Work-Community!

HackerNoon Decoded 2024: Wir feiern unsere Gaming-Community!

HackerNoon Decoded 2024: Celebrating Our AI Community!

HackerNoon Decoded 2024: Celebrating Our Startups Community!

HackerNoon Decoded 2024: Wir feiern unsere Remote-Work-Community!

HackerNoon Decoded 2024: Wir feiern unsere Gaming-Community!

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps