获取
Syntax
TAXONOMY.Get TERM
Returns
page.WeightedPages
Taxonomy 对象上的 Get 方法返回一个切片，其中包含已分配给给定 术语 的 加权页面 。
在使用 Taxonomy 方法之前，我们需要捕获一个 Taxonomy 对象。
捕获 Taxonomy 对象
考虑以下站点配置：
hugo.
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
要在任何模板中捕获“genres” Taxonomy 对象，请在 Site 对象上使用 Taxonomies 方法。
{{ $taxonomyObject := .Site.Taxonomies.genres }}
在使用分类模板呈现其页面时，要捕获“genres” Taxonomy 对象，请在页面的 Data 对象上使用 Terms 方法：
layouts/_default/taxonomy.html
{{ $taxonomyObject := .Data.Terms }}要检查数据结构：
<pre>{{ debug.Dump $taxonomyObject }}</pre>
尽管 Alphabetical 和 ByCount 方法提供了更好的数据结构来遍历分类，但您可以直接从 Taxonomy 对象呈现按术语加权的页面：
{{ range $term, $weightedPages := $taxonomyObject }}
<h2><a href="{{ .Page.RelPermalink }}">{{ .Page.LinkTitle }}</a></h2>
<ul>
{{ range $weightedPages }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}
在上面的示例中，第一个锚元素是到术语页面的链接。
获取加权页面
现在我们已经捕获了 “genres” Taxonomy 对象，让我们获取已分配给 “suspense” 术语的加权页面：
{{ $weightedPages := $taxonomyObject.Get "suspense" }}
以上等同于：
{{ $weightedPages := $taxonomyObject.suspense }}
但是，如果该术语不是有效的 标识符 ，则不能使用 链式 语法。例如，这将抛出错误，因为标识符包含连字符：
{{ $weightedPages := $taxonomyObject.my-genre }}
您也可以使用 index 函数，但语法更冗长：
{{ $weightedPages := index $taxonomyObject "my-genre" }}
要检查数据结构：
<pre>{{ debug.Dump $weightedPages }}</pre>
示例
使用此模板：
{{ $weightedPages := $taxonomyObject.Get "suspense" }}
{{ range $weightedPages }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
Hugo 渲染结果：
<h2><a href="/books/jamaica-inn/">Jamaica inn</a></h2>
<h2><a href="/books/death-on-the-nile/">Death on the nile</a></h2>
<h2><a href="/books/and-then-there-were-none/">And then there were none</a></h2>