术语表

分支

页面种类为 home、section、taxonomy 或 term 的节点。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断当前页面是分支还是普通内容页,从而选对可用的方法与布局

接着读:内容区块

分支

分支(branch)是 page kind(页面种类)为 home、section、taxonomy 或 term 的 node(节点)。分支可以有后代。

为什么重要

分支对应列表类页面,普通内容页(page)是它的后代;一个页面是不是分支,决定它能不能用 .Pages、.Sections 这类方法,以及它该命中哪个布局。把普通页当分支来遍历,会拿到空集合或构建报错;反过来在分支页上调用只属于普通页的方法,结果也可能为空。拿不准时先打印 .Kind 看它实际是什么。

延伸阅读:内容区块 · 布局查找顺序