This is a significant patch release in the 2.3.x release line to address compatibility with Ruby 3.3 and Ruby 3.4, fix numerous bugs, and provide some welcomed improvements.
This release suppresses the warning issued by Ruby 3.3 and 3.4 about the use of Ruby's logger gem when loading Asciidoctor. It also fixes a crash when Asciidoctor PDF attempts to preload the bigdecimal gem when using Ruby 3.4.
This release include numerous bug fixes. If the font is missing the NULL character, the converter will ensure no space is allocated for it. If a resolved attribute value in the running content contains an attribute reference (recursive), the converter will not drop that line. If a bordered or shaded block gets carried over to the next column on the first page of a document that uses page columns, the block's extent will be computed correctly. If the link on an image targets an (internal) anchor, that link will resolve properly.
In terms of improvements, the big one is that a horizontal dlist is now rendered without the use of prawn-table, which means the description for an entry may exceed the height of a single page. This release also bundles the glyphs for the shift, command, option and return keys to the fallback font. The font size for sub and sup can now be set independently of one another using an extended converter. The value of the minimum font size keys in the theme accept a relative value (e.g., 0.75em). When generating a print or prepress PDF, the hide-uri-scheme attribute is honored when appending the URL to the link text.
Distribution
Changelog
Improvements
- add symbols for shift, command, option, and return keys to the fallback font
- render horizontal dlist without using prawn-table, allowing the description to exceed the height of one page (#2591)
- allow relative font size for sub and sup to be set independently (support combined setting for backwards compatibility)
- allow value of
base-font-size-minand<category>-font-size-mintheme keys to be relative (e.g., 0.75em) (#2547) - respect
hide-uri-schemeattribute when appending URL to link text when media is print or prepress (#2583)
Bug Fixes
- always force NULL character to have 0 width, even if missing from font (#2585)
- don't drop line in running content if attribute reference resolves to text that contains attribute reference (not originally present)
- correctly calculate extent for block in columns that starts below doctitle (#2579)
- support internal link on image (value of link attribute starts with #) (#2572)
Compliance
- suppress warning about the use of Ruby's logger gem when loading Asciidoctor
- ignore error if bigdecimal gem cannot be eagerly required
Release meta
Released on: 2025-09-16
Released by: @mojavelinux
Release beer: Oktoberfest by Athletic Brewing
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.