版本特性

实际版本是一个标识符，当与组件名称结合时，为彼此直接相关的内容和源文件集合创建一个唯一标识。这些源文件集合是一个组件版本。组件版本始终有一个实际版本。即使一个无版本组件版本也有一个实际版本，定义为空字符串，用于内部排序和路由目的。

组件版本的实际版本被分配给其组件版本描述符（antora.yml）中的版本键。或者，Antora会从基于antora.yml中的version键分配的模式或播放簿中的内容源中提取实际版本。

内容编写者使用实际版本来引用其他组件版本中的页面和资产。Antora使用实际版本：

以下各节描述的每个版本特性——预发布、显示和符号——都会覆盖Antora否则将使用实际版本的默认行为。

在最终发布之前提供的项目或产品版本通常称为预发布版本。组织使用语义版本标识符，如-alpha.1，或特殊名称，如M1或Snapshot，向最终用户传达版本是预发布版本。为了补充项目的预发布版本，可以使用prerelease键将组件版本指定为预发布版本。

当在antora.yml文件中为prerelease键分配一个标识符或保留值true时，组件版本被指定为预发布版本。使用prerelease键具有以下好处：

实际版本不能包含空格、大写字母或会导致处理或可移植性错误的某些字符。然而，当在UI菜单中显示实际版本时，如果最终用户希望版本以空格、大写字母或其他符号显示，那么应为组件版本分配一个显示版本。

显示版本是仅用于UI菜单中的展示目的的标识符。与实际版本不同，显示版本可以包含空格、大写字母和其他符号或字符。显示版本是在组件版本的antora.yml文件中使用display_version键指定的。显示版本由UI使用，用于显示版本的地方，包括组件版本选择器和页面版本选择器。显示版本永远不会用于页面或资源ID、组件版本路由和排序，或URL的版本段中。

符号版本或符号预发布版本是一个值，用于替换URL的版本段中的实际版本。符号版本或预发布版本仅适用于最新组件版本或最新预发布版本的URL。符号版本或预发布版本永远不适用于无版本组件版本。因为符号版本和符号预发布版本适用于站点中所有最新组件版本或预发布版本，这些值是在您的播放簿中分配的，而不是在单个组件版本的antora.yml文件中。符号版本分配给播放簿中的latest_version_segment键。符号预发布版本分配给播放簿中的latest_prerelease_version_segment键。