术语表

section 页(section page)

page kind 为 section 的页面,通常是当前 section 内页面与下级 section 页的列表。

难度
参考

开始之前,你需要

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

读完之后你能

  • 能判断一个页面是不是 section 页,并知道文章从列表消失时该先检查什么

接着读:内容区块

section 页(section page)是 page kind 为 section 的页面。通常是当前 section 内 regular pages 和/或其他 section 页的列表。

为什么重要

列表页模板、.Pages/.RegularPages 与 .Paginator 都作用在 section 页上,而不是常规页面,默认模板是 layouts/_default/section.html 或 list.html。判断依据是目录里的 _index.md:把文章文件误命名为 _index.md,它就变成 section 页,从 .RegularPages 列表里消失——这是「文章不见了」最常见的原因。

延伸阅读:内容区块、模板查找顺序