分页 (Pagination)

Snow 支持 Section 和 Taxonomy Term 级别的分页。

Section 分页

通过 FrontMatter 或配置启用：

1sections:
2  posts:
3    paginate: 10
4    paginate_filter_by: ""

当 paginate_path 未设置或为空字符串时，分页器会根据 Section/Term 的 path 选择默认值：目录路径（pretty）使用 page/{number}/，文件路径（ugly）使用 {name}{number}{extension}。

Taxonomy Term 分页

1taxonomies:
2  tags:
3    term:
4      paginate: 10
5      paginate_filter_by: ""

分页路径变量

分页路径基于 Section/Term 的 path 值拼接。

第一页始终使用 Section/Term 自身的 path。paginate_path 只用于第二页及之后的分页路径。

如果 Section/Term 的 path 以 / 结尾，会按目录路径处理后续分页：{name} 为 index，{extension} 为 .html。例如 /posts/ 搭配 {name}{number}{extension} 会生成 /posts/、/posts/index2.html。

如果 path 是文件路径，后续分页会使用该文件名和扩展名。比如 /posts.html 搭配 {name}-{number}{extension} 会生成 /posts.html、/posts-2.html。

示例

 1# 示例一：沿用源路径结构
 2path: "posts/"
 3paginate_path: "{name}{number}{extension}"
 4
 5# → 第一页: /posts/
 6# → 第二页: /posts/index2.html
 7
 8# 示例二：使用子目录
 9path: "posts/"
10paginate_path: "page/{number}{extension}"
11
12# → 第一页: /posts/
13# → 第二页: /posts/page/2.html
14
15# 示例三：留空 paginate_path，pretty 路径使用目录 fallback
16path: "posts/"
17paginate_path: ""
18
19# → 第一页: /posts/
20# → 第二页: /posts/page/2/
21
22# 示例四：留空 paginate_path，ugly 路径沿用文件名
23path: "posts.html"
24paginate_path: ""
25
26# → 第一页: /posts.html
27# → 第二页: /posts2.html

模板变量

例：

1{% if paginator.HasPrev() %}
2<a href="{{ paginator.Prev.Permalink }}">上一页</a>
3{% endif %}
4
5<span>{{ paginator.PageNum }} / {{ paginator.Total }}</span>
6
7{% if paginator.HasNext() %}
8<a href="{{ paginator.Next.Permalink }}">下一页</a>
9{% endif %}