导航组装

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

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

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

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

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

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

在参考UI中，此列表显示在任何组件版本页面菜单底部的“抽屉”中。访问者单击抽屉时，它向上展开，读者可以选择他们想要查看的组件版本。

如果页面在组件的多个版本中可用，那么在参考UI中该页面上会显示一个下拉选择器。访问者可以从该选择器中导航到该页面的其他版本。当页面有多个版本可用时，Antora会自动填充此选择器。