静的サイトジェネレーター

どのようなものか

静的サイトジェネレーターは、ソースファイルのフォルダーを受け取り、
ファイルだけで構成された完成済みのウェブサイトを生成するビルドツール
です。ソースは通常、Markdownで書いたページと一式のテンプレートで、出
力はHTML、スタイルシート、スクリプト、画像になります。ウェブサーバー
は、それらをそのまま送信します。SSGと略されることも多く、「静的」と
いう言葉は、あるアドレスを要求する誰に対しても同じバイト列を返すとい
う配信方法を指します。ブラウザーに届いた後のページの振る舞いを指す言
葉ではありません。

対照的なのが、コンテンツ管理システムやウェブアプリで使う動的な方式で
す。こちらは要求があるたびに、通常はデータベースへ問い合わせてテンプ
レートに内容を埋め込み、サーバー上のプログラムがページを組み立てま
す。ジェネレーターも同種のコンテンツに同種のテンプレートを適用します
が、訪問のたびではなく変更のたびに一度だけ実行します。出力はフォル
ダーに残り、通常のウェブサーバー、ストレージバケット、コンテンツ配信
ネットワークは、そのページをどう作ったかを知らなくても配信できます。

Hugoは、そのようなジェネレーターの一つです。公式ドキュメントでは、
「Goで書かれ、高速動作に向けて最適化され、柔軟性を重視して設計された
静的サイトジェネレーター」であり、「サイト全体を数秒、多くの場合はそ
れより短い時間でレンダリングする」と紹介されています。通常は、組み込
みのウェブサーバーを動かしたまま執筆し、変更のたびに再ビルドして、開
いているブラウザーのページを再読み込みさせます。その後、サイトをビル
ドしてホストへデプロイします。

```sh
hugo server     # build, serve, rebuild and reload on every save
hugo --minify   # write the finished site into public/
```

なぜ重要なのか

この選択の中心にあるのは、処理をいつ行うかです。ジェネレーターは処理
をリクエスト時からビルド時へ移し、その後に生じる違いのほとんどは、こ
の移動に由来します。

ファイルの送信は、ウェブサーバーにとって最も負担の小さい処理の一つで
す。そのため、生成済みのサイトは素早く応答でき、ごく小さなマシンでも
動かせます。同じアドレスへ来る訪問者全員に同じバイト列を返すので、
キャッシュも単純です。ページの裏でアプリのコードやデータベースが動か
ない分、保護や更新が必要な対象も大幅に減ります。出力はフォルダーなの
で、別のホストへ移すにはファイルをコピーすれば済みます。ソースはバー
ジョン管理下にあり、どのページのどの変更もレビューし、追跡できます。

制約も同じ理由から生まれます。誤字を一つ直すだけでも、再ビルドとデプ
ロイが必要になるので、ページが増えるほどビルド速度が重要になります。
検索、コメント、ログイン、受け取った内容を保存するフォームなど、誰が
要求しているかに依存する機能には、ブラウザー内のコード、別のサービ
ス、またはビルド時に処理を済ませる方法が必要です。サーバー上には、そ
の処理をするプログラムがないためです。ビルドと次のビルドの間では、時
が止まります。Hugoは既定では未来の日付を持つページを含めないため、月
曜日に公開予定のページは、月曜日以降の最初のビルドで現れます。リダイ
レクトも形が変わります。HTTPリダイレクトを送るプログラムがないので、
Hugoは既定では、移動前のアドレスに小さなHTMLファイルを置いてブラウ
ザーを転送します。ドキュメントでは、どのホスティング事業者でも使える
方式と説明しています。

実際の活用例

このサイトも、この方式で構築しています。クレジットのページには、静的
サイトジェネレーターとしてHugoを挙げ、テンプレート、タクソノミー、す
べての言語、フィードを担うものとして記載しています。ブラウザーへ届く
HTMLは、要求される前にすべて書き出されています。各ページは、リクエス
トごとに組み立てるテンプレートではなく、ディスク上のファイルです。見
た目さえビルド時に決まります。ライトテーマの背景はサイトのビルド時に
ランダムに選ばれ、公開するたびにサイトの装いが新しくなります。品質
チェックは編集に使うコンピューター上でローカルに実行し、その工程には
外部のホスティング型ビルドサービスを使いません。すべての診断をエラー
として扱い、2026年10月には2,268ページをビルドしました。配信元はメモ
リー512
MBのシングルコアサーバーで、ウェブサーバーと、このサイトの要求に応答
するほかの三つのサービスは、同じファイルのフォルダーを読みます。その
ため、一度のデプロイで四つすべてを更新できます。

