This is a minor patch release in the 2.3.x release line to optimize some behavior and to fix minor annoyances.
The most notable change is that all IDs are encoded if they contain non-ASCII characters when creating PDF destinations, not just section IDs. All legacy FontAwesome 4 icon names are mapped to FontAwesome 5 names. If a section resolves to empty, it will not be included in the TOC or outline.
Distribution
Changelog
Enhancements
- add the ballot X glyphs (U+2717 and U+2718) to the code and fallback fonts (#2652)
Improvements
- suppress warning if glyph for LF cannot be found in fallback font as it's unlike to impact rendering
Bug Fixes
- properly encode all non-ASCII IDs when creating and referencing destinations in PDF (#2646) (@sandraLbdvTW)
- don't crash when creating toc for article with only an abstract section (#2649)
- use empty value for preface in running content if
preface-titleattribute is explicitly unset (#2644) - don't allow
admonition-label-min-widthkey to be less than required space to fit admonition icon - correctly map all icons from FontAwesome 4 (#2373)
- don't include children of section with empty title in TOC
- don't include children of section with empty title in outline
- when checking whether an attribute is unspecified, consider attributes that are soft set/unset from API/CLI (#2654)
- restore original require after loading treetop
Release meta
Released on: 2026-08-31
Released by: @mojavelinux
Release beer: Delerio by Delirium
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.