页面URL中的模块段

ROOT模块页面的URL

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

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

示例1. 包含属于Hyper Lemur项目的内容的两个模块目录
📒 仓库
  📄 antora.yml
  📂 模块
    📂 管理员
      📂 页面
        📄 用户管理.adoc
      📄 导航.adoc
    📂 ROOT
      📁 图像
      📂 页面
        📄 部署.adoc
        📄 索引.adoc
      📄 导航.adoc

注意ROOT模块文件夹内页面文件夹中名为部署.adoc的文件。当Antora为Hyper Lemur生成站点时,从部署.adoc源文件创建的页面的URL将如下所示。

ROOT模块页面URL

基本URLhttps://my-company.com在Antora用于生成站点的playbook中设置。组件名称段hyperlemur和版本段1.0组件版本描述符中设置。页面段部署是AsciiDoc源文件部署.adoc的家族相对路径。模块名称ROOT不会出现在URL中。

现在,让我们看看存储在命名模块管理员中的页面的URL会是什么样子。

命名模块页面的URL

使用示例1中的Hyper Lemur源文件,让我们看看用户管理.adoc文件的URL会是什么样子。该文件分配给管理员模块的页面家族。

命名模块页面URL

注意,在组件版本之后直接在URL中出现管理员模块的模块名称