导航文件位置

常见的模式是每个模块目录包含自己的导航文件。模块已经表示了概念或目标的逻辑组，因此您很可能将对该模块页面的 xref 排列成一个连续的、分层的导航菜单项流。这还减少了在向导航文件添加页面时 xref 中资源 id 所需的坐标数量。

导航文件应该存储在模块目录的底部，也就是说，与页面族目录处于同一级别。请勿将导航文件保存在 pages 文件夹中，否则导航文件将被转换为页面并作为页面发布。

模块目录可以包含多个导航文件。此功能可以帮助您在 anora.yml 文件 中注册导航文件时精细地调整导航列表顺序。

将导航文件存储在它引用的模块中，可以简化输入其中的页面交叉引用。它还可以帮助编写者在向模块添加页面或从模块中删除页面时定位受影响的导航。但是，对其他模块页面(甚至其他组件版本页面)的 xref 可以输入到任何模块的导航文件中。您只需要将模块坐标(或组件名称和版本坐标)添加到导航文件中创建的交叉引用中。例如，您可以在组件版本的 ROOT 模块中存储单个导航文件，而不是在组件版本的每个模块中都有导航文件，您只需将对其他模块中页面的交叉引用直接添加到 ROOT 模块的导航文件中。