术语表

维度

内容变化的分类轴:语言、角色与版本。

难度
参考

开始之前,你需要

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

读完之后你能

  • 能算出一个逻辑页面会生成多少份变体,并判断 URL 里某一段属于哪根轴

接着读:版本配置

维度

维度(dimension)是内容变化的分类轴,使同一个逻辑页面可以同时存在多个变体。三个维度分别是language、role与version。例如,一个逻辑页面可以同时存在于 6 种语言、4 个版本与 2 种角色中。

为什么重要

维度是乘法的:6 种语言 × 4 个版本 × 2 种角色意味着同一个逻辑页面最多会生成 48 份产物,URL 里也就多出对应的层级。只启用其中一根轴时一切正常,一旦多开一根,构建时间和输出目录会立刻成倍增长;更常见的坑是内容目录结构没跟着维度走,于是某些组合悄悄缺页,或者矩阵表达式(如取反的 glob)把整组内容排除掉,而构建照样成功。

延伸阅读:版本配置、多语言