组件版本如何排序

在此页面上,您将学习:

  • Antora 如何分类组件和组件版本。

  • Antora 如何选择最新版本的组件。

在选择版本控制方案及其在站点 UI 中的潜在表示和路由结果时,了解 Antora 如何对组件版本进行排序非常重要。

Docs 组件排序顺序

Antora 根据每个组件版本的 Antora.yml 文件 中定义的标题键将组件版本排序到文档组件中。如果没有设置标题键,那么 Antora 将后退到名称键来对组件进行排序。

Docs 组件按字母顺序排序。生成的按字母顺序排列的组件列表用于在组件版本选择器菜单中显示。在每个组件标题或名称下,菜单中显示了根据组件版本排序规则排序的版本列表。

版本控制方案

在对 docs 组件的组件版本进行排序时,Antora 只考虑版本(version)键的值。分配给 version 键的值决定了组件的版本控制方案,从而决定了组件版本在组件标题或组件版本选择器菜单中的名称下的放置顺序。保留值 ~null 将组件版本定义为未版本化的。

方案 有效标识 示例

Semantic

整数

字符串以一个数字开头,并包含至少一个点(.)字符

字符串以 v 开头,然后是一个数字,并包含至少一个点(.)字符

30

2.4

v90.3

Named

所有与语义模式或保留版本值不匹配的值

使用 (~,null)

edge

z4

Unversioned

~

null

~

最新组件版本