页面url中的模块段

ROOT模块页面的url

当一个 ROOT 模块的页面被发布到一个站点时，它们将成为其分配的组件版本的顶级页面。这意味着模块名 ROOT 永远不会出现在页面的 URL 中。

为了演示这个概念，让我们比较两个页面的url，一个分配给 ROOT 模块，另一个分配给命名模块。示例1中所示的标准目录集包含名为 Hyper Lemur 的项目的内容源文件。

Example 1. Example 1. Two module directories containing content that’s part of the Hyper Lemur project
📒 repository
  📄 antora.yml
  📂 modules
    📂 admin
      📂 pagesAlian
        📄 user-management.adoc
      📄 nav.adoc
    📂 ROOT
      📁 images
      📂 pagesAlian
        📄 deploy.adoc
        📄 index.adoc
      📄 nav.adoc

请注意ROOT模块文件夹内的pages文件夹中名为 deploy.adoc 的文件。当 Antora 为 Hyper Lemur 生成站点时，从 deploy.adoc 源文件创建的页面的 URL 将看起来像这样。

root page url

基础 URL https://my-company.com 在使用 Antora 生成网站的 playbook 中设置。组件名称段 hyperlemur 和版本段 1.0 在组件版本描述符中设置。页面段 deploy 是 AsciiDoc 源文件 deploy.adoc 的相对路径。模块名称 ROOT 在 URL 中不使用。

现在，让我们看看存储在命名模块 admin 中的页面的 URL 是什么样的。

命名模块页面的url

使用示例1中的 Hyper Lemur 源文件，让我们看看 user-management.adoc 的 URL 是什么。该文件被分配给管理(admin)模块的 pages 族。

module page url

请注意，模块的名称 admin 位于组件版本之后的 URL 中。