版本方面

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

组件版本的实际版本被分配给其组件版本描述符( antora.yml )中的版本键。或者，实际的版本是由 Antora 根据分配给 Antora.yml 版本键的模式从 git refname 中提取的或剧本中的内容源获取。

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

在下面的章节中描述的每个版本面预发布、显示和符号，都覆盖了一个默认行为，否则 Antora 将使用实际版本。

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

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

实际版本不能包含空格、大写字母或导致处理或可移植性错误的某些字符。但是，如果最终用户希望使用空格、大写字母或其他符号显示版本，则在 UI 菜单中显示的实际版本可能无法提供适当的体验。在这种情况下，应该将显示版本分配给组件版本。

显示版本是一个标识符，仅用于 UI 菜单中的表示目的。与实际版本不同，显示版本可以包含空格、大写字母和其他符号或字符。通过在组件版本 antora.yml 中使用“显示版本”键来指定显示版本。显示版本由显示版本的 UI 使用，包括组件版本选择器和页面版本选择器。页面或资源id、组件版本路由和排序或url的版本段中从不使用显示版本。

符号版本或符号预发布版本是一个替换 URL 版本段中实际版本的值。符号版本和预发布版本分别只适用于最新组件版本和最新预发布版本的 url 。符号版本或预发布版本永远不适用于未版本化的组件版本。因为符号版本和符号预发布版本适用于站点中的所有最新组件版本或预发布版本，所以这些值是在您的剧本中分配的，而不是在单个组件版本 antora.yml 的脚本中分配的。符号版本被分配给剧本中最新的版本段键。符号预发布版本被分配给剧本中最新的预发布版本段键。