asciidoctor/asciidoctor-pdf v1.5.0.rc.1

v1.5.0 RC 1

on GitHub

Summary

Asciidoctor PDF is finally moving into the final stage of the first stable release with this first release candidate! It does so having over 900 tests and a small pile of enhancements since the last beta.

Before getting into the fun stuff, the most recent release of ttfunk (1.6.0) broke Asciidoctor PDF. It turns out our patch was obsolete anyway, so just removing the patch solved the issue. But this new version has an outstanding issue with font subsetting, so we've decided to lock the version of ttfunk to 1.5.x for this release. The asciidoctor-pdf-optimize bin script has also been fixed so it doesn't crash due to a missing library.

Probably the two most exciting enhancements in this release are the ability to start the page numbering and/or running content on an arbitrary page of the body (using the start_at key with an integer value) and line highlighting in source blocks (when using Rouge or Pygments and the highlight block attribute is set). On the topic of source blocks, if the lines of a source block wrap when line numbering is enabled, the wrapped lines will start after the line number gutter.

Other enhancements include support for data URI when the image format is SVG, ignoring case when sorting index terms, section title partitioning if the title-separator document attribute or the separator block attribute is set, support for writing the output to stdout, support for the unbreakable option on open blocks (thanks @Mogztter!), and the ability to control the toclevels per section (including being able to exclude the current section from the toc). Note that the converter will no longer apply the recto margin to the title page when media=prepress if cover is absent unless value of front-cover-image attribute is ~. The mailto: prefix is no longer added to visible mailto URI if hide-uri-scheme is set.

The theming system picked up several nice enhancements in this release. The theme can now set the base text decoration width, the font kerning per category, a background image for running content, a border on admonition, quote, and verse blocks, and both the alignment and width of the image caption can be set to inherit from the image. If a block image has a percentage width, that width is now honored. An inline image can be configured to fit the height of the line by setting fit=line. And a custom inline role can now control the text transform. You might also notice that the border offset now expands the width of an inline element so the border doesn't run into surrounding text.

This release also includes a number of minor bug fixes. Consult the CHANGELOG to find the complete list of changes.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

• support data URI for SVG image (#1423)
• account for border offset in width of fragment (#1264)
• ignore case when sorting index terms (#1405)
• partition section title (title and subtitle) if title-separator document attribute or separator block attribute is set (#623)
• allow page numbering to start after first page of body by assigning an integer to the page_numbering_start_at theme key (#560)
• allow running content to start after first page of body by assigning an integer to the running_content_start_at theme key (#1455)
• allow output file to be written to stdout (#1411)
• implement line highlighting for source blocks when using Rouge as source highlighter (#681)
• implement line highlighting for source blocks when using Pygments as source highlighter (#1444)
• indent wrapped lines in source block beyond linenum gutter (#504)
• don't mangle source block if linenums are enabled and language is not set
• don't print line number if source block is empty
• don't apply recto margin to title page if cover is absent unless value of front-cover-image attribute is ~ (#793)
• expose theme as property on converter
• add support for unbreakable option on open blocks (#1407) @Mogztter
• don't add mailto: prefix to revealed mailto URI when hide-uri-scheme is set (#920)
• allow theme to set base text decoration width (#1414)
• allow theme to set font-kerning per category (#1431)
• allow theme to specify background image for running content (#356)
• allow theme to specify border for admonition block (#444)
• allow theme to specify background color for admonition block (#444)
• allow theme to specify background color and full border for quote and verse blocks (#1309)
• allow text alignment roles to be used to control alignment of discrete heading
• allow theme to configure image caption align(ment) to inherit from image align(ment) (#1459)
• allow theme to confine width of image caption to width of image (#1291)
• don't apply border to block if border width is not set (or nil)
• use font color from pygments style for unhighlighted text (#1441)
• render stem block as raw literal block
• render stem phrase as monospaced text
• honor percentage unit on width attribute value on image (#1402)
• fix crash when capitalizing text that does not contain markup
• allow custom inline role to control text transform (#1379)
• convert link macro enclosed in smart quotes
• allow inline image to be fit within line using fit=line (#711)
• fix fit=cover for background image when aspect ratio of image is taller than page (#1430)
• compute and apply line metrics for cells in table head row (#1436)
• compute and apply line metrics correctly for cells in table body and foot rows (#1436)
• allow section to override toclevels for self and children using toclevels attribute on section (#734)
• allocate space for pagenum in toc consistently (#1434)
• fall back to default theme instead of crashing if specified theme cannot be resolved
• allow font color to be set on nested span in passthrough content
• move width and align attributes from font tag to width and align style properties on span tag
• compute table cell padding correctly when specified as a 4 element array
• preserve isolated callout on final line of source block
• fix missing require in asciidoctor-pdf-optimize script (#1467)
• lock version of ttfunk to 1.5.x

Release meta

Released on: 2019-12-06
Released by: @mojavelinux
Release beer: Pink Boats DIPA by Burly 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.