asciidoctor/asciidoctor-pdf v2.0.0.rc.1

v2.0.0 RC 1

on GitHub

As we rounded up the issues and polished the documentation in preparation for the 2.0.0 release, we were able to squeeze in a few more enhancements, improvements, and bug fixes. We're more confident than ever that we're ready for a final release, which is why this release has been labeled as the release candidate.

The main enhancement is that it's now possible to position the caption for code and example blocks on the bottom end (below the block) using the theme. You can also use the theme to turn on text hyphenation. In an effort to organize the code, we've sorted the methods in the converter and marked which methods are private. This will give you more confidence when writing an extended converter. We've added a whole bunch of examples of extended converters to the docs. On the bug fix front, we finally fixed a long-standing issue that the top padding of line height was not being applied to the first line on the page when content is split across pages. We also addressed a few edge cases, like removing the image border on the title page logo, not leaving behind an entry for an empty notitle section at the bottom of the TOC and outline, and looking for the correct alignment role names on a block image. Since the focus of this release was largely on documentation, there have been a bunch of additions and improvements there as well.

The final 2.0.0 will follow this release shortly.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• allow theme to position caption for code and example blocks below block using caption-end key (#1730)
• allow hyphenation to be turned on and configured using the base-hyphens key in the theme (#2161)
• replace docdir attribute reference in value of pdf-themesdir and pdf-fontsdir attributes (if not already replaced) (#412)
• split out start_title_page method from ink_title_page to make customization of the title page simpler using an extended converter
• introduce start_toc_page method to handle positioning cursor at first page of TOC

Improvements

• reclassify and mark which methods in the converter are private
• organize methods in converter
• add DOM traversal methods to simplify the logic in the converter
• remove requirement to add dummy text to title page to preserve it

Bug Fixes

• apply top line height padding to first line of text when text runs to top of next page (#2173)
• don't add entry to outline for notitle section if no content follows it
• don't add entry to TOC for notitle section if no content follows it
• look for block align roles on image instead of text align roles (#2176)
• use correct left value when creating bounding box
• don't apply border on block images to logo image on title page

Release meta

Released on: 2022-05-17
Released by: @mojavelinux
Release beer: Strata-Ford IPA by Athletic 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.