统一文件系统(unified file system)
为七种构件类型提供分层视图的文件系统,项目层叠加在模块层之上。
开始之前,你需要
- 在文档里遇到不认识的 Hugo 术语时查阅
读完之后你能
- 判断同名文件冲突时哪一层生效,以及自己的改动为什么没生效
接着读:主题组件
Hugo 的_统一文件系统_(unified file system)为其七种 component 类型分别提供分层视图:archetypes、assets、content、data、templates、translation tables 和静态文件。项目的构件目录叠加在 module 构件目录之上。当多个层包含同一文件时,Hugo 使用层级最高的版本。
为什么重要
「谁覆盖谁」是这套分层视图的全部意义:项目层永远高于模块层,多个模块再按配置顺序决定优先级。这解释了两类常见困惑——改了主题里的文件却没变化(被项目里的同名文件盖住了),以及删掉项目里的同名文件后行为突然改变(下一层露出来了)。模板、资源或数据文件明明存在却找不到时,也要先确认它到底落在哪一层。