This release was mostly about improving consistency and compatibility as we near the Asciidoctor 2.0.0 release.
The main new feature is support for setting a border and padding per heading level, including the document title of an article. Implementing this feature meant adding support for setting the border width and padding independently on all edges of a block and capping the border corners. Any time a padding or margin value can be specified in the theme using an array value, the 2- and 3-value forms are now accepted. To help with the transition to Asciidoctor PDF 2.0.0, bottom padding hacks detected in an older theme are automatically neutralize to retain the same appearance to the degree possible. The top and bottom padding on quote and verse blocks is now uniform in the default theme, and tighter in the base theme. The default border and grid color and width for tables has been updated to match the behavior of the previous stable release. As usual, consult the CHANGELOG for a more detailed view of what has changed.
During this development cycle, the new docs for Asciidoctor PDF continued to be improved and reorganized thanks to the work by Sarah. The new docs will go live on https://docs.asciidoctor.org at the same time Asciidoctor PDF 2.0.0 is released.
To reiterate, we don't anticipate having many alpha releases or a long prerelease cycle. We're going to give users a chance to try this release so we can uncover any unexpected regressions, errors, or problem areas. If they come up, we will try to address them quickly so that we can turn around a final release very soon.
Distribution
Changelog
Enhancements
- allow border width of block to be specified per edge using 4-value array (#2102)
- allow padding on block to be specified using 2-value array for ends and sides or 3-value array with implied left side value (#2104)
- allow margins in running content to be specified using 2-value array for ends and sides or 3-value array with implied left side value (#2104)
- allow theme to set border and padding on headings per level (#434)
Improvements
- reduce top and bottom padding on quote and verse blocks in base theme
- use uniform top and bottom padding on quote blocks in default theme
- change
inscribe_method prefix in converter toink_
Bug Fixes
- allow
ink_tocmethod in extended converter to insert page above TOC page - remap
layout_methods contributed to converter by prepended module - neutralize padding hacks in themes designed before the converter had smart margins
- allow smallest ends or sides border width on block to be less than 1
- cap border corners on block when width is defined using array (uniform or otherwise) (#2103)
- fix crash in certain circumstances when theme does not define value for
base-border-widthkey - use sensible fallbacks for table border and grid color and width (retains backwards compatibility)
Release meta
Released on: 2022-05-30
Released by: @mojavelinux
Release beer: Proper Pour by Boulevard Brewing
Logs: resolved issues | full diff
Credits
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign who provided critical funding for the development of this release as well as ongoing development of the project.