页面目录和文件
页面家族目录
模块目录可以包含一个名为pages的家族目录。 pages目录可以包含子目录。 只应将扩展名为.adoc的AsciiDoc源文件存储在pages目录及其子目录中,因为Antora在运行时会对页面文件应用预设行为。
📂 模块 📂 命名模块 (1) 📂 页面 (2) 📄 页面源文件.adoc (3) 📂 页面子目录 (4) 📄 页面源文件.adoc 📂 根 (5) 📂 页面 (6) 📄 页面源文件.adoc 📄 导航.adoc
1 | 一个命名的模块目录。 |
2 | 一个pages家族目录。 存储在pages中的源文件被分类为页面。 |
3 | 使用AsciiDoc语法标记的页面文件,并保存为有效的.adoc文件扩展名。 |
4 | pages中的子目录。 存储在pages目录的子目录中的源文件被分类为页面。 |
5 | 一个根模块目录。 |
6 | 一个pages家族目录。 |
pages目录是可选的。 也就是说,如果一个模块没有任何页面文件,就不要在模块中创建pages目录。 如果设置了pages目录,则pages目录或pages的子目录必须至少包含一个AsciiDoc源文件。