Hugoのディレクトリ構造

1. 新しいサイトの作成

hugo new site my-website

2. サイトのディレクトリ構造

% tree my-website
my-website
├── archetypes
│   └── default.md
├── assets
├── content
├── data
├── hugo.toml
├── i18n
├── layouts
├── static
└── themes

9 directories, 2 files

主要ディレクトリ

  • archetypes/ - 新しいコンテンツファイルのテンプレート

    • default.md - hugo new コマンドで作成される記事の基本テンプレート

  • assets/ - Sassファイルや処理が必要なファイル（Hugo Pipesで処理される）

  • content/ - サイトのすべてのコンテンツ（マークダウン記事など）が格納される場所

  • data/ - 設定ファイルやデータファイル（YAML、JSON、TOMLなど）を格納

  • hugo.toml - サイトの主要設定ファイル（hugo.yaml, hugo.jsonも可）

  • i18n/ - 多言語化（国際化）のための翻訳ファイルを格納

  • layouts/ - HTMLテンプレート（サイトのデザインとレイアウト）を格納

  • static/ - 処理なしでそのまま公開ディレクトリにコピーされるファイル（画像、CSS、JSなど）

  • themes/ - テーマを格納するディレクトリ（テーマを使用する場合）

サイト構築時、Hugoはこれらのディレクトリからコンテンツを読み取り、静的HTMLサイトを生成します（通常はpublic/ディレクトリに出力）。