导航组件

组件版本的导航至少由一个 AsciiDoc 文件描述。然而，正如您在图中看到的，您可以从多个文件中组装组件版本的导航。为每个模块创建一个导航文件是一种常见的组织结构，但不是必需的。

导航文件包含一个或多个项目符号列表。列表中的每个项目都可以是对页面的交叉引用，也可以是不属于该网站的网站的 URL ，也可以是未链接的文本，例如对嵌套列表项集合进行分组的类别标题。您可以从多个文件组合导航。

当您希望将导航文件的内容发布到组件版本的页面菜单时，需要在相应的组件版本描述符文件中注册该文件。

导航文件在 nav 键下的组件版本描述符文件中注册。按照您希望在站点上发布的组件版本页面菜单中显示的顺序列出导航文件。当 Antora 运行时，它只使用注册的导航文件来创建组件版本页面菜单。

Antora 收集每个注册的导航文件的内容，按照文件在导航键下列出的顺序排列内容，并为组件版本发布一个完全组装的页面菜单。组件版本页菜单的行为和样式由剧本中指定的 UI 包决定。

当您的站点有多个组件或组件版本时，Antora 将组装一个组件及其版本的聚合列表。这个包含组件及其版本的菜单是组件版本选择器。Antora 自动按字母顺序列出组件。每个组件版本都是从最大或最新的版本开始排序的。

在引用 UI 中，此列表显示在位于任何组件版本页面菜单底部的抽屉样式菜单中。当访问者点击抽屉时，它向上展开，然后读者可以选择他们想要看到的组件版本。

如果一个页面在组件的多个版本中可用，则在该页面的引用 UI 中可以看到一个下拉选择器。从这个选择器中，访问者可以在该页面的其他版本之间导航。当一个页面有多个版本可用时，Antora 会自动填充这个选择器。