github asciidoctor/asciidoctor v2.0.12


This is a minor patch release that fixes some regressions that were introduced during the long release cycle of 2.0.11. We strongly recommend upgrading to this version instead of using 2.0.11.

Notable changes include restoring the type and target on unresolved footnotes (so they display properly), fixing a crash when an extension set a numeric width or height on an SVG image when using opts=inline, resetting the word wrap behavior to normal on tables to avoid aggressive word breaks, reverting the use of a Ruby 2.3 construct that prevented Asciidoctor from working on CentOS, including the role on an inline image in the DocBook output, and passing through the explicit width and height values on an SVG image as is when using opts=inline.

Please note that it will not be possible to use Asciidoctor on Ruby < 2.3 after the 2.0.x release line. Those versions are already unsupported. However, since we had not yet made a change that prevented them from working, we'll wait until 2.1.x to do so.

During this release, all the CI jobs were migrated from Travis CI to GitHub Actions. We also added a CI job to run the test suite on macOS.

As usual, consult the CHANGELOG for all the details.


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: 2020-11-10
Released by: @mojavelinux
Release beer: For the Animals: Imperial Breakfast by Alternation Brewing Company

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


Bug Fixes

  • Set type and target property on unresolved footnote reference and unset id property (fixes regression) (#3825)
  • Fix crash when inlining an SVG if the explicit width or height value on the image node is not a string (#3829)
  • Reset word wrap behavior to normal on tables, then reenable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)


  • Pass through role to DocBook output for inline image (#3832)


  • Defer use of Ruby >= 2.3 constructs to restore compatibility with Ruby 2.0 until at least next minor release (#3827)
  • Don't append the default px unit identifier to the explicit width or height value when inlining an SVG (#3829)

Build / Infrastructure

  • Migrate Linux CI jobs to GitHub Actions (#3837)
  • Migrate Windows CI jobs to GitHub Actions (#3839)
  • Run CI job on macOS (#3842)


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.

latest releases: v2.0.16, v2.0.15, v2.0.14...
10 months ago