v2.1.0

We did it! We got beyond the Asciidoctor PDF 2.0 release. This is the first minor release in the Asciidoctor PDF 2 release line. This release introduces the long-awaited support for multiple columns on the document body, which is activated using the page-columns theme key. This version also brings support for scaling images relative to the intrinsic width using either the scale attribute or the pdfwidth attribute expressed using a value with the iw unit. Support for text formatting on the index term is honored when the term is displayed in the index. You can avoid a page break between the part and its first chapter by setting the heading-part-break-after theme key to avoid. Finally, a bibliography entry now includes a backlink to the first reference to it in the body of the document.

During the development of this release, numerous bugs were founds and fixed, which have all been backported to the 2.0.x branch and included in the 2.0.8 release.

Don't forget that there are loads of examples of how to extend the converter to customize it to suit your specific publishing needs. See https://docs.asciidoctor.org/pdf-converter/latest/extend/use-cases/

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• arrange body of article or manpage doctype into multiple columns if page-columns key is set in theme (#327)
• allow column gap to be specified using page-column-gap key (#327)
• introduce convert_index_categories method to handle rendering of categories for index inside column box (#327)
• rename convert_index_list method to convert_index_term to make its purpose more clear (#327)
• add save_theme helper to work with a copy of the theme within a scope (#2196)
• add support for scale attribute or iw unit on pdfwidth attribute on image macros (#1933)
• add backlink from bibref on bibliography entry to first reference to that entry in the document (#1737)
• preserve text formatting on index term in index section (#897)
• don't insert page break between part and first chapter if heading-part-break-after key in theme is avoid (#1795)

Release meta

Released on: 2022-06-10
Released by: @mojavelinux
Release beer: Atomic Torpedo by Sierra Nevada Brewing Co.

Logs: resolved issues | full 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.