Summary
Continuing with the beta series, this release brings numerous bug fixes and a healthy handful of enhancements. Asciidoctor PDF now has 370 tests in its arsenal to make it resilient against bugs and regressions as changes are made to the code base. While there's always room for more tests, it's the validation we'll need to advance beyond beta.
There were several problems that were addressed (and tested) related to page creation, which can be tricky in Prawn. Thanks to these fixes, background images are now applied to the correct pages. Additionally, aligning a table will no longer mess with the margins of subsequent pages. You may have also noticed that colors containing uppercase characters were being lost, which is no longer the case. Legacy Font Awesome icons are properly mapped so you don't have to change your document despite the previous upgrade to Font Awesome 5. The pdf-themesdir attribute is ignored unless pdf-theme is also set, which will prevent the default theme from being loaded from the wrong location.
The theme gives you more control than ever before. You can specify font properties for custom roles to control formatting of phrases. And the big and small roles are supported out of the box. For keybinding and button elements, you can set a background and/or border too. You can control the character ranges used for conums. If you don't want to include the section number in the chapter and section titles in the running content, you can now set the title-style in the theme to change this behavior.
The fonts have also been updated using the provided script. The bundled monospaced font (M+ 1mn) now includes all Latin, Greek, and Cyrillic characters. And the prose font has been regenerated so that it's easier to patch in the future.
Consult the CHANGELOG for a full list of changes.
Distribution
Changelog
- only apply title page background image to the title page (#1144)
- make sure title page background or color (and only title page background or color) gets applied to title page even when page has already been created (#1144)
- fix crash when image_width is defined in theme (#995)
- fix crash when toc is enabled and toc-title attribute is unset
- correctly map legacy Font Awesome icon names when icon set is not specified (#1157)
- coerce color values in theme that contain uppercase letters (#1149)
- prevent table alignment from modifying margins of subsequent pages; only align table if width is less than bounds (#1170)
- ensure base font color is set
- use more robust mechanism to detect an empty page; tare content stream after adding page background color or image
- ignore pdf-themesdir unless pdf-theme is specified (#1167)
- allow theme to control glyphs used for conums (#133)
- allow theme to control background and border of inline kbd (#313, #1004)
- add support for link on image in running content (#1002)
- allow theme to disable font kerning
- add support for default theme alignment for tables (#1164)
- add theming support to (inline) roles on phrases (#368)
- allow theme to customize style of titles in running content (#1044)
- add support for the built-in big and small roles on phrases (#459)
- route AFM font warning through Asciidoctor logger
- upgrade code font (M+ 1mn) to TESTFLIGHT-63a
- include all alphanumeric characters in code font (mplus1mn) (#282)
- report clearer error message when theme can't be found or loaded
- document how to prepare a TTF font to work best with Asciidoctor PDF (#297)
Release meta
Released on: 2019-07-30
Released by: @mojavelinux
Release beer: Dragon's Milk Reserve Maple by New Holland Brewing Company
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.