术语表

页面类型(page kind)

对页面的分类,取值为 home、page、section、taxonomy 或 term 之一。

难度
参考

开始之前,你需要

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

读完之后你能

  • 根据目录结构和文件名判断一个页面属于哪种页面类型,并预判它会用哪个模板、哪些判断方法返回真

接着读:Kind

页面类型(page kind)是对页面的分类,取值为 home、page、section、taxonomy 或 term 之一。

参见:Kind

为什么重要

模板查找顺序、.IsPage / .IsSection / .IsBranch 的返回值、where 筛选以及 cascade 里的 kind 条件,全都以页面类型为依据;判断错类型最常见的后果是首页或 section 列表页套用了文章模板,渲染出一片空白或只出现一个条目。 页面类型只由内容在 content/ 中的位置决定,前置元数据改不了它:_index.md 会成为首页或 section 页,index.md 是叶子包的内容页,而 taxonomy 与 term 页由分类法配置生成。 排查时先用 .Kind(或 debug.Dump)把当前页面的类型打印出来,再决定模板走哪个分支。

延伸阅读:Kind 方法 · 模板查找顺序