术语表

类型(type)

即内容类型(content type)。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断页面渲染异常是模板查找的问题,还是 type 或目录位置不对

接着读:内容类型配置

参见content type。

为什么重要

内容类型决定 Hugo 去 layouts 的哪个子目录找这套页面的模板:写 type = "docs" 就用 layouts/docs/ 下的模板,不写则默认取内容所在的 section。所以「页面能渲染但样式全丢了」或「套用了别的列表页排版」这类现象,多半是 type 或文件目录与模板目录对不上。类型也参与模板查找顺序,排查时先确认页面实际用的 type。

延伸阅读:内容类型配置、模板查找顺序