HUGO
Menu
GitHub 87548 stars Mastodon

Data

为每种页面类型返回唯一的数据对象。

Syntax

PAGE.Data

Returns

page.Data

Page 对象上的 Data 方法为每种 页面类型 返回唯一的数据对象。

Data 方法仅在 分类法术语 模板中有用。

未积极维护的主题可能仍在其模板中使用 .Data.Pages。虽然该语法仍然有效,但请改用以下方法之一:PagesRegularPagesRegularPagesRecursive

以下示例基于此站点配置:

taxonomies:
  author: authors
  genre: genres
[taxonomies]
  author = 'authors'
  genre = 'genres'
{
   "taxonomies": {
      "author": "authors",
      "genre": "genres"
   }
}

以及此内容结构:

content/
├── books/
│   ├── and-then-there-were-none.md --> genres: suspense
│   ├── death-on-the-nile.md        --> genres: suspense
│   └── jamaica-inn.md              --> genres: suspense, romance
│   └── pride-and-prejudice.md      --> genres: romance
└── _index.md

在分类法模板中

分类法 模板中的 Data 对象上使用这些方法。

Singular
(string) 返回分类法的单数名称。
{{ .Data.Singular }} → genre
Plural
(string) 返回分类法的复数名称。
{{ .Data.Plural }} → genres
Terms
(page.Taxonomy) 返回 Taxonomy 对象,由术语映射和与每个术语关联的 加权页面 组成。
{{ $taxonomyObject := .Data.Terms }}

获取 Taxonomy 对象后,使用任何 分类法方法 来排序、计数或捕获其加权页面的子集。

了解有关 分类法模板 的更多信息。

在术语模板中

术语 模板中的 Data 对象上使用这些方法。

Singular
(string) 返回分类法的单数名称。
{{ .Data.Singular }} → genre
Plural
(string) 返回分类法的复数名称。
{{ .Data.Plural }} → genres
Term
(string) 返回术语的名称。
{{ .Data.Term }} → suspense

了解有关 术语模板 的更多信息。


Last updated: January 1, 0001
Improve this page