asciidoctor/asciidoctor-pdf v1.5.0.beta.3

v1.5.0 Beta 3

on GitHub

Summary

This release marks and important next step towards the 1.5.0 release by continuing to stabilize the code (now nearing 500 tests) and introducing numerous long sought-after features.

So what are those long sought-after features? Custom fonts can be loaded from multiple directories (even combined with built-in fonts), the border is now drawn around example blocks that get split across pages, the theme can specify a border to draw around block images, the image macro can import a specific page from another PDF document, proper line breaks are implemented for text in CJK languages, the theme can control the page break before and after part and chapters, attribute references can be used in image paths in the theme file, the theme can configure a background and border on a phrase with a custom role, a role can be used to change the font color of a font-based icon, and the cellbgcolor attribute in table cells is now honored.

A number of bugs have also been addressed. Those include fixing the placement of toc in article when doctitle is not set, not dropping headings if the base font family is not set in theme, not inserting a blank page at start of document if media=prepress and document does not have a cover, converting hyphen to underscore in theme key for admonition icon type, resolving images in running content relative to themesdir, resolving icon images relative to docdir instead of the current directory, adding the missing .notdef glyph to the bundled fonts, and fixing some crashes when using the syntax highlighter.

Consult the CHANGELOG for a full list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• fill and stroke bounds of example across all pages (#362)
• allow page background color and background image to be used simultaneously (#1186)
• allow multiple font dirs to be specified (#80)
• allow theme to specifiy initial zoom (#305)
• strip surrounding whitespace from text in normal table cells
• allow attribute references to be used in image paths in theme (#588)
• honor the cellbgcolor attribute defined in a table cell to set the cell background color (#234) (mch)
• add the .notdef glyph to the bundled fonts (a box which is used as the default glyph if the font is missing a character) (#1194)
• don't drop headings if base font family is not set in theme
• don't crash if heading margins are not set in theme
• don't rely on base_line_height_length theme key in converter (should be internal to theme)
• set fallback value for base (root) font size
• reduce min font size in base theme
• allow theme to configure the minimum height required after a section title for it to stay on same page (#1210)
• convert hyphen to underscore in theme key for admonition icon type (#1217)
• always resolve images in running content relative to themesdir (instead of document) (#1183)
• fix placement of toc in article when doctitle is not set (#1240)
• honor text alignment role on abstract paragraph(s)
• don't insert blank page at start of document if media=prepress and document does not have a cover (#1181)
• insert blank page after cover if media=prepress (#1181)
• add support for stretch role on table (as preferred alias for spread) (#1225)
• include revremark on title page if specified (#1198)
• allow theme to configure border around block image (#767)
• align first block of list item with marker if primary text is blank (#1196)
• apply correct margin to list item if primary text is blank (#1196)
• allow page break before and after part and before chapter to be configured by theme (#74)
• allow page number of PDF to import to be specified using page attribute on image macro (#1202)
• use value of theme key heading-margin-page-top as top margin for heading if cursor is at top of page (#576)
• resolve icon image relative to docdir instead of current working directory
• allow theme to style mark element; add default styles to built-in themes (#1226)
• resolve variables in font catalog in theme file
• if value of scripts attribute is cjk, break lines between any two CJK characters (except punctuation) (#1206)
• add support for role to font-based icon (to change font color) (#349)
• use fallback size for admonition icon
• allow attribute reference in running content to be escaped using a backslash
• fix crash if source-highlighter attribute is defined outside the header (#1231)
• fix crash when aligning line numbers of source highlighted with Pygments (#1233)
• allow theme to configure text background and border on a phrase with a custom role (#1223)

Release meta

Released on: 2019-08-30
Released by: @mojavelinux
Release beer: Ryetribution by Halfpenny 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.