v2.3.15

Back with another patch release in the 2.3.x line. This release was necessary to lock ttfunk to 1.7.0 since the transitive upgrade added a new requirement for installation which violates semantic versioning. This release also drops links from entries in the TOC so that they appear like all other entries and don't confuse the reader.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• drop links from entries in TOC (#2505)

Compliance

• lock ttfunk to 1.7.x to avoid requiring Ruby headers (i.e., development libraries) to install gem (#2508)

Release meta

Released on: 2024-03-11
Released by: @mojavelinux
Release beer: Star Light by Equilibrium Brewery

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.14

Another week, another round of compatibility and bug fixes. This is a patch release in the 2.3.x release line that furthers the compatibility with Ruby 3.3 and upgrades prawn-svg.

The most critical fix in this release is to remove use of the base64 library since it will no longer being provided as part of the Ruby language starting with Ruby 3.4. When using Ruby 3.3, users would see a warning if this library is used. The functionality has been replaced with a lower-level method on the String object (String#pack), which the base64 library delegates to anyway. The same issue affected prawn-svg, which required upgrading it to the latest version.

To verify these fixes, Ruby 3.3 was added to the CI workflow during this development cycle.

This release also updates the log message when an item in a horizontal dlist is truncated to include the file and line number of the description block. This information was missing because the source location information was not being passed to the table cell.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• upgrade prawn-svg to 0.34 to add support for SVG referenced by image tag (SVG in SVG)

Bug Fixes

• propagate source location to table cell for description in horizontal dlist so it is included in truncation warning message (#2502)
• eradicate use of the base64 library to fix warning about base64 gem when using Ruby >= 3.3
• upgrade prawn-svg to 0.34 to fix warning about base64 gem when using Ruby >= 3.3; apply additional patch to fix bug in prawn-svg

Build / Infrastructure

• bump upper Ruby version to 3.3 in CI workflow

Release meta

Released on: 2024-03-08
Released by: @mojavelinux
Release beer: Soft Terra by The Drowned Lands

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.13

Another week, another round of bug fixes. This is a patch release in the 2.3.x release line that fixes inconsistencies between what the documentation says and how the software behaves.

The key fix in this release is to support the toc start-at value for page numbering and running content when the toc is inserted using the toc macro. This release also fixes the page number of index entries in a prepress book when page numbering starts at or after the toc and the toc is inserted using the toc macro.

We discovered that the matcher for an isolated image macro in the content key of the running content (header or footer) was checking per line instead of across the whole string, which caused the text on other lines to be dropped in some instances. This matcher has been corrected so that all the lines are preserved.

Another case was discovered when the placeholder character for an inline image was triggering a warning about a missing character when using a fallback font.
Since this placeholder is not meant to be rendered, the code has been updated to ensure this character is skipped when analyzing the fonts for fallback font support.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• don't drop text on line above inline image macro in running content value (#2495)
• when looking for a value that only contains an image macro, match the whole string instead of per line (#2495)
• don't warn about missing character in fallback font when inline image is advanced to next page (#2492)
• support toc start at value for page numbering and running content when toc is added using macro (#2489)
• fix page number of index entries in prepress book when page numbering starts at toc or after toc and toc is inserted using macro (#2487)

Release meta

Released on: 2024-02-16
Released by: @mojavelinux
Release beer: Gnoel de Abbey by The Lost Abbey

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.12

This is a patch release in the 2.3.x release line that improves the bundled fonts and fixes an issue we thought we had licked, but came back from the dead.

The key fix of this release is to, once and for all, fix the creeping margin on pages in the index when media=prepress. If the index term fell right on a page boundary, the indentation would get reset at the page transition, which would cause the margin to shift to the left by the same amount. The indentation is now preserved so that this doesn't happen.

This release also adds the most commonly used combining characters to the bundled prose fonts, which can be used to support characters written using the decomposed normalized form (NFD) of Unicode. Most notably, this includes smallcaps letters that have a diacritical mark, such as an accent. (Note that support for the smallcaps transformation on lowercase letters containing a diacritical mark (e.g., é) will be deferred until the next major release for compatibility reasons).

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Improvements

• add combining characters to bundled fonts (#2482)

Bug Fixes

• ensure indentation is preserved at page transition of index when media=prepress; prevents margin from shifting to the left (#2480)

Release meta

Released on: 2024-02-02
Released by: @mojavelinux
Release beer: Always With Flow by Tripping Animals 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.11

This is a patch release in the 2.3.x release line that fixes a few bugs that have been lingering or discovered since the 2.0.0 release.

The key fix of this release is to define the color space on pages that have running content but no text in the main content area. This fix allows the generated PDF to be accepted by publishing platforms such as KDP and Lulu. This release also upgrades the prawn-svg dependency to 0.33 to add support for the dominant-baseline attribute in SVG (used by bytefield-svg). The smallcaps method has been extracted from the smallcaps_pcdata method in TextTransformer to make it easier to override. The table node being converted is assigned to the @node instance variable on the Prawn::Table instance so it can be accessed from the Prawn::Table#add_header method or other Prawn::Table extensions.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• upgrade prawn-svg dependency to 0.33.x (PR #2469)

Improvements

• extract shared smallcaps method from TextTransform#smallcaps_pcdata to make it easier to override
• assign node to @node instance variable on table instance to make it easer to access from Prawn::Table extension (#2471)

Bug Fixes

• ensure color spaces are set on page before adding running content (#2477)

Release meta

Released on: 2024-01-23
Released by: @mojavelinux
Release beer: Heady Topper by Alchemist Beer

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.10

This is a patch release in the 2.3.x release line that fixes a few bugs that have been lingering or discovered since the 2.0.0 release.

The highlight of this release is that an image taller than the page that's the first child of a block that itself starts at the top of the page no longer causes an empty page to be inserted. Instead, the image is resized to fit the current page. If toclevels is increased for a given section, the dot leaders will now appear in the TOC for those levels. For those using the built-in (AFM) fonts in PDF, a visible fallback character will now be used as a placeholder when a glyph is missing. And when analyzing glyphs for fallback font support in a TTF font, inherited styles are taken into account. Finally, tests have been decoupled from PWD to simplify packaging.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Bug Fixes

• show dot leaders in TOC entry if toclevels is increased for a given section (#2441)
• decouple tests from path of PWD (#2444)
• consider inherited styles when analyzing glyphs for fallback font support (#2463)
• add fallback character for placeholder character when using AFM font (#2453)
• don't advance image that's first child of block at top of page if image is taller than page (#2012)

Release meta

Released on: 2023-12-04
Released by: @mojavelinux
Release beer: Westbound Select by Westbound & Down

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.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.