文档标题
在本页面中，您将学到：
-
如何创建文档标题
-
如何指定页面标题
-
如何设置标题属性
文档标题
在 AsciiDoc 中，页面顶部的属性条目（可选）前面可以是一个零级部分标题，隐式创建一个文档标题。文档标题中的零级部分标题称为文档标题，简称为 doctitle。文档标题中的属性条目设置（或取消设置）在整个文档中可用的属性。
AsciiDoc 文档中的文档标题用作 Antora 中的页面标题。
Antora 仅支持 AsciiDoc 的 Atx 样式标题语法，这意味着页面标题必须在 Atx 标记之前，即等号标记（=）后跟一个空格。Antora 不识别 AsciiDoc 中曾经支持的传统 Setext 样式（即下划线）标题语法，也不识别 Asciidoctor 的 Markdown 样式标题语法。如果您不使用 Atx 样式语法，页面中的交叉引用将无法解析，并且 AsciiDoc 的其他功能也将不可用。 |
以下是文档标题的示例：
= 页面标题
:description: 此页面的描述。在 Antora 中，所有页面必须有一个页面标题。这意味着 doctitle，因此文档标题是必需的。有关指定页面标题的更多信息，请参阅 添加标题和元数据。
如果您需要为页面应用一组独特的 CSS，您可以向 doctitle 添加一个角色，如下所示。
= 首页
:docrole: home假设您使用的 UI 支持它，现在您可以使用 body.home 选择器来配置 CSS 以针对此特定页面。