The layout, background, and styling of the title page and the title, author, and revision information displayed on it is controlled from the theme using the keys in the
The title page is only enabled by default for the book document type (e.g.,
For the list of all available
title-page theme keys, see Title Page Category Keys.
The title page can be deactivated from the theme by assigning
false to the
title-page category key.
You can also deactivate the title page from the document header using the
A background color can be applied to the title page with the
The key accepts the hex, RGB, and CMYK formats.
title-page: background-color: #EAEAEA
To turn off the background color for the title page, set the value to white (
The color keyword
transparent isn’t recognized in this context.
title-page: background-color: #FFFFFF
You can apply a background image to the title page using the
title-page: background-image: image:title.png
For accepted values and attributes, see Background images.
The target of the image macro assigned to the
image key may be a data URI, absolute path, or a path relative to the value of the
Like in the AsciiDoc syntax, wrapping the
image value in the image macro allows you to specify other settings, including
title-page: logo: image: image:logo.png[pdfwidth=2.5in,align=center]
align setting is used to align block images within the parent container.
See Block Styles for accepted alignment keywords.