术语表

页面包(page bundle)

同时封装内容及其关联资源的目录。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断一张图片或附件该放进页面包、assets/ 还是 static/,并知道模板里相应该用哪种取法

接着读:页面包

页面包(page bundle)是同时封装内容及其关联 resources 的目录。页面包分为两种类型:leaf bundles 和 branch bundles。

参见:页面包

为什么重要

把内容页和它引用的图片、附件放进同一个目录,用 index.md 组织,页面就能通过 .Resources、Resources.GetMatch 取到「这一页自己的资源」,相对的图片引用也才能按预期解析。 换成 _index.md,同一个文件就属于分支包资源;如果把文件直接放进 assets/ 或 static/,它就是全局资源,模板里要改用 resources.Get 之类按路径查找——三种摆法都能构建成功,取值方式却完全不同。 混用时的典型现象是 .Resources 为空、GetMatch 返回 nil,而构建过程一声不响。

延伸阅读:页面包 · 页面资源