Paginate

分頁是將一個頁面列表拆分為兩個或更多的分頁，每個分頁包含頁面集合的一部分並提供導航鏈接到其他分頁的過程。

默認情況下，每個分頁的元素數量由您的網站配置決定。默認值為 10。您可以在調用 Paginate 方法時提供第二個參數（整數）來覆蓋這個值。

您可以在首頁模板、區段模板、分類法模板和術語模板上調用分頁。

layouts/_default/list.html
{{ $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. 調用內嵌分頁模板，創建分頁之間的導航鏈接
Paginator PageSize