术语表

版本(version)

表示内容某个特定迭代、发布或生命周期阶段的维度。

难度
参考

开始之前,你需要

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

读完之后你能

  • 判断版本相关的配置写错会出现什么现象,以及哪些名字必须逐字核对

接着读:版本配置

版本(version)是一种 dimension,表示内容的某个特定迭代、发布或生命周期阶段。language 关注本地化,role 关注受众,而版本维度让你可以使用语义化版本同时维护同一内容的多份状态。

另请参见:default version。

为什么重要

版本维度让同一份内容的多份状态在一次构建里共存(例如 v1 与 v2 文档),模板再按版本把读者导向对应内容。它和语言、角色不是一回事,配错的表现也很直接:版本名不写成语义化版本号会失去排序依据;defaultContentVersion 与已定义版本名不一致时行为不在文档保证范围内;默认版本是否进入同名子目录(defaultContentVersionInSubdir)没定好,则会出现同一页在错误版本下可见、或版本切换器指向空页面。改完版本配置,要连站内链接一起核对。

延伸阅读:版本配置、内容组织