On this page, you’ll learn:
How to create a document header
How to specify a page title
How to set header attributes
In AsciiDoc, attribute entries at the top of the page optionally preceded by a level-0 section title implicitly creates a document header. The level-0 section title in the document header is referred to as document title, or doctitle for short. The attribute entries in the document header set (or unset) attributes that are available throughout the document.
The document title in the AsciiDoc document is used as the page title in Antora.
Antora only supports AsciiDoc’s Atx-style heading syntax, which means the page title must be preceded by an Atx marker, an equals sign marker (
Here’s an example of a document header:
= Page Title :description: A description of this page.
In Antora, all pages must have a page title. That means the doctitle, and thus the document header, is required. See Add a Title and Metadata for more information about specifying a page title.
If you need to apply a unique set of CSS to a page, you can add a role to the doctitle, as shown here.
= Home Page :docrole: home
Assuming the UI you’re using supports it, you can now use the
body.home selector to configure CSS to target this specific page.
Header attributes are document-wide AsciiDoc attributes that are associated with the document header, and thus the document metadata.
Some header attributes can be used to control the processing of the page, such as
More commonly, header attributes are used to store reusable inline content for the document.
|The document header implicitly ends at the first empty line. Therefore, any attribute entries below this line will not be treated as header attributes.|
There are several built-in header attributes you can use to control the metadata in the published page. See Add a Title and Metadata to learn about these attributes.
Header attributes can be promoted to page attributes by prefixing the name with
Page Attributes are accessible from the UI model in the page layout template and can thus control how the page is formed.