分页

PAGE.Paginate COLLECTION [N]

page.Pager

分页是将列表页拆分成两个或多个分页器的过程，每个分页器包含页面集合的一个子集以及到其他分页器的导航链接。

默认情况下，每个分页器上的元素数量由您的 站点配置 确定。默认值为 10 。在调用 Paginate 方法时，通过提供第二个参数（一个整数）来覆盖该值。

您可以在 主页模板 、 章节模板 、 分类模板 和 术语模板 上调用分页。

{{ $pages := where .Site.RegularPages "Section" "articles" }}
{{ $pages = $pages.ByTitle }}
{{ range (.Paginate $pages 7).Pages }}
  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}
{{ template "_internal/pagination.html" . }}

在上面的例子中，我们：

1. 构建一个页面集合
2. 按标题对集合进行排序
3. 对集合进行分页，每个分页器包含7个元素
4. 遍历分页后的页面集合，为每个页面渲染一个链接
5. 调用嵌入式分页模板来创建分页器之间的导航链接