asciidoctor/asciidoctor-pdf v2.0.0.beta.2

v2.0.0 Beta 2

on GitHub

We received a lot of great feedback from the first beta that led to nearly a dozen bug fixes. While wrapping up documentation tasks for the 2.0.0, we had a breakthrough with wrapping...

Thanks to numerous changes and improvements to the code leading up to the 2.0.0 release, we determined it was easier to support image floats than to document how to patch them in. Thus, we're thrilled to announce that this release supports wrapping paragraph text around a floating image (a block image with the float attribute set)!

As part of that change, we updated the converter to coerce the image caption to automatically fit within the bounds of the image if the float attribute is set. Other types of blocks can be enlisted in float wrapping using an extended converter, which is now documented. We also added orphan checking to discrete headings, added a key to control the column gap in the index section, and added support for the text-transform property and the normal_italic font style to the first line of the abstract. The spacing around a thematic break is now controlled using padding instead of margins. The built-in theme suffix with-fallback-font has been changed to with-font-fallbacks, the sans-with-fallback-font has been renamed to default-sans-with-font-fallbacks, and there's a new default-sans theme. Finally, it's now possible to override the convert handler for listing, literal, stem, and pass blocks.

During this development cycle, the new docs for Asciidoctor PDF continued to be improved and reorganized. There's almost full coverage for the new features added in 2.0.0. Speaking of coverage, the test suite has surpassed the 2,000 test mark!

We're going to give users a chance to try this release so we can uncover any unexpected regressions, errors, or problem areas. If they come up, we will try to address them quickly so that we can turn around a final release very soon.

Distribution

• RubyGem (asciidoctor-pdf)

Changelog

Enhancements

• add support for float attribute on image; wrap ensuing paragraphs around image with float attribute (#353)
• add supports_float_wrapping? method for extended converter to override to enlist other blocks in float wrapping; add example to docs (#353)
• add image-float-gap key to theme to control space around image float (#353)
• add support for text-transform property on first line of abstract in theme (#2141)
• rename resolve_alignment_from_role to resolve_text_align_from_role to reflect proper terminology and purpose; alias old method name
• add support for orphan avoidance to discrete headings to match behavior of section titles (using call to arrange_heading) (#2151)
• rename arrange_section to arrange_heading to reflect proper terminology and purpose
• add index-column-gap key to theme to control size of gap between columns
• coerce image-caption-max-width to fit-content if float attribute is set on block image (#2150)
• add support for text box with fixed height via :height option to typeset_text helper
• configure typeset_text and ink_prose to return remaining fragments when :height option is specified
• add support for :indent_paragraphs option to formatted text box (#353)
• if float attribute is set on block image, set max width on caption to fit-content if max width not already set to a fit-content value
• add built-in default-sans theme

Improvements

• rename theme suffix with-fallback-font to with-font-fallbacks
• rename sans-with-fallback-font theme to default-sans-with-font-fallbacks
• configure spacing around thematic break using thematic-break-padding key instead of margin top and bottom (#2164)
• rename convert_listing_or_literal to convert_code and alias old name
• reify convert handler for STEM blocks (convert_stem)
• reify convert handler for pass blocks (convert_pass) and remove block decoration

Bug Fixes

• honor caption-align when element align is not left and caption-max-width is % of element width (e.g., fit-content(50%)) (#2156)
• do not orphan sidebar title (#2158)
• allow theme to set font style of first line of abstract to normal_italic (#2138)
• add support for :color option to Prawn::Text::Formatted::Box directly and remove workarounds
• preserve columns on subsequent pages in the index section (#2149)
• fix return value of cursor method inside block for column box in index section
• correctly detect preceding code block when determining whether to collapse top margin of colist
• apply bottom margin to thematic break that falls at top of page (#2164)
• allow extended converter to override convert_code method to handle convert_listing and convert_literal calls
• restore margin below pass block
• remove use of deprecated theme keys in default-for-print theme

Release meta

Released on: 2022-05-14
Released by: @mojavelinux
Release beer: The Thistle by Iron Mule Brewery

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.