pages(页面)

源页面到站点页面

Antora 为分配给 pages 族的每个源文件自动生成一个 HTML 站点页面。另一种思考方式是:输入一个 AsciiDoc 页面文件等于输出一个 HTML 页面。

标准的源页面

页面源文件是用 AsciiDoc 语法标记的纯文本文件,并以文件扩展名 .adoc 保存。它们被存储在 pages族目录 中。

标准页面有标题和正文内容。您可以只使用一点 AsciiDoc 语法来标记您的页面,或者您可以探索 AsciiDoc 和 Antora 功能的广度,例如作用域属性,包括来自资源的标记区域和 UI 宏。

链接页面

Antora 会自动将所有标准源页面发布到您的站点,但是如果您希望在内容中创建页面到页面的链接,则需要了解 Antora 的资源 id 以及如何创建 交叉引用。您还将使用交叉引用和资源 id 来构建和组织站点的 组件版本页面菜单