Pages 方法 on Hugo 中文文档

ByDate

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

按日期排序时，取值由项目配置决定，默认使用前置元数据中的 date 字段。

{{ range .Pages.ByDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByExpiryDate

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

按过期日期排序时，取值由项目配置决定，默认使用前置元数据中的 expiryDate 字段。

{{ range .Pages.ByExpiryDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByExpiryDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByLanguage

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

按语言排序时，Hugo 使用以下优先级对页面集合排序：

语言权重（升序）
日期（降序）
LinkTitle（升序）

这个方法几乎用不到。已经包含多种语言的页面集合，例如 Page 对象上的 Rotate、Translations 或 AllTranslations 方法返回的集合，本身就按语言权重排好序了。

ByLastmod

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

按最后修改日期排序时，取值由项目配置决定，默认使用前置元数据中的 lastmod 字段。

{{ range .Pages.ByLastmod }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByLastmod.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByLength

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

{{ range .Pages.ByLength }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByLength.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByLinkTitle

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

{{ range .Pages.ByLinkTitle }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByLinkTitle.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByParam

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

如果前置元数据中没有给定的参数，Hugo 会改用项目配置中的同名参数（如果存在）。

{{ range .Pages.ByParam "author" }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range (.Pages.ByParam "author").Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

如果目标参数是嵌套的，请用点号访问其字段：

{{ range .Pages.ByParam "author.last_name" }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByPublishDate

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

按发布日期排序时，取值由项目配置决定，默认使用前置元数据中的 publishDate 字段。

{{ range .Pages.ByPublishDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByPublishDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

ByTitle

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

{{ range .Pages.ByTitle }}
  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByTitle.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}

ByWeight

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

用前置元数据中的 weight 字段为页面指定weight（权重）。权重必须是非零整数。较轻的条目浮到顶部，较重的条目沉到底部。未设置权重或权重为零的页面排在集合末尾。

{{ range .Pages.ByWeight }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

要改为降序排列：

{{ range .Pages.ByWeight.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

GroupBy

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

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

{{ range .Pages.GroupBy "Section" }}
  <p>{{ .Key }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

要把各组改为降序排列：

{{ range .Pages.GroupBy "Section" "desc" }}
  <p>{{ .Key }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

GroupByDate

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

用法

按日期分组时，取值由项目配置决定，默认使用前置元数据中的 date 字段。

布局字符串的格式与 time.Format 函数的布局字符串相同。得到的分组键会按语言和地区localized（本地化）。

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

GroupByExpiryDate

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

用法

按过期日期分组时，取值由项目配置决定，默认使用前置元数据中的 expiryDate 字段。

布局字符串的格式与 time.Format 函数的布局字符串相同。得到的分组键会按语言和地区localized（本地化）。

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

GroupByLastmod

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

用法

按最后修改日期分组时，取值由项目配置决定，默认使用前置元数据中的 lastmod 字段。

布局字符串的格式与 time.Format 函数的布局字符串相同。得到的分组键会按语言和地区localized（本地化）。

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

GroupByParam

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

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

{{ range .Pages.GroupByParam "color" }}
  <p>{{ .Key | title }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

要把各组改为降序排列：

{{ range .Pages.GroupByParam "color" "desc" }}
  <p>{{ .Key | title }}</p>
  <ul>
    {{ range .Pages }}
      <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
    {{ end }}
  </ul>
{{ end }}

GroupByParamDate

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

用法

布局字符串的格式与 time.Format 函数的布局字符串相同。得到的分组键会按语言和地区localized（本地化）。

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

要按年和月对内容分组：

GroupByPublishDate

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

用法

按发布日期分组时，取值由项目配置决定，默认使用前置元数据中的 publishDate 字段。

布局字符串的格式与 time.Format 函数的布局字符串相同。得到的分组键会按语言和地区localized（本地化）。

可选的排序顺序用 asc 指定升序，或用 desc 指定降序。

IndexOf

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

（0.166.0 新增）

如果给定的页面不在页面集合中，IndexOf 方法返回 -1。

有如下内容结构：

content/
├── posts/
│   ├── _index.md
│   ├── post-1.md   <-- front matter: weight = 10
│   ├── post-2.md   <-- front matter: weight = 20
│   └── post-3.md   <-- front matter: weight = 30
└── _index.md

以及这个模板：

Len

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

{{ .Pages.Len }} → 42

Limit

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

{{ range .Pages.Limit 3 }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

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

Hugo 按以下排序层级对页面集合排序，据此确定_下一个_和_上一个_页面：

字段	优先级	排序方向
`weight`	1	降序
`date`	2	降序
`linkTitle`	3	降序
`path`	4	降序

用于确定_下一个_和_上一个_页面的这个已排序页面集合独立于其他页面集合，因此可能导致意外的行为。

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

Hugo 按以下排序层级对页面集合排序，据此确定_下一个_和_上一个_页面：

字段	优先级	排序方向
`weight`	1	降序
`date`	2	降序
`linkTitle`	3	降序
`path`	4	降序

用于确定_下一个_和_上一个_页面的这个已排序页面集合独立于其他页面集合，因此可能导致意外的行为。

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

Hugo 依据前置元数据，用多个因素找出与给定页面相关的内容。可以使用默认的相关内容配置，也可以按所需的索引与参数调整结果。详见说明。

用法

传给 Related 方法的参数可以是 Page，也可以是选项映射。例如传入当前页面：

Reverse

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

{{ range .Pages.ByDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

Pages 方法 on Hugo 中文文档

ByDate

ByExpiryDate

ByLanguage

ByLastmod

ByLength

ByLinkTitle

ByParam

ByPublishDate

ByTitle

ByWeight

GroupBy

GroupByDate

用法

GroupByExpiryDate

用法

GroupByLastmod

用法

GroupByParam

GroupByParamDate

用法

GroupByPublishDate

用法

IndexOf

Len

Limit

Next

Prev

Related

用法

Reverse