Summary

While beginning work on the 2.1.0 release, we discovered a few issues that needed to be backported to the 2.0.x line. Thus, this is a backport patch release. We also made numerous improvements to the documentation.

The most notable changes include fixing the display of the collapsible block in Safari (aligning the appearance with other browsers), getting the playlist attribute for YouTube videos working again, removing excess spacing around an empty list item, aligning the styles for the Rouge and Pygments default stylesheet, trimming the space after the line number in Pygments output, honoring stripes=none on nested tables, processing author and authors document attribute when implicit doctitle is absent, preventing line numbers on source blocks in HTML output from being selected, and removing the warning if a negated tag is not found in an include file (which is a valid scenario). For extension authors, Asciidoctor now ignores the return value of the process method for custom block or block macro if the value matches parent argument. You can also now return an AbstractBlock that's not itself a Block (such as a list or table). And thanks to an update to the open-uri-cached gem, the cache-uri attribute is now working on Ruby 3.1, and there are finally tests for that feature!

Consult the CHANGELOG to find the full list of changes in this release.

Distributions

• RubyGem (asciidoctor)

Asciidoctor is also packaged for Fedora, Debian, Ubuntu, Alpine Linux, OpenSUSE, and Homebrew. You can use the system's package manager to install the package named asciidoctor.

Release meta

Released on: 2022-01-05
Released by: @mojavelinux
Release beer: Santa's Little Helper by Port Brewing

Logs: resolved issues | full source diff | full gem diff | issues resolved in 2.0.x (cumulative)

Changelog

Bug Fixes

• Don't crash if process method for custom block returns an abstract block with context :compound that isn't of type Block (e.g., a list)
• Ignore return value of process method for custom block or block macro if value matches parent argument
• Remove unnamespaced selectors in Pygments stylesheet
• Normalize output from Pygments to use linenos class for inline line numbering and trim space after number; update default stylesheet accordingly
• Change AbstractBlock#sections? to return false when called on block that isn't a Section or Document (PR #3591) @mogztter
• Hide built-in marker on HTML summary element in Safari when using default stylesheet (#4162)
• Hide outline around HTML summary when activated in Safari (#4162)
• Include primary video in value of playlist attribute when embeddding YouTube video (#4156)
• Honor stripes=none on nested table (#4165)
• Update default stylesheet to fix spacing around empty list item (#4184)
• Honor :header_only option when parsing document with manpage doctype (#4192)
• Use numeric character reference for closing square bracket around alt text of icon
• Process author or authors document attribute in document header when implicit doctitle is absent (#4206)
• Patch open-uri-cached gem to work with Ruby 3.1 (update: drop patch now that open-uri-cached has been fixed) (#4227)

Improvements

• Prevent line numbers on source blocks in HTML output from being selected (applies to pygments and coderay) (#4128)
• Allow hash to be specified for Vimeo video either in video ID or using hash attribute (#4176)
• Remove unnecessary specificity in default stylesheet for styling p element inside list item
• Remove obsolete gist embed styles from default stylesheet
• Allow --failure-level to be set to default value, FATAL
• Sort levels in help for --failure-level option in ascending order
• Invert FR translations for caution & warning admonition labels (#4212) (cyChop)
• Add tests for open-uri-cached integration that is activated by the cache-uri attribute
• Don't warn if negated tag is not found in include file (#4230)

Documentation

• Document how to extend an existing converter or create a new converter (#4136)
• Document the syntax topic of the --help CLI option (#4175)
• Document how to uninstall the Asciidoctor gem (#4154)
• Document how to enable and use the sourcemap (the :sourcemap option)
• Document how to catalog additional assets (the :catalog_assets option)

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. We'd also like to thank the maintainers of the Rouge project, who helped us work through the compatibility issue with Rouge and applied a fix to restore it ahead of our own release.