v2.3.9

This is a patch release in the 2.3.x release line that fixes alignment of image blocks in the multi-column layout and preserves the bottom end placement of the caption on a table when the unbreakable or breakable option is set.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• correctly align block image in raster format in column when align is right or center and page columns are enabled (#2433)
• honor table caption end placement (table-caption-end theme key) when unbreakable (or breakable) option is set on table (#2434)

Release meta

Released on: 2023-06-28
Released by: @mojavelinux
Release beer: Pappy Legma by Goat Patch Brewing Company

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.8

This is a patch release in the 2.3.x release line that fixes a compatibility issue with Ruby 3.2 when using the optimizer, fixes invisible text in the outline in some PDF readers when the heading contains an index term, and fixes the size of inline images in normal table cells when using certain custom fonts.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• do not attempt to fit inline image in normal table cell to computed height of cell (#2428)
• support fit=none attribute on inline image to prevent image from being scaled down to fit available height (#2428)

Bug Fixes

• remove null character enclosed in XML tag when sanitizing text; fixes invisible text in outline when heading contains index term (#2430)
• alias File.exists? to File.exist? when loading RGhost optimizer to patch incompatibility when using Ruby 3.2

Build / Infrastructure

• bump upper Ruby version from 3.1 to 3.2 in CI workflow

Release meta

Released on: 2023-06-24
Released by: @mojavelinux
Release beer: Lost by New Terrain Brewing Company

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.7

This is a patch release in the 2.3.x release line that fixes a path bug when running on JRuby for Windows and fixes a crash when subs is set on an empty code block.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• don't crash if source block with custom subs is empty and source highlighter is enabled
• add workaround for JRuby on Windows when value of imagesdir attribute is absolute and contains non-ASCII characters

Release meta

Released on: 2023-04-15
Released by: @mojavelinux
Release beer: The Waldos’ Triple IPA by Lagunitas Brewing Co

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.6

This is a patch release in the 2.3.x release line that works around a bug in JRuby 9.4.2.0. The converter will correctly recognize uri:classloader: as an absolute path prefix and process it accordingly.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• rework File.absolute_path? patch so it returns correct response when running on JRuby

Release meta

Released on: 2023-04-09
Released by: @mojavelinux
Release beer: Thunder Thiolz by Platt Park Brewing

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.5

This is a patch release in the 2.3.x release line that fixes numerous bugs and regressions that were lingering since the 2.0.0 release.

All footnotes inside AsciiDoc table cells are collected and included in the footnotes list at the bottom of the chapter or article. If a section follows an empty index, that section is no longer dropped. The bottom margin on a table with the breakable or unbreakable option, as well as theme setting for the caption on a table with the same properties, are preserved. The start-at theme value after-toc for page numbering and running content correctly references the first recto page following the TOC when media=prepress. A new theme key callout-list-marker-font-color has been introduced to independently control the color of the conum marker in a callout list (primarily intended to resolve a contrast problem in dark themes).

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• add callout-list-marker-font-color theme key to control color of conum marker in callout list (#2402)

Bug Fixes

• catalog all footnotes found inside AsciiDoc table cells and render them in the footnotes list (#2410)
• do not drop section that follows empty index (#2368)
• restore bottom margin on table with breakable or unbreakable option (#2379)
• honor theme settings for caption on table with breakable or unbreakable option (#2379)
• use first recto page after toc when media is prepress and page numbering or running content start-at value is after-toc (#2398)

Release meta

Released on: 2023-03-31
Released by: @mojavelinux
Release beer: Knight of the Trender by Grandma's House

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.4

This is a patch release in the 2.3.x release line that fixes an incompatiblity with Asciidoctor 2.0.10 (for users of Ubuntu 20.04) and resolves attribute references in the target of an inline image in running content when the value is an image macro.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• resolve attribute references in target of image in running content (#2361)
• replace use of AbstractNode#role= method to ensure compatiblity with minimum supported version of Asciidoctor (Asciidoctor 2.0.10) (#2363)

Release meta

Released on: 2022-10-28
Released by: @mojavelinux
Release beer: Pumking by Southern Tier Brewing Company

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.3

This is a patch release in the 2.3.x release line that addresses a regression in Ghostscript that affected the built-in optimizer. The optimizer will now pass -dNEWPDF=false to force Ghostscript to use the old PDF interpretter. This release also addresses a crash when the TOC is enabled and a section ends with a hard line break.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• fix crash if last fragment in TOC entry is not rendered (#2354)
• pass -dNEWPDF=false to Ghostscript when optimizing PDF so it does not break internal links (#2355)

Release meta

Released on: 2022-10-20
Released by: @mojavelinux
Release beer: Warlock by Southern Tier Brewing Co.

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.2

This is a patch release in the 2.3.x release line that addresses an incomplete fix for an issue in 2.3.1. The fallback value for the base-font-size is now set before processing the keys, and a fallback value for the base-font-family key has been set.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• provide fallback value for base-font-size theme key before processing keys (#2342)

Release meta

Released on: 2022-09-17
Released by: @mojavelinux
Release beer: Personal Record by Athletic Brewing Co.

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.1

This is a patch release in the 2.3.x release line that includes backports of bug fixes from the upcoming 3.0.x release line.

This release restores the fallback value for the base-font-size theme key for cases when a custom theme does not extend another theme. The converter no longer crashes when the smallcaps text transform is applied to a phrase using a role. The part and chapter signifiers are not added if their respective attributes are unset. The heading border is drawn if the heading is advanced to the next page. Text is justified correctly if the first line of the abstract ends with a hard break.

The 3.0.0 release is just around the corner.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• provide a fallback value for base-font-size when loading theme (#2343)

Bug Fixes

• fix crash when smallcaps text transform is applied to a phrase (#2339)
• don't add chapter signifier if chapter-signifier is unset (#2328)
• don't add part signifier if part-signifier is unset (#2328)
• don't include bottom margin when computing heading height if heading-min-height-after theme key is empty (#2326)
• draw border on heading (section title or discrete heading) if it is advanced to next page (#2322)
• arrange heading even if section is empty
• ensure heading-min-height-after theme key is ignored if section is empty or discrete heading is last child
• don't force justify first line of abstract if it ends with a hard break

Release meta

Released on: 2022-09-17
Released by: @mojavelinux
Release beer: Personal Record by Athletic Brewing Co.

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.

v2.3.0

This is a minor release in the Asciidoctor PDF 2 release line. This release includes several enhancements and bug fixes.

Enhancements. If you set the media to print or prepress, and you don't specify a theme, Asciidoctor PDF will now use the built-in default-for-print theme by default. This change makes it easier for users to get print-optimized output by default and raises awareness about the existence and function of this theme. If you want to force a page break, you can now add [%always] above the page break macro. If you producing a multi-column layout (e.g., page-columns is > 1), the page break macro will create a new page by default. If you want to start a new column, add the column role to the page break macro. If you want to place footnotes (aka endnotes) directly below the last block of content, set the footnotes-margin-top key to 0 (or another fixed value) in your theme. If you use the big and small roles, the text will be scaled relative to the font size of the surrounding text, even when used in headings. The converter now recognizes the text alignment roles (e.g., .text-center) on all styled paragraphs and verse blocks.

Bug fixes. Some users prefer to add additional markup to code blocks to emphasize tokens. When the source highlighter is enabled, Asciidoctor PDF does not support this extra markup. However, rather than printing it verbatim, the converter will now strip it away to maintain the integrity of the code in the code block. If a footnote label falls at the end of a line, it will no longer be split or widowed. Instead, it will stay together and with the preceding adjacent text, pulling that the last word to the next line if necessary. If the prose-margin-inner and/or prose-text-indent-inner theme keys are set, these are now honored on inner paragraphs in the abstract. If the prose-text-indent key is set in the theme, it will only be applied to elements that have a left-oriented alignment (left or justify). The computed height of headings and captions for orphan prevention now takes into account all text formatting, making the behavior more accurate.

During this release cycle, numerous improvements were made to the documentation as well.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• place footnotes directly below last block of content if footnotes-margin-top theme key is 0 (#2291)
• allow page / column break to be forced using always option (e.g., [%always]) (#2300)
• insert column break instead of page break in multi-column layout if column role is specified on page break macro (#2293)
• use relative font size for big and small roles (#2307)
• use default-for-print theme by default if media is print or prepress (#2306)
• support text alignment roles on all styled paragraphs
• support text alignment roles on verse block

Bug Fixes

• only indent text that starts at left margin (i.e., when text align is left or justify) (#2298)
• apply text transform and formatting when checking height of heading for orphan prevention
• apply text transform and formatting when computing height of background for caption
• honor theme settings (prose-margin-inner and prose-text-indent-inner) for inner paragraphs in abstract
• prevent footnote label from being split across lines (#2297)
• keep footnote label with preceding text if adjacent (#2297)
• strip formatting added to source block by custom subs when syntax highlighter is enabled (#2086)

Compliance

• remove support for deprecated spread role on table

Release meta

Released on: 2022-08-16
Released by: @mojavelinux
Release beer: Late To The Kettle IPA by Athletic Brewing Co.

Logs: resolved issues | source diff | gem diff

Credits

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.