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

v1.5.0 Beta 8

on GitHub

Summary

We made a breakthrough and finally integrated automatic hyphenation into this converter. Therefore, we decided it best to put out a beta release to get some feedback on it before moving forward with a stable release. If the feedback is good, we'll proceed with the first release candidate next. Here's what changed to get us closer to that release:

If the text-hyphen gem is installed, and you've set the hyphens attribute on the document, Asciidoctor PDF will automatically hyphenate prose based according to the language rules. The hyphenation language is determined either by the value of the hyphens attribute (default en_us) or the value of the lang attribute, if set. And another fun feature, you can now set the width and color of the text decoration. And both the underline and line-through built-in roles can be customized using the theme. You can force the PDF document to start in fullscreen mode by setting the pdf-page-mode attribute or page_mode theme key to fullscreen. A hanging indent is applied to wrapped entries in both the toc and index. If you place the toc manually using the toc macro, the toc will appear in the outline in the same location in the document. A regression which caused the AsciiDoc table cell to overflow the bounds of the table and create an extra page has been fixed. The cjk breaks behavior now extend to table cells. XML special characters in a literal table cell are no longer double escaped. Finally, you can now use the theme to customize the content of the author line on the title page.

And we should probably mention that the converter now has 800 tests. 🎉

Consult the CHANGELOG to find the complete list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• automatically hyphenate prose using the text-hyphen gem if the hyphens document attribute is set (#20)
• set hyphenation language using the hyphens attribute value, falling back to the lang attribute (#20)
• add support for capitalize text transform (#1382)
• fix AsciiDoc table cell from overflowing bounds of table and creating extra page (#1369)
• don't double escape XML special characters in literal table cell (#1370)
• allow theme to customize the width and color of text decoration (underline and line-through) (#812)
• use same line height throughout abstract
• don't mangle XML attribute values when applying lowercase text transform (#1391)
• place toc at same position in outline as it is in the document (#1361)
• log warning with error message if remote image cannot be retrieved
• allow initial page mode to be set to fullscreen using pdf-page-mode=fullscreen attribute or page_mode=fullscreen theme key (#1357)
• allow theme to configure content of entries in authors line on title page (#800)
• allow theme to override styles of caption on admonition blocks (#561)
• allow theme to configure hanging indent for titles in toc (#1153)
• apply hanging indent to wrapped entries in index (#645)
• allow theme to configure text decoration of headings (#811)
• define line-through and underline roles as built-in custom roles so they can be customized (#1393)
• allow top value of logo and title on title page to be specified in any measurement unit
• don't set a top value for the logo on the title page if not set in theme
• if value of scripts attribute is cjk, break lines between any two CJK characters except punctuation in table cells (#1359) (@Gasol)
• ignore invalid cellbgcolor value (#1396)
• recommend installing prawn-gmagick gem if image format is unsupported
• set cache_images option on SVG interface if cache-uri attribute is set on document (#223)
• upgrade prawn-svg to fix display of links in plantuml diagrams (#1105)
• allow icon set to be specified as prefix on target of icon macro (#1365)
• write Unix epoch dates to pdfmark file in UTC when reproducible is set
• don't include software versions in PDF info if reproducible attribute is set
• fix optimizer so it applies pdfmark after reading input file
• allow converter instance to be reused

Release meta

Released on: 2019-11-23
Released by: @mojavelinux
Release beer: The Night Is Dark And Full of Hops by Peak View 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.