This is a minor release in the Asciidoctor PDF 2 release line. This release includes several enhancements and bug fixes.
Enhancements. If you set the media to print or prepress, and you don't specify a theme, Asciidoctor PDF will now use the built-in default-for-print theme by default. This change makes it easier for users to get print-optimized output by default and raises awareness about the existence and function of this theme. If you want to force a page break, you can now add [%always] above the page break macro. If you producing a multi-column layout (e.g., page-columns is > 1), the page break macro will create a new page by default. If you want to start a new column, add the column role to the page break macro. If you want to place footnotes (aka endnotes) directly below the last block of content, set the footnotes-margin-top key to 0 (or another fixed value) in your theme. If you use the big and small roles, the text will be scaled relative to the font size of the surrounding text, even when used in headings. The converter now recognizes the text alignment roles (e.g., .text-center) on all styled paragraphs and verse blocks.
Bug fixes. Some users prefer to add additional markup to code blocks to emphasize tokens. When the source highlighter is enabled, Asciidoctor PDF does not support this extra markup. However, rather than printing it verbatim, the converter will now strip it away to maintain the integrity of the code in the code block. If a footnote label falls at the end of a line, it will no longer be split or widowed. Instead, it will stay together and with the preceding adjacent text, pulling that the last word to the next line if necessary. If the prose-margin-inner and/or prose-text-indent-inner theme keys are set, these are now honored on inner paragraphs in the abstract. If the prose-text-indent key is set in the theme, it will only be applied to elements that have a left-oriented alignment (left or justify). The computed height of headings and captions for orphan prevention now takes into account all text formatting, making the behavior more accurate.
During this release cycle, numerous improvements were made to the documentation as well.
Distribution
Changelog
Enhancements
- place footnotes directly below last block of content if
footnotes-margin-toptheme key is 0 (#2291) - allow page / column break to be forced using
alwaysoption (e.g.,[%always]) (#2300) - insert column break instead of page break in multi-column layout if
columnrole is specified on page break macro (#2293) - use relative font size for big and small roles (#2307)
- use default-for-print theme by default if media is
printorprepress(#2306) - support text alignment roles on all styled paragraphs
- support text alignment roles on verse block
Bug Fixes
- only indent text that starts at left margin (i.e., when text align is left or justify) (#2298)
- apply text transform and formatting when checking height of heading for orphan prevention
- apply text transform and formatting when computing height of background for caption
- honor theme settings (
prose-margin-innerandprose-text-indent-inner) for inner paragraphs in abstract - prevent footnote label from being split across lines (#2297)
- keep footnote label with preceding text if adjacent (#2297)
- strip formatting added to source block by custom subs when syntax highlighter is enabled (#2086)
Compliance
- remove support for deprecated
spreadrole on table
Release meta
Released on: 2022-08-16
Released by: @mojavelinux
Release beer: Late To The Kettle IPA by Athletic Brewing Co.
Logs: resolved issues | source diff | gem 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.