Hugoでこのサイトを構築した実績記事は、2026年8月の実装段階と、その判
断理由を記録しています。三つの言語で使え、別料金のアプリケーション
サービスを必要とせず、訪問者を第三者へ引き渡さないという条件により、
ほぼすべてのコンテンツ管理システムが候補から外れました。バックエンド
を稼働させるなら、その保護と更新を行い、運用費を負担し、プライバシー
のページでも説明しなければならないためです。当時のサイトには108個の
テンプレートファイルがあり、そのうち53個がパーシャルでした。一つのコ
ンテンツツリーから各ページを四つの表現形式で公開し、ジェネレーターへ
別のコンテンツディレクトリを指定して、同じツリーをさらに七回、分野別
サブドメイン用にビルドしていました。記事は、ブラウザーではなくビルド
時に機能を追加するというトレードオフも記録しています。記録されたポー
トフォリオのフィルター向けの限定的なJavaScriptの例外を除き、対話的な
機能はビルド時に実現するか、採用しないかのどちらかでした。そのため、
検索インデックスは負担を見積もったうえで、公開せず保留にしました。

問題が起きるところ

削除したページが公開されたままになる。
ソースから削除したページが以前のアドレスで配信され続け、検索エンジン
にも見つかり続けます。Hugoはビルド前に出力フォルダーを空にしません。
既存のファイルは上書きしますが、削除はしないため、`public/`には以前
のビルドのページが残ることがあり、下書きや公開期限切れのページも含ま
れます。そのフォルダーをサーバーへコピーする処理は、それらも一緒にコ
ピーします。`resources/`キャッシュにも、似た問題があります。このサイ
トの設計ルールでは、ソースCSSだけを変更した場合に、古いCSSバンドルが
使われることがあると注意しています。Hugoの`--cleanDestinationDir`フ
ラグか、独自の削除工程を使い、空のフォルダーへビルドします。このサイ
トでは、開始前に`public/`と`resources/`の両方を削除します。

完成したページがいつまでも現れない。
記事を書き、コミットしてデプロイし、ビルドは成功を報告したのに、サイ
トにはそのページがありません。Hugoは既定では、下書きの指定があるコン
テンツ、日付または公開日が未来のコンテンツ、有効期限が過ぎたコンテン
ツを除外し、いずれもエラーにはしません。日付を一日先に打ち間違えるだ
けで起こります。まず、その四つの項目を確認します。`--buildDrafts`、
`--buildFuture`、`--buildExpired`はプレビュー用にとどめ、公開予約し
たページには、その日付以降にビルドを実行するよう手配します。

全ページが一斉に変更されたと表示される。
サイトマップのほぼすべてのアドレスに同じ最終更新時刻が付きます。これ
ではクローラーにサイト全体が変わったと伝えるだけで、どのページが変
わったかは分かりません。ジェネレーターは各ページの更新日をどこかから
取得する必要がありますが、内容の変わらないファイルを別の工程が書き直
す場合、ファイル自体のタイムスタンプは適切な取得元ではありません。こ
のサイトの設定記録では、同期工程が毎回189個のコンテンツファイルすべ
てを書き直したため、サイトマップの176アドレスのうち172個に同じタイム
スタンプが付いていました。代わりに、バージョン管理から日付を取得しま
す。Hugoは`enableGitInfo`を有効にすると、そのファイルのGitでの最終リ
ビジョンの日付を読みます。同一のバイト列を生成する再同期ではコミット
が生じないため、一か月分の編集後に再同期した際には、186個のファイル
のうち変更対象は8個でした。

公開するつもりのないファイルまで公開される。
名前を推測した人なら誰でも、ほかのファイルの一覧が入ったファイルを取
得できてしまいます。ジェネレーターは、除外ルールに該当するもの以外、
読み込むフォルダー内のあらゆるものを公開します。ルールがすべてのフォ
ルダーに届かなければ、残りは露出します。このサイトの設定記録による
と、サイト全体の除外リストがモジュールのマウントに適用されず、macOS
のFinderがicons/、images/、webmanifest/の下に残した六つの`.DS_Store`
ファイルが、すべてのホストで公開されました。それぞれ同じディレクトリ
内の名前を列挙しており、images/内のものには、このサイトが公開しない
フォルダーの名前もありました。かつては、フィルターの`!`の後に空白が
一つ足りないだけで、逆にマウント内の画像がすべて除外されたこともあり
ます。公開を行う各マウントで除外を設定し、生成済みの出力に不要なファ
イルがないか確認します。このサイトでは、そのようなファイルを配信する
ビルドを、二つのチェックで失敗させます。

参考資料

  * Hugo: Introduction — Hugoの概要と用途、執筆、ビルド、デプロイと
いう作業の流れを説明しています。

  * Hugo: Basic usage —
サイトのビルドと配信、`public/`に古いファイルが残る理由、ビルドで除
外されるコンテンツを説明しています。

  * Hugo: Configure front matter —
`:git`と`:fileModTime`トークンを含め、Hugoがページの日付を選ぶ方法を
説明しています。

  * Hugo: Configure modules —
マウント、各マウントが受け取る`files`フィルター、マウントを定義する
と既定のマウントがなくなるというルールを説明しています。

  * Hugo: URL management —
エイリアスと、サーバーによるリダイレクトの代わりに静的ホストが配信す
る転送用ファイルを説明しています。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/ssg/	engineer.company	70
