📄 分页条

⚡ 最简写法

模板里直接调用 {{pagebar .TotalPages .CurrentQuery .CurrentPage}} 即可，自动生成上一页 / 下一页 / 页码链接（基于 ?page=N 查询参数）。

<div class="pagination">
  {{pagebar .TotalPages .CurrentQuery .CurrentPage}}
</div>

📋 分页相关字段

当使用 list 分页或内置列表页时，以下字段可用：

⚠️ 两套分页链接风格并存：pagebar 函数与 pageURL 函数生成的是 ?page=N 查询式链接；而上面的 FirstURL/PrevURL/NextURL/LastURL/PageNumbers[].URL 是路径式链接（如 /products/index2.html），更适合整站静态导出。动态站点可混用，静态导出建议只用路径式字段。

💻 自定义分页条（推荐：路径式，利于整站静态导出）

系统已为你算好每个按钮的路径式链接（不含 ?），直接输出即可；配合 PageNumbers 中的 .Num / .URL / .IsEllipsis 渲染页码。

<div class="pagination">
  {{if .HasPrev}}<a href="{{.FirstURL}}">首页</a><a href="{{.PrevURL}}">上一页</a>{{end}}
  {{range .PageNumbers}}
  {{if .IsEllipsis}}<span class="dots">…</span>
  {{else if eq .Num $.Page}}<span class="current">{{.Num}}</span>
  {{else}}<a href="{{.URL}}">{{.Num}}</a>{{end}}
  {{end}}
  {{if .HasNext}}<a href="{{.NextURL}}">下一页</a><a href="{{.LastURL}}">末页</a>{{end}}
</div>

备选（动态查询串方式）：若站点以动态方式运行（非整站静态导出），可用 pageURL 函数生成 ?page=N 链接，但必须传 3 个参数（当前页 / 总页数 / 查询串）：{{pageURL .PrevPage .TotalPages .CurrentQuery}}。