Next

PAGE.Next

hugolib.pageState

Prev 和 Next 方法在 Page 对象上的行为可能与您的预期相反。

假设有如下内容结构：

content/
├── pages/
│   ├── _index.md
│   ├── page-1.md   <-- 前置元数据: weight = 10
│   ├── page-2.md   <-- 前置元数据: weight = 20
│   └── page-3.md   <-- 前置元数据: weight = 30
└── _index.md

当您访问 page-2 页面时：

• Prev 方法指向 page-3 页面
• Next 方法指向 page-1 页面

{{ with .Next }}
  <a href="{{ .RelPermalink }}">Prev</a>
{{ end }}

{{ with .Prev }}
  <a href="{{ .RelPermalink }}">Next</a>
{{ end }}

与 Pages 方法进行对比

在 Pages 对象上，Next 和 Prev 方法比在 Page 对象上的 Next 和 Prev 方法更灵活。

本地定义

每次调用 PAGES.Next 和 PAGES.Prev 时重新构建页面集合。在局部集合中，页面之间的导航与全局集合无关，相对于当前页面的位置。

在本地集合中，导航排序顺序与集合排序顺序相同。

全局定义

在列表页面上一次性构建页面集合。在全局集合中，页面之间的导航与当前页面在全局集合内的位置相关。

在全局集合中，导航排序顺序是固定的，使用 Hugo 的默认排序顺序。按优先级排序如下：

1. 页面的 weight 属性
2. 页面的 date 属性（降序排列）
3. 页面的 linkTitle 属性，否则使用页面的 title 属性
4. 如果页面有文件支持，则使用页面的文件路径

例如，使用按标题排序的全局集合，导航排序顺序将使用 Hugo 的默认排序顺序。这可能不符合您的期望和需求。因此，一般而言，在 Pages 对象上使用 Next 和 Prev 方法是更好的选择。