私のブログの投稿のほとんどは学んだ教訓です 私は何かを達成しようとしています、そして私はそれを行うために使われていたプロセスをドキュメンタリーにします. これは、結局、私は私が望んだものを達成しなかった数少ない場所の1つです. この投稿では、私はJekyllからHugoへの移行を試みて何を学んだのかを説明することを目指しています。 文脈 私はWordPressでこのブログを始めました.数年後、私は I have been happy with それはRubyに基づいており、私はRubyの開発者ではありませんが、いくつかのプラグインを作成することができました。 Jekyll への移住 ジェキル 私はGitLabでコードベースをホストし、GitLab CIを使用して、ジェムが時代遅れになったときにPRを作成するようにRenovateを設定しました。 2位 . 3.4 4.0 私はJekyllがRuby 4の準備ができているかどうかを確認しました。 しかし、それはJekyllだけではない: The Ruby 4 と互換性がないバージョンの宝石を使用します。 オープンテーマ Gemfile 最悪なことに、私は一般的な健康状態をチェックしました。 最後のコミットは Continuous Integration ボットから数週間前にありました. 私は、もしかしたら代替案を探す時が来たのかもしれません。 Jekyllプロジェクト HUGO Jekyllのように、 静的サイトジェネレーターです。 HUGO 
 
 Hugoは、最も人気のあるオープンソースの静的サイトジェネレーターの1つです。その驚くべき速度と柔軟性で、Hugoはウェブサイトの作成を再び楽しませます。 Hugoは、最も人気のあるオープンソースの静的サイトジェネレーターの1つです。その驚くべき速度と柔軟性で、Hugoはウェブサイトの作成を再び楽しませます。 Jekyll とは異なり、Hugo は Go に基づいています. It touts itself as "amazingly fast". Icing on the cake, the ジェキルよりはるかにアクティビティを見ているが、私はゴーファンではないが、ヒューゴは良い移住ターゲットだと決めた。 コードベース Jekyll to HUGO ジェキルからヒューゴへの移行は、パレトの法則に従う。 コンテンツ移住 Hugoは以下の主要フォルダーを提供しています。 
 
 
 
 
 処理する必要のあるコンテンツのためのコンテンツ static for resources that are copied as is コピーされたリソース Layouts for Templates タイトル データソースのデータ CHECK THE 完全性のために。 完全リスト Jekyll 区別 そして 前者は日付を持っており、後者はそうでない。したがって、投稿はブログの基礎である。ページは安定し、サイトを構成している。 ポスト ページ Jekyll フォルダーは、構造マップを以下のように構成します。 
 
 
 
 
 
 
 
 
 
 
 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 マッピングが足りないとき Jekyll オファー プラグインは、いくつかのカテゴリにあります: Plugins come in several categories: プラグイン 
 
 
 
 
 
 
 
 
 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 
 
 
 
 
 
 
 Generators - あなたのサイトで追加コンテンツを作成する Converters - マークアップ言語を別の形式に変更する コマンド - Extend the jekyll executable with subcommand タグ - Create custom Liquid tags Filters - Create Custom Liquid Filters (カスタマイズされた液体フィルターの作成) Hooks - Fine-grained control to extend the building process (ハック) Jekyll では、ジェネレーター、タグ、フィルター、ハックを使用します。 他のものは、私自身のニーズのためにカスタム開発されています。 ツイッタープラグイン Jekyll tags 翻訳 HUGOについて: ショートコード 
 
 
 ショートコードは、マークアップ内で呼び出されるテンプレートで、いかなる数でも議論を受け入れられます. They can be used with any content format to insert elements such as videos, images, and social media embeds into your content. ショートコードは、コンテンツ形式で、ビデオ、画像、ソーシャルメディアの組み込みなどの要素をコンテンツに挿入するために使用できます。 3種類のショートコードがあります: embedded, custom, and inline. ショートコードはA マークアップ内で呼び出され、何らかの数を受け入れること 彼らは、ビデオ、画像、ソーシャルメディアの埋め込みなどの要素をあなたのコンテンツに挿入するために、あらゆるコンテンツフォーマットで使用することができます。 神殿 論点 3種類のショートコードがあります: embedded, custom, and inline. Hugoは、箱外のショートコードの非常に多くのコレクションを提供していますが、独自のコードをリリースすることができます。 残念ながら、ジェネレーターはHugoで何の類似もありません。私はニュースレターや会話ページを作成するためのジェネレーターを開発しました。 ジェネレータープラグインは私のデータに基づいて毎年自動的に1ページを生成します。 GitLab Buildの移行 Jekyll ビルドは、3つのステップで構成されています。 
 
 
 
 Gemfile.lock、Dockerfile、または .gitlab-ci.yml が変更されたかどうかを検出し、その場合は Docker イメージを構築します。 実際にサイトを構築するためにDockerイメージを使用する GitLab Pagesにサイトをデプロイする 主な変化は明らかに、 以下は、参考のための新しいHUGO版です。 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
 
 
 
 PlantUMLのパッケージ Asciidoctor Diagrams and Syntax Highlighting のための宝石 この時点で、私は魚の匂いを嗅ぐべきだったが、それは働いたので、私は続けた。 THE DEAL BREAKER クロード・コードとコピロット・CLIの助けを借りて移行しました. ほとんどが夕方や週末に、一週間をかけて、いくつかのセッションをかけて移行しました. 移行中に、私は回帰を避けるために一対一の比較を定期的に要請しました. 私のアイデアは、ジェキルとヒューゴのサイトを並んで構築し、両方をGitLab Pagesに展開し、両方のデプロイされたバージョンを最終的なギャップのために比較することでした. 私はそれを実行するためにビルドを更新し、ビルドを起動しました:Jekyllビルドは2分以上かかり、Hugoビルドは10分以上かかりました! 私はそれを信じることができなかったので、再びビルドを起動しました。 私は問題をよりよく理解するためにログを分析しました.いくつかの警告のほかに、遅さがどこから来たのかを説明するものはありませんでした。                   │  EN  
