组件版本如何排序

Antora将组件版本分组为文档组件。内容目录中组件的排序顺序是不确定的。但是，当通过UI模型（site.components）访问文档组件时，它们按照标题的字母顺序进行排序。组件的标题由每个组件版本的antora.yml文件中定义的 定义。如果未设置 键，Antora在排序组件时将退回到名称键。在每个组件中，版本根据组件版本排序规则进行排序。

这个经过排序的组件列表通常由UI用于呈现一个菜单小部件，读者可以使用它在不同的组件和版本之间导航。Antora的默认UI提供了这样的小部件。在默认UI中，给定组件的版本列表显示在每个组件标题下方。

Antora不要求以这种顺序显示组件和版本。如果您希望它们以不同的顺序显示，您需要自定义生成此列表的UI模板。在自定义Antora的默认UI时，您需要编辑位于UI项目中的src/partials/nav-explore.hbs的名为nav-explore的部分。该模板的关键片段是对site.components的迭代：

Antora的默认UI使用组件在UI模型中存储的顺序。您可以通过将组件列表传递给必须提供的自定义辅助函数来修改此顺序：

您还可以选择手动为要显示的每个组件创建菜单条目。这种策略还允许您排除某些组件。

Antora在排序文档组件的组件版本时只考虑version键的值。分配给version键的值确定组件版本根据其组件标题或名称在组件版本选择器菜单中的顺序。保留的值~和null将组件版本定义为无版本。

Antora在对组件的组件版本进行排序时应用以下规则：

除了对组件版本进行排序外，Antora还识别每个组件的最新稳定版本。最新组件版本，也称为最新版本，是排序列表中第一个不是预发布版本的版本。如果所有版本都是预发布版本，则选择列表中的第一个预发布版本。未标记版本的组件版本始终被视为最新版本或最新预发布版本（如果设置了prerelease）。

当无法确定版本坐标或无法确定版本时，Antora在从另一个组件对传入资源ID引用进行资格验证时使用组件的最新版本。