Title Page Category Keys

title-page

The keys in the title-page category control the title page and the arrangement and style of the elements on it. See Title Page for examples and more information.

The title-page key is always written as single key rather than divided into title and page. The nesting in the data structure typically only begins with secondary categories such as authors (i.e., the authors category key is nested under the title-page category key.
Key Value Type Example

background-color

Color
(default: inherit)

title-page:
  background-color: #EAEAEA

background-image

image macro | path
(default: not set)

title-page:
  background-image: image:title.png[]

font-color

Color
(default: inherit)

title-page:
  font-color: #333333

font-family

Font family name
(default: inherit)

title-page:
  font-family: Noto Serif

font-kerning

none | normal
(default: inherit)

title-page:
  font-kerning: none

font-size

Font size
(default: inherit)

title-page:
  font-size: 13

font-style

Font style
(default: inherit)

title-page:
  font-style: bold

line-height

Number
(default: 1.15)

title-page:
  line-height: 1

text-align

Text alignment
(default: center)

title-page:
  text-align: right

text-transform

Text transform
(default: inherit)

title-page:
  text-transform: uppercase

title-page

flag
(default: set when doctype is book)

title-page: false

The keys in the title-page-logo category control the arrangement of a logo on the title page.

Key Value Type Example

align

Block alignment
(default: $title-page-text-align)

title-page:
  logo:
    align: right

image

image macro | path
(default: not set)

title-page:
  logo:
    image: image:logo.png[pdfwidth=25%]

top

Measurement
(default: 10%)

title-page:
  logo:
    top: 25%

top

The absolute top position of the logo. The % unit is a percentage of the content height, starting from the top of the content area. The vh unit is a percentage of the page height, starting from the top of the page.

title-page-title

The keys in the title-page-title category control the display, arrangement and style of the title on the title page.

Key Value Type Example

display

none
(default: not set)

title-page:
  title:
    display: none

font-color

Color
(default: inherit)

title-page:
  title:
    font-color: #999999

font-family

Font family name
(default: inherit)

title-page:
  title:
    font-family: Noto Serif

font-kerning

none | normal
(default: inherit)

title-page:
  title:
    font-kerning: none

font-size

Font size
(default: 18)

title-page:
  title:
    font-size: $heading-h1-font-size

font-style

Font style
(default: inherit)

title-page:
  title:
    font-style: bold

line-height

Number
(default: $heading-line-height)

title-page:
  title:
    line-height: 0.9

margin-bottom

Measurement
(default: 0)

title-page:
  title:
    margin-bottom: 5

margin-top

Measurement
(default: 0)

title-page:
  title:
    margin-top: 13.125

text-transform

Text transform
(default: inherit)

title-page:
  title:
    text-transform: smallcaps

top

Measurement
(default: 40%)

title-page:
  title:
    top: 55%

top

The absolute top position of the logo. The % unit is a percentage of the content height, starting from the top of the content area. The vh unit is a percentage of the page height, starting from the top of the page.

title-page-subtitle

The keys in the title-page-subtitle category control the display, arrangement and style of the subtitle of the title page. Subtitle partitioning of the document title is only enabled when the title page is also enabled.

Key Value Type Example

display

none
(default: not set)

title-page:
  subtitle:
    display: none

font-color

Color
(default: inherit)

title-page:
  subtitle:
    font-color: #181818

font-family

Font family name
(default: inherit)

title-page:
  subtitle:
    font-family: Noto Serif

font-kerning

none | normal
(default: inherit)

title-page:
  subtitle:
    font-kerning: none

font-size

Font size
(default: 14)

title-page:
  subtitle:
    font-size: $heading-h3-font-size

font-style

Font style
(default: inherit)

title-page:
  subtitle:
    font-style: bold_italic

line-height

Number
(default: $heading-line-height)

title-page:
  subtitle:
    line-height: 1

margin-bottom

Measurement
(default: 0)

title-page:
  subtitle:
    margin-bottom: 5

margin-top

Measurement
(default: 0)

title-page:
  subtitle:
    margin-top: 13.125

text-transform

Text transform
(default: inherit)

title-page:
  subtitle:
    text-transform: uppercase

title-page-authors

The keys in the title-page-authors category control the display, arrangement and style of the author information on the title page.

Key Value Type Example

content

Quoted AsciiDoc string
(default: "{author}")

title-page:
  authors:
    content:
      name_only: "{author}"
      with_email: "{author} <{email}>"
      with_url: "{url}[{author}]"

delimiter

Quoted string
(default: ', ')

title-page:
  authors:
    delimiter: '; '

display

none
(default: not set)

title-page:
  authors:
    display: none

font-color

Color
(default: inherit)

title-page:
  authors:
    font-color: #181818

font-family

Font family name
(default: inherit)

title-page:
  authors:
    font-family: Noto Serif

font-kerning

none | normal
(default: inherit)

title-page:
  authors:
    font-kerning: none

font-size

Font size
(default: inherit)

title-page:
  authors:
    font-size: 13

font-style

Font style
(default: inherit)

title-page:
  authors:
    font-style: bold_italic

margin-bottom

Measurement
(default: 0)

title-page:
  authors:
    margin-bottom: 5

margin-top

Measurement
(default: 12)

title-page:
  authors:
    margin-top: 13.125

text-transform

Text transform
(default: inherit)

title-page:
  authors:
    text-transform: uppercase

content

The content key accepts the optional keys name_only, with_email, and with_url.

title-page-revision

The keys in the title-page-revision category control the display, arrangement and style of the revision information on the title page.

Key Value Type Example

delimiter

Quoted string
(default: ', ')

title-page:
  revision:
    delimiter: ': '

display

none
(default: not set)

title-page:
  revision:
    display: none

font-color

Color
(default: inherit)

title-page:
  revision:
    font-color: #181818

font-family

Font family name
(default: inherit)

title-page:
  revision:
    font-family: Noto Serif

font-kerning

none | normal
(default: inherit)

title-page:
  revision:
    font-kerning: none

font-size

Font size
(default: inherit)

title-page:
  revision:
    font-size: $base-font-size-small

font-style

Font style
(default: inherit)

title-page:
  revision:
    font-style: bold

margin-bottom

Measurement
(default: 0)

title-page:
  revision:
    margin-bottom: 5

margin-top

Measurement
(default: 0)

title-page:
  revision:
    margin-top: 13.125

text-transform

Text transform
(default: inherit)

title-page:
  revision:
    text-transform: none