ページバンドル

ページバンドルは、ページリソース をグループ化するための方法です。

ページバンドルは、以下のいずれかになります。

• リーフバンドル (「リーフ」は、子がないことを意味します)
• ブランチバンドル (ホームページ、セクション、タクソノミー用語、タクソノミーリスト)

リーフバンドル

リーフバンドル とは、content/ ディレクトリ内の任意の階層にある、index.md ファイルを含むディレクトリのことを指します。

リーフバンドル構成の例

content/
├── about
│   ├── index.md
├── posts
│   ├── my-post
│   │   ├── content1.md
│   │   ├── content2.md
│   │   ├── image1.jpg
│   │   ├── image2.png
│   │   └── index.md
│   └── my-other-post
│       └── index.md
│
└── another-section
    ├── ..
    └── not-a-leaf-bundle
        ├── ..
        └── another-leaf-bundle
            └── index.md

上記の例の content/ ディレクトリには、以下の 4 つのリーフバンドルがあります。

about

このリーフバンドルはルートレベル (content ディレクトリの直下) にあり、index.md のみを持ちます。

my-post

このリーフバンドルには、index.md と他の2つのコンテンツの Markdown ファイル、そして2つの画像ファイルが含まれています。

• image1, image2: これらの画像は my-post のページリソースであり、 my-post/index.md リソースでのみ利用可能です。

• content1, content2: これらのコンテンツファイルは my-post のページリソースであり、 my-post/index.md リソースでのみ利用可能です。 これらのコンテンツファイルは、個別のページとしてレンダリングされることは ありません 。

my-other-post

このリーフバンドルには index.md のみが含まれています。

another-leaf-bundle

このリーフバンドルは、いくつかのディレクトリの下にネストされています。このバンドルには index.md のみが含まれています。

ヘッドレス バンドル

ヘッドレス バンドルとは、以下のような、どこにも公開されないように設定されたバンドルのことです。

• Permalink を持たず、public/ にレンダリングされた HTML を持ちません。
• .Site.RegularPages などの一部にはなりません。

しかし、.Site.GetPage で取得することができます。以下はその例です。

{{ $headless := .Site.GetPage "/some-headless-bundle" }}
{{ $reusablePages := $headless.Resources.Match "author*" }}
<h2>Authors</h2>
{{ range $reusablePages }}
    <h3>{{ .Title }}</h3>
    {{ .Content }}
{{ end }}

この例では、some-headless-bundle は、.Name が "author* に一致する 1 つ以上の ページ リソースを含むヘッドレス バンドルであると想定しています。

上記の例の説明::

1. some-headless-bundle ページの “object” を取得します。
2. この ページバンドル に含まれるリソースのうち、 .Resources.Match を使って "author*" にマッチするものを スライス として収集します。
3. ネストされたページの スライス をループして、その .Title と .Content を出力します。

リーフバンドルは、フロントマター (index.md 内) に以下を追加することでヘッドレス バンドルにすることができます。

---
headless: true
---

+++
headless = true
+++

{
   "headless": true
}

このようなヘッドレス ページバンドルには、さまざまな使用例があります。

• メディアギャラリーの共有
• 再利用可能なページコンテンツ “スニペット”

ブランチバンドル

ブランチバンドル とは、content/ ディレクトリ内の任意の階層にある、少なくとも _index.md ファイルを含むディレクトリのことを指します。

この _index.md は、 content/ ディレクトリの直下に置くこともできます。

ブランチバンドル構成の例

content/
├── branch-bundle-1
│   ├── branch-content1.md
│   ├── branch-content2.md
│   ├── image1.jpg
│   ├── image2.png
│   └── _index.md
└── branch-bundle-2
    ├── _index.md
    └── a-leaf-bundle
        └── index.md

上記の例の content/ ディレクトリには、2つのブランチバンドル(とリーフバンドル)があります。

branch-bundle-1

このブランチバンドルには、_index.md、その他 2つのコンテンツの Markdown ファイル、2つの画像ファイルが含まれています。

branch-bundle-2

このブランチバンドルは _index.md とネストしたリーフバンドルが含まれています。