Taxonomy 方法 on Hugo 中文文档

Alphabetical

Fri, 02 Oct 2026 00:00:00 +0800

Taxonomy 对象上的 Alphabetical 方法返回一个 ordered taxonomy（有序分类法），按 term（术语）的字母序排序。

Taxonomy 对象是 map（映射），而有序分类法是一个 slice（切片），其中每个元素都是一个对象，包含术语以及该术语的 weighted pages（加权页面）切片。

在使用 Taxonomy 方法之前，需要先取得一个 Taxonomy 对象。

取得 Taxonomy 对象

考虑如下项目配置：

ByCount

Fri, 02 Oct 2026 00:00:00 +0800

Taxonomy 对象上的 ByCount 方法返回一个 ordered taxonomy（有序分类法），按各 term（术语）所关联的页面数量排序；数量相同时再按术语的字母序排序。

Taxonomy 对象是 map（映射），而有序分类法是一个 slice（切片），其中每个元素都是一个对象，包含术语以及该术语的 weighted pages（加权页面）切片。

在使用 Taxonomy 方法之前，需要先取得一个 Taxonomy 对象。

取得 Taxonomy 对象

考虑如下项目配置：

Count

Fri, 02 Oct 2026 00:00:00 +0800

Taxonomy 对象上的 Count 方法返回给定 term（术语）所关联的 weighted pages（加权页面）数量。

在使用 Taxonomy 方法之前，需要先取得一个 Taxonomy 对象。

取得 Taxonomy 对象

考虑如下项目配置：

[taxonomies]
genre = 'genres'
author = 'authors'

内容结构如下：

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 方法。

Get

Fri, 02 Oct 2026 00:00:00 +0800

Taxonomy 对象上的 Get 方法返回给定 term（术语）所关联的 weighted pages（加权页面）切片。

在使用 Taxonomy 方法之前，需要先取得一个 Taxonomy 对象。

取得 Taxonomy 对象

考虑如下项目配置：

[taxonomies]
genre = 'genres'
author = 'authors'

内容结构如下：

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 方法。

Page

Fri, 02 Oct 2026 00:00:00 +0800

如果分类法没有任何术语，这个 TAXONOMY 方法会返回 nil，因此必须做防御式编码：

{{ with .Site.Taxonomies.tags.Page }}
  <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
{{ end }}

渲染结果为：

<a href="/tags/">Tags</a>