This is a minor release in the Asciidoctor PDF 2 release line. This release builds on numerous enhancements that were introduced in Asciidoctor PDF 2.

It's now possible to specify a background image per layout by using the {page-layout} attribute reference in the path. You can configure the page margins for rotated pages separately using the page-margin-rotated theme key or pdf-page-margin-rotated document attribute. Inside the theme, you can reference the resolved value of the imagesdir attribute from the document using the {docimagesdir} attribute reference. Instead of having to add the breakable option to all headings to get orphan detection, you can enable it globally in the theme by setting the heading-min-height-after key to the value auto. The theme now accepts a relative font size (e.g., 0.75em) almost anywhere a font size can be set. The font properties of the mark for ordered lists can now be controlled using the olist-marker category. The asciidoctor-pdf CLI now accepts two new options. You can pass --sourcemap to enable the :sourcemap option on the processor for tracking warnings down to the line number. You can use the --theme option as an alternative to -a pdf-theme= to save some typing.

During the development of this release, numerous bugs were founds and fixed. And the documentation conntinues to be improved.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• allow page background image to be specified per layout using +{page-layout}+ attribute reference in path (#1739)
• allow page margin for rotated page to be configured independently using page-margin-rotated theme key or pdf-page-margin-rotated document attribute (#1719)
• allow orphan detection to be enabled for all section titles and discrete headings by setting heading-min-height-after to auto in theme (#2268)
• set docimagesdir attribute when attribute substitutions are applied to value from theme (#2278)
• start page numbering and running content on empty verso page before first chapter of prepress book if start-at value is 0 (#2252)
• don't force page break after TOC with automatic placement in article if title-page attribute is set and value of toc-break-after theme key is auto (#1768)
• add --theme option to CLI as shorthand for -a pdf-theme (#2250)
• add --sourcemap option to CLI to enable :sourcemap option on processor (#2265)
• broaden support for relative font sizes in theme to more than just inline elements; document support for relative font sizes
• allow theme to control font properties of marker for ordered list using olist-marker category (#2279)
• allow theme to control font style of marker (per marker or all markers) for unordered list

Improvements

• add internal Document#attr_unspecified? method to simplify check for an attribute which has not been set or unset

Bug Fixes

• always set imagesdir attribute to value of themesdir when resolving images from theme
• allow top keys in title-page theme category to accept a fixed value (e.g., 1in) (#2269)
• prevent orphan detection for heading (section title or discrete heading) from modifying document state (#2288)

Compliance

• configure table borders in way that is compatible with prawn-table > 0.2.2
• don't coerce font size < 1 to relative font size; relative font size should be specified in units

Release meta

Released on: 2022-07-22
Released by: @mojavelinux
Release beer: Superfood Swell by Athletic Brewing Company

Logs: resolved issues | full diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.