──────────────────┼──────
 Pages            │ 2838 
 Paginator pages  │  253 
 Non-page files   │    5 
 Static files     │ 2817 
 Processed images │    0 
 Aliases          │  105 
 Cleaned          │    0 
Total in 562962 ms
 クロード・コードに尋ねたとき、彼は私の投稿でAsciidocの私の使用を指摘しました。 ), it delegates formats other than Markdown to an external engine. For Asciidoc, it is このアプローチがいくつかのAsciidocドキュメントでうまく機能していることが判明し、800以上のドキュメントではそれほど多くありませんでした。 スペース5年。 他の形式 asciidoctor このトレード 僕が失望したと言うことは、過小評価だ. 僕は仕事を支店に残した. 僕はきっと将来、冷やしたらそれを削除するだろう。 結論 移行に取り組む前に、私は義務を尽くし、作業の技術的実行可能性を主張しました。私は文書を読み、LLMとチャットすることによってそれをしました。しかし、私は戻る前に仕事をするために時間を無駄にしました。 Go further: 
 
 
 HUGO ショートコード HUGOの機能 オリジナルの投稿 A Java Geek on February 15, 2026 ・Java Geek

Read all my posts!

Read My Stories

Follow @nicolas_frankel on Twitter

このオーディオは、ストーリーの元の言語で制作されています。

I Migrated My Blog From Jekyll to Hugo - Or At least, I Almost Did

About Author

コメント

ラベル

この記事は

Related Stories

State of the Noonion: Green Clock Strikes Noon

State of the Noonion: A New Era For Brands and Writers

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

18 種類の開発者ツールで生産性を向上しましょう 🚀🔥

State of the Noonion: Green Clock Strikes Noon

State of the Noonion: A New Era For Brands and Writers

HackerNoon Coded: HackerNoonが最も活発に活動している上位10カ国

18 種類の開発者ツールで生産性を向上しましょう 🚀🔥

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps