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
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-rotatedtheme key orpdf-page-margin-rotateddocument attribute (#1719) - allow orphan detection to be enabled for all section titles and discrete headings by setting
heading-min-height-aftertoautoin theme (#2268) - set
docimagesdirattribute 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-atvalue is 0 (#2252) - don't force page break after TOC with automatic placement in article if
title-pageattribute is set and value oftoc-break-aftertheme key isauto(#1768) - add
--themeoption to CLI as shorthand for-a pdf-theme(#2250) - add
--sourcemapoption to CLI to enable:sourcemapoption 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-markercategory (#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
imagesdirattribute to value ofthemesdirwhen resolving images from theme - allow
topkeys intitle-pagetheme 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.