v2.0.0 Beta 1

The march is on towards the 2.0.0 release! We've determined that converter's behavior and APIs are now stable for this major release. The focus now turns towards fixing bugs, compatibility issues, and minor features that don't introduce breaking changes or deprecations.

Notable new features in this release include a new document attribute (index-pagenum-sequence-style) to control the style of page sequences in the index, a new document attribute (outline-title) to control the text and appearance of the title in the PDF outline, a new API method to control which elements are enlisted in the TOC and the corresponding logic to support non-sections, support for the smallcaps text transform (e.g., Sᴍᴀʟʟ Cᴀᴘᴛɪᴀʟ Lᴇᴛᴛᴇʀs) and updates to the bundled fonts to support those glyphs, and the ability to control the color of all borders using the base-border-color key when extending the base theme. In the theme, the caption-end key was added to the image category and the caption-side key on the table category was renamed to caption-end to be consistent.

During this development cycle, the new docs for Asciidoctor PDF continued to be improved and reorganized. Along with lots of updates to the theming guide, they include a new page that covers a variety of use cases that can be addressed using an extended converter. The new docs will now go live on https://docs.asciidoctor.org in conjunction with this release.

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.

May the 4th be with you! 🤺

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• introduce index-pagenum-sequence-style document attribute to control style of sequential page numbers in index when media=screen (#1656)
• allow entry for document in outline to be controlled using outline-title attribute (#1789)
• allow extended converter to insert or filter toc entries by overriding get_entries_for_toc method (#2097)
• add asciidoctor/pdf/nopngmagick script to unregister Gmagick handler for PNG images only (#1687)
• allow theme to configure which end the caption is placed for a block image (#2115)
• add Page#imported method to mark page as imported (which suppresses running contennt)
• add support for smallcaps text transform by replacing lowercase letters with small capital variants (#1192)
• use base-border-color as default border color; control appearance of border using border-width value alone (#2134)
• remove border colors in base theme so all border colors can be controlled using base-border-color when extending theme
• enable running footer when using base theme

Bug Fixes

• allow border width of block image to be specified as an array (1, 2, or 4 values) (#2119)
• rename delete_page extension method to delete_current_page to avoid conflict with incompatible method on Prawn::Document
• remap table-caption-side theme key to table-caption-end (#2125)
• add missing glyph for ÿ in built-in fonts
• remove use of deprecated keys in chronicles-dark-theme.yml

Release meta

Released on: 2022-05-04
Released by: @mojavelinux
Release beer: In the Steep by Outer Range 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.