このブログの構成 — Hugo と Congo を Hugo Modules で運用する

Tue, 25 Aug 2026 13:30:00 +0900

最初の記事は、このブログそのものの話にする。

何をどう選んで、いまどういう構成で動いているのか。とくに「テーマを Hugo Modules で入れる」という一点については、日本語の情報がまだ少ないわりに、後から助けられる場面が多いので、実際の設定ファイルをそのまま出しながら書く。

前半は選定の理由、後半は実装の中身という構成にした。

何を求めて個人サイトを持つのか #

個人サイトに求めるものは、突き詰めると 3 つしかなかった。

まず、書くことに集中できること。記事を 1 本書くたびに管理画面にログインして、エディタの挙動と格闘して、プレビューが本番と違う、みたいなことをやりたくない。書きたいのはテキストであって、それ以外の操作は少ないほどいい。

次に、長く持つこと。個人サイトは書いた瞬間より、5 年後に読み返せることのほうが価値がある。サービスが終了したら消える場所や、独自形式でデータが閉じ込められる場所には置きたくない。

あとは、運用に手がかからないこと。サーバの面倒は見たくないし、セキュリティパッチのために夜中に起きていたくもない。月額を払い続ける前提も避けたい。

この 3 つを並べると、選択肢はかなり絞られる。Markdown をファイルとして持って、静的な HTML を吐いて、それをどこかに置くだけ。要するに静的サイトジェネレータになる。

なぜ Hugo なのか #

静的サイトジェネレータはいくつもあるが、Hugo を選んだ理由は単純だった。

決め手は、単一バイナリで完結すること。Hugo は Go で書かれていて、実行に必要なのは hugo コマンドひとつだけだ。node_modules を作らないし、パッケージマネージャの都合でビルドが壊れることもない。実際このリポジトリには package.json すら存在しない。数年ぶりに触ったときに「まず依存を直す」という作業が発生しない構成は、個人サイトでは想像以上にありがたい。

ビルドが速いのも大きかった。手元でこのサイトを丸ごとビルドしても 1 秒かからず、プレビューサーバは変更を即座に反映する。書いている最中に待たされないというのは、書く量そのものに直結する。

そして、出力がただの HTML であること。生成物は静的ファイルの集まりなので、置き場所を選ばない。今は GitHub Pages に置いているが、気が変われば別のどこかに移せる。ロックインが弱いというのは、10 年単位で持つつもりなら大きい。

ひとつ前提がある。Hugo には通常版と extended 版があり、このサイトは extended 版が必須になっている。後述する Congo テーマが Sass のコンパイルを要求するためで、通常版の Hugo ではビルドが通らない。Homebrew で入る hugo は extended 版なので普段は意識しないが、CI では明示的に extended のバイナリを取りに行っている。

静的サイト on tocky.net

このブログの構成 — Hugo と Congo を Hugo Modules で運用する

何を求めて個人サイトを持つのか #

なぜ Hugo なのか #