What’s New in Asciidoctor PDF 2.2

Allow a page background image to be specified per layout using the {page-layout} attribute reference in the target path.

Allow the page margins for rotated pages to be configured independently using the page-margin-rotated theme key or pdf-page-margin-rotated document attribute.

Allow orphan detection to be enabled for all section titles and discrete headings by setting heading-min-height-after to auto in the theme.

Set the docimagesdir attribute when attribute substitutions are applied to a value from the theme.

Start page numbering and running content on empty verso page before first chapter of prepress book if start-at value is 0.

Don’t force a page break after a TOC with automatic placement in an article if the title-page attribute is set and the value of toc-break-after theme key is auto.

Add --theme option to CLI as shorthand for -a pdf-theme.

Add --sourcemap option to CLI to enable :sourcemap option.

Broaden support for relative font sizes in the theme to more than just inline elements.

Allow the theme to control the font properties of ordered list markers using the olist-marker category.

Allow the theme to control the font style of unordered list markers per marker or all markers.

Always set the imagesdir attribute to the value of themesdir when resolving images from theme.

Allow the top keys in the title-page theme category to accept a fixed value (e.g., 1in).

Prevent orphan detection for headings (section title or discrete heading) from modifying the document state.

Configure table borders to be compatible with prawn-table > 0.2.2.

Don’t coerce a font size < 1 to a relative font size; relative font size should be specified in units.

See What’s New in Asciidoctor PDF 2.1 to learn about the improvements added in Asciidoctor PDF 2.1.

Refer to What’s New in Asciidoctor PDF 2.0 to learn about the new features, improvements, and fixes introduced in 2.0.