分页
Syntax
PAGE.Paginate COLLECTION [N]
Returns
page.Pager
分页是将列表页面分割成两个或多个分页器的过程,每个分页器包含页面集合的一个子集,并提供导航链接到其他分页器。
默认情况下,每个分页器上的元素数量由站点配置的paginate
设置值确定。默认值为10
。调用Paginate
方法时,可以通过提供第二个参数(整数)来覆盖站点配置中的值。
您可以在主页模板,section
模板,taxonomy
模板和term
模板上调用分页。
layouts/_default/list.html
{{ $pages := where .Site.RegularPages "Section" "articles" }}
{{ $pages = $pages.ByTitle }}
{{ range (.Paginate $pages 7).Pages }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
{{ template "_internal/pagination.html" . }}
在上面的例子中,我们:
- 构建一个页面集合
- 按标题对集合进行排序
- 对集合进行分页处理,每个分页器包含 7 个元素
- 遍历分页的页面集合,渲染每个页面的链接
- 调用内部的 “pagination” 模板创建分页器之间的导航链接。