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.

Key Value Type Example

background-color

Color
(default: inherit)

 
title-page:
  background-color: #EAEAEA
yaml

background-image

image macro | path
(default: not set)

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

font-color

Color
(default: inherit)

 
title-page:
  font-color: #333333
yaml

font-family

Font family name
(default: inherit)

 
title-page:
  font-family: Noto Serif
yaml

font-kerning

none | normal
(default: inherit)

 
title-page:
  font-kerning: none
yaml

font-size

Number
(default: inherit)

 
title-page:
  font-size: 13
yaml

font-style

Font style
(default: inherit)

 
title-page:
  font-style: bold
yaml

line-height

Number
(default: 1.15)

 
title-page:
  line-height: 1
yaml

text-align

Text alignment
(default: center)

 
title-page:
  text-align: right
yaml

text-transform

Text transform
(default: inherit)

 
title-page:
  text-transform: uppercase
yaml

title-page

flag
(default: set when doctype is book)

 
title-page: false
yaml

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
yaml

image

image macro | path
(default: not set)

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

top

Measurement
(default: 10%)

 
title-page:
  logo:
    top: 25%
yaml

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
yaml

font-color

Color
(default: inherit)

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

font-family

Font family name
(default: inherit)

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

font-kerning

none | normal
(default: inherit)

 
title-page:
  title:
    font-kerning: none
yaml

font-size

Number
(default: 18)

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

font-style

Font style
(default: inherit)

 
title-page:
  title:
    font-style: bold
yaml

line-height

Number
(default: $heading-line-height)

 
title-page:
  title:
    line-height: 0.9
yaml

margin-bottom

Measurement
(default: 0)

 
title-page:
  title:
    margin-bottom: 5
yaml

margin-top

Measurement
(default: 0)

 
title-page:
  title:
    margin-top: 13.125
yaml

text-transform

Text transform
(default: inherit)

 
title-page:
  title:
    text-transform: smallcaps
yaml

top

Measurement
(default: 40%)

 
title-page:
  title:
    top: 55%
yaml

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
yaml

font-color

Color
(default: inherit)

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

font-family

Font family name
(default: inherit)

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

font-kerning

none | normal
(default: inherit)

 
title-page:
  subtitle:
    font-kerning: none
yaml

font-size

Number
(default: 14)

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

font-style

Font style
(default: inherit)

 
title-page:
  subtitle:
    font-style: bold_italic
yaml

line-height

Number
(default: $heading-line-height)

 
title-page:
  subtitle:
    line-height: 1
yaml

margin-bottom

Measurement
(default: 0)

 
title-page:
  subtitle:
    margin-bottom: 5
yaml

margin-top

Measurement
(default: 0)

 
title-page:
  subtitle:
    margin-top: 13.125
yaml

text-transform

Text transform
(default: inherit)

 
title-page:
  subtitle:
    text-transform: uppercase
yaml

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}]"
yaml

delimiter

Quoted string
(default: ', ')

 
title-page:
  authors:
    delimiter: '; '
yaml

display

none
(default: not set)

 
title-page:
  authors:
    display: none
yaml

font-color

Color
(default: inherit)

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

font-family

Font family name
(default: inherit)

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

font-kerning

none | normal
(default: inherit)

 
title-page:
  authors:
    font-kerning: none
yaml

font-size

Number
(default: inherit)

 
title-page:
  authors:
    font-size: 13
yaml

font-style

Font style
(default: inherit)

 
title-page:
  authors:
    font-style: bold_italic
yaml

margin-bottom

Measurement
(default: 0)

 
title-page:
  authors:
    margin-bottom: 5
yaml

margin-top

Measurement
(default: 12)

 
title-page:
  authors:
    margin-top: 13.125
yaml

text-transform

Text transform
(default: inherit)

 
title-page:
  authors:
    text-transform: uppercase
yaml

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: ': '
yaml

display

none
(default: not set)

 
title-page:
  revision:
    display: none
yaml

font-color

Color
(default: inherit)

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

font-family

Font family name
(default: inherit)

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

font-kerning

none | normal
(default: inherit)

 
title-page:
  revision:
    font-kerning: none
yaml

font-size

Number
(default: inherit)

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

font-style

Font style
(default: inherit)

 
title-page:
  revision:
    font-style: bold
yaml

margin-bottom

Measurement
(default: 0)

 
title-page:
  revision:
    margin-bottom: 5
yaml

margin-top

Measurement
(default: 0)

 
title-page:
  revision:
    margin-top: 13.125
yaml

text-transform

Text transform
(default: inherit)

 
title-page:
  revision:
    text-transform: none
yaml