术语表

列表页(list page)

在上下文中接收页面集合的页面类型,包括首页、section 页、分类法页与术语页。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 能判断当前页面是不是列表页,并说清列表逻辑写在单页模板里为什么不生效

接着读:模板查找顺序

列表页(list page)是任何在context中接收页面collection的page kind。这包括首页、section pages、taxonomy pages和term pages。

为什么重要

列表页与普通内容页走两套模板:Hugo 为首页、section、分类法、术语这些列表页查找列表模板,为普通内容页查找单页模板。把渲染 page collection(页面集合)的逻辑写进单页模板,改动不会生效,而你还以为是筛选条件写错了。判断当前页是不是列表页,用 .IsNode 或 .Kind 比盯着目录结构猜更可靠。

延伸阅读:模板查找顺序、分页