ページバンドルとは？

ページバンドルは、コンテンツ (.md, .html など) と、それに関連するリソース (画像、PDF、他のMarkdownファイルなど) を含むディレクトリのことです。バンドル内のリソースは「ページリソース」と呼ばれ、ページの .Resources メソッドでアクセスできます。

例:

content/
├── about/          # ← これはページバンドル (Leaf Bundle)
│   ├── index.md    # コンテンツファイル
│   └── welcome.jpg # 関連リソース
└── privacy.md      # ← これは通常のページ

リーフバンドル vs ブランチバンドル

ページバンドルは、その役割と構造によって2つのタイプに分けられます。

注意: インデックスファイルの拡張子 (.md, .html, .adoc 等) は、使用するコンテントフォーマットによって決まります。

リーフバンドル (Leaf Bundle) の詳細

リーフバンドルは、index.md ファイルを含むディレクトリです。物理的な葉のように、ブランチの末端に位置し、子孫を持つことはできません。主に個別のコンテンツページとそのリソースを管理するために使用されます。

content/
├── posts/
│   └── my-post/        # ← リーフバンドル
│       ├── index.md      # このバンドルのメインコンテンツ
│       ├── content-1.md  # ページリソース (page type)
│       ├── content-2.md  # ページリソース (page type)
│       ├── image-1.jpg   # ページリソース (image type)
│       └── image-2.png   # ページリソース (image type)
└── about/            # ← リソースなしのリーフバンドル
    └── index.md

ブランチバンドル (Branch Bundle) の詳細

ブランチバンドルは、_index.md ファイルを含むディレクトリです。物理的な枝のように、他のリーフバンドルやブランチバンドルを子孫として持つことができます。セクションのトップページやホームページなど、リストページのコンテンツとリソースを管理するために使用されます。トップレベルディレクトリ（例：content/posts/）も、_index.md がなくてもブランチバンドルとして扱われます。

content/
├── blog/               # ← ブランチバンドル
│   ├── _index.md       # セクションのトップページコンテンツ
│   ├── banner.jpg      # ページリソース (image type)
│   ├── introduction.md # 通常のコンテンツページとしてレンダリングされる
│   └── post-1/         # ← 子孫のリーフバンドル
│       └── index.md
└── _index.md           # ← ホームページのブランチバンドル

ヘッドレスバンドル (Headless Bundles)

フロントマターで headless: true を設定することで、公開されない（＝単独のURLを持たない）バンドルを作成できます。ヘッドレスバンドルのコンテンツやリソースは、他の通常ページから .Site.GetPage などを使って参照・利用するために使われます。

---
title: "共有リソース"
headless: true # これでヘッドレスバンドルになる
---
このバンドルは直接公開されませんが、中のリソースは他から使えます。