术语表

统一文件系统(unified file system)

为七种构件类型提供分层视图的文件系统,项目层叠加在模块层之上。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断同名文件冲突时哪一层生效,以及自己的改动为什么没生效

接着读:主题组件

Hugo 的_统一文件系统_(unified file system)为其七种 component 类型分别提供分层视图:archetypes、assets、content、data、templates、translation tables 和静态文件。项目的构件目录叠加在 module 构件目录之上。当多个层包含同一文件时,Hugo 使用层级最高的版本。

为什么重要

「谁覆盖谁」是这套分层视图的全部意义:项目层永远高于模块层,多个模块再按配置顺序决定优先级。这解释了两类常见困惑——改了主题里的文件却没变化(被项目里的同名文件盖住了),以及删掉项目里的同名文件后行为突然改变(下一层露出来了)。模板、资源或数据文件明明存在却找不到时,也要先确认它到底落在哪一层。

延伸阅读:主题组件、目录结构