主题组件

theme:
- my-shortcodes
- base-theme
- hyde

theme = ['my-shortcodes', 'base-theme', 'hyde']

{
   "theme": [
      "my-shortcodes",
      "base-theme",
      "hyde"
   ]
}

你甚至可以嵌套它，让主题组件本身在其自己的 hugo.toml 中包含主题组件（主题继承）。¹

上面 hugo.toml 中的主题定义示例创建了一个包含 3 个主题组件的主题，其优先级从左到右。

对于任何给定的文件、数据条目等，Hugo 将首先在项目中查找，然后在 my-shortcodes、base-theme 中查找，最后在 hyde 中查找。

Hugo 使用两种不同的算法来合并文件系统，具体取决于文件类型

• 对于 i18n 和 data 文件，Hugo 使用文件内的翻译 ID 和数据键进行深度合并。
• 对于 static、layouts（模板）和 archetypes 文件，它们在文件级别合并。因此，将选择最左边的文件。

上面 theme 定义中使用的名称必须与 /your-site/themes 中的目录匹配，例如 /your-site/themes/my-shortcodes。计划对此进行改进并获得 URL 方案，以便可以自动解析它。

另请注意，作为主题一部分的组件可以有自己的配置文件，例如 hugo.toml。目前，主题组件可以配置的内容有一些限制

• params（全局和每种语言）
• menu（全局和每种语言）
• outputformats 和 mediatypes

此处适用相同的规则：最左侧具有相同 ID 的参数/菜单等将胜出。上面有一些隐藏的和实验性的命名空间支持，我们将在未来努力改进，但鼓励主题作者创建自己的命名空间以避免命名冲突。