:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
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.
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)
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.
This is a big patch release that fixes a slew of issues that have been discovered from heavy usage. It's a larger release than we had planned because we're in the process of rewriting the docs and have been holding minor releases until the docs were merged. Unfortunately, that has taken longer than expected. But we're nearly there. In the meantime, we're putting out this patch release to publish the fixes that have accumulated in the meantime.
Notable changes include fixing two infinite loop scenarios, applying text formatting to cells in the implicit table head row when the column has the "a" or "l" style, restoring compatibility with Rouge >= 3.4 (by defining entry point API methods as class methods instead of module functions), fix bottom margin collapsing on an AsciiDoc table cell, removing excess hard line breaks in multi-line AsciiMath blocks, preserving repeating blackslashes in manpage output, move style tags for syntax highlighters into head of HTML output, for wrapping to avoid overflow in HTML output, fix cell borders for colspan or rowspan cells when frame and grid attribute values are congruent, and allow the encoding of the include file to be specified using the encoding attribute.
Oh, and the API docs on rubydoc.info are working once again! https://www.rubydoc.info/gems/asciidoctor/
As usual, consult the CHANGELOG for all the gory details. :jack_o_lantern:
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.
Released on: 2020-11-02 Released by: @mojavelinux Release beer: Chimay Blue
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
code
elements (#3761)stylesheets
attribute contains a folder and the destination directory for the stylesheet does not exist (even when the :mkdirs
option is set) (#3808)copycss
attribute is not a string (#3592)word-wrap: anywhere
) to body in default stylesheet (#3544)nobreak
and nowrap
roles to be used on any inline element (#3544).fam C
command to switch font family for verbatim blocks to monospaced text in manpage output (#3561)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.
This is a patch release that fixes two regressions, one when using the header_footer option with Asciidoctor.convert_file and one when the icons attribute is set to image. It also addresses a minor issue in the default stylesheet with excerpt blocks and passes a consistent set of arguments to SyntaxHighlighter#docinfo. The Japanese version of the README has been brought up to date thanks to @soishino and @wotsushi.
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.
Released on: 2019-05-31 Released by: @mojavelinux Release beer: Elevated IPA by La Cumbre
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
header_footer: false
option when writing to file (#3316)icons
is set to image
, enable image icons, but don't use it as the value of the icontype
attribute (#3308)This is a bug fix release that fixes compatibility with Asciidoctor Diagram by registering images correctly in the catalog, fixes the parsing of multiple single-item menus in the same line, renames AbstractNode#options to AbstractNode#enabled_options to fix a conflict with the Document#options method, doesn't fail to convert the document if an image block is missing the alt attribute, and fixes source line numbers following a detached list continuation.
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.
Released on: 2019-04-30 Released by: @mojavelinux Release beer: Kentucky Breakfast Stout by Founders Brewing Company
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
This is a bug fix release that restores the background color on literal blocks and restores the bottom margin on passthrough blocks inside table cells in the default stylesheet, addresses compatibility issues with Asciidoctor.js, allows any Unicode word character to be used for the footnote ID, allows symbols to be passed to the register_for methods, defines helper methods using module_function (instead of extending self), and some other internal refactoring and polishing.
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.
Released on: 2019-04-22 Released by: @mojavelinux Release beer: Kentucky Breakfast Stout by Founders Brewing Company
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
This release fixes crash in xref resolution that was discovered from running Asciidoctor on GitHub. It also fixes compatibility with Rouge 2.0, and improves documentation for the -a
CLI option.
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.
Released on: 2019-04-13 Released by: @mojavelinux Release beer: Cheat Code by Cerebral Brewing
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
-a
CLI option; explain that @
modifier can be placed at end of name as alternative to end of valueA bug fix release that restores the 1.5.x behavior of the interdocument xref macro when the target has no file extension, doesn't fail to load if the call to Dir.home fails (which allows Asciidoctor to be used in the GitHub application), and only drops the file extension from the last path segment when cataloging the include path.
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.
Released on: 2019-04-04 Released by: @mojavelinux Release beer: Rye on Rye 6 by Boulevard Brewing
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
document#
); restores 1.5.x behavior (#3231)A bug fix release that marks the encoding of stdio objects used by the CLI as UTF-8, fixes a crash when the source highlighter is Rouge and the source language is not set, makes the register_for method on a SyntaxHighlighter implementation public, and allows the CLI to be used on any Ruby 2 version.* A few lines of unnecessary code were dropped for the Asciidoctor.js build to further reduce its size.
* Keep in mind Asciidoctor is only officially supported and tested on Ruby 2.3 or better.
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.
Released on: 2019-04-01 Released by: @mojavelinux Release beer: Transparently Trendy by Resolute Brewing
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
A bug fix release that makes some API clarifications and enables Asciidoctor to be run on any Ruby 2 version. Keep in mind Asciidoctor is only officially supported and tested on Ruby 2.3 or better. However, it's at least possible now for a distribution vendor to provide support for running Asciidoctor on older versions of Ruby 2.
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.
Released on: 2019-03-31 Released by: @mojavelinux Release beer: Rye on Rye 6 by Boulevard Brewing
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)
A bug fix release to address compatibility with Asciidoctor.js and Asciidoctor Diagram. Also fixes a crash when an attrlist is used on a literal monospace phrase (e.g., [.bar]`+foo+`
).
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.
Released on: 2019-03-28 Released by: @mojavelinux Release beer: The Dark One by High Hops Brewing
Logs: resolved issues | full diff | issues resolved in 2.0.x (cumulative)