页面Bundle

Page Bundles - 页面Bundle

https://gohugo.io/content-management/page-bundles/

​ 使用页面 Bundle 进行内容组织

​ 页面 Bundle 是一种分组页面资源的方式。

​ 页面 Bundle 可以是以下之一：

• 叶子Bundle (叶子表示它没有子级)
• 分支Bundle (home page，section，taxonomy terms，taxonomy list)

叶子Bundles

​ 叶子 Bundle 是 content/ 目录中任何层次结构中包含 index.md 文件的目录。

叶子 Bundle 组织示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

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

In the above example content/ directory, there are four leaf bundles:

​ 在上面的示例中，content/ 目录中有四个叶子 Bundle：

• about

  这个叶子 Bundle 在根级别（直接在 content 目录下）并且只有 index.md。

• my-post

  这个叶子 Bundle 有 index.md、另外两个内容 Markdown 文件和两个图像文件。

  image1, image2：这些图像是 my-post 的页面资源，仅在 my-post/index.md 资源中可用。

  content1, content2: These content files are page resources of my-post and only available in my-post/index.md resources. They will not be rendered as individual pages. 这些内容文件是 my-post 的页面资源，仅在 my-post/index.md 资源中可用。它们不会被渲染为单独的页面。

• my-other-post

  这个叶子 Bundle 只有 index.md。

• another-leaf-bundle

  这个叶子 Bundle 被嵌套在几个目录下。此 Bundle 也只有 index.md。

​ 创建叶子 Bundle 的层次深度不重要，只要它不在另一个叶子 Bundle 中即可。

Headless Bundle

​ 无头Bundle是一种配置为不在任何地方发布的Bundle：

• 它将没有永久链接（Permalink）和public/中的渲染HTML。
• 它不会成为.Site.RegularPages等的一部分。

​ 但是，您可以通过.Site.GetPage获取它。以下是一个示例：

1
2
3
4
5
6
7

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

​ 在此示例中，我们假设some-headless-bundle是一个包含一个或多个页面资源的无头Bundle，其.Name与"author*"匹配。

​ 上面示例的说明：

1. 获取some-headless-bundle页面"object"。
2. 使用.Resources.Match收集此页面Bundle中与"author*"匹配的资源片段。
3. 循环遍历嵌套页面的切片，并输出它们的.Title和.Content。

​ 通过在index.md的前置元数据中添加以下内容，可以将一个叶子Bundle变为无头Bundle：

content/headless/index.md

=== “yaml”

```yaml
---
headless: true
---
```

=== “toml”

```toml
+++
headless = true
+++
```

=== “json”

```json
{
   "headless": true
}
```

​ 此类无头页面Bundle有许多用例：

• 共享媒体库
• 可重复使用的页面内容"snippets（片段）"

分支Bundle

​ 分支Bundle是位于content/目录中任何层次结构中的任何目录，其中至少包含一个_index.md文件。

​ 这个_index.md也可以直接在content/目录下。

​ 这里以md（markdown）仅作为示例。只要它是Hugo可识别的内容类型，您可以使用任何文件类型作为内容资源。

分支Bundle组织示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

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/目录示例中，有两个分支Bundle（和一个叶子Bundle）：

• branch-bundle-1

  该分支Bundle有_index.md，另外两个内容Markdown文件和两个图像文件。

• branch-bundle-2

  该分支Bundle有_index.md和一个嵌套的叶子Bundle。

​ 创建分支Bundle的层次深度不重要。

1. .md扩展名仅作为示例。扩展名可以是.html，.json或任何有效的MIME类型。 ↩︎ ↩︎

另请参阅

• 内容组织
• 页面资源
• 单页模板