Skip to content

Conversation

@asciidoctor-updateclibot
Copy link
Contributor

Bump Asciidoctor version

Update the key ASCIIDOCTOR_VERSION in the test harness

1 file(s) updated with "ASCIIDOCTOR_VERSION=2.0.24": * tests/asciidoctor.bats

v2.0.24
This is a patch release in the 2.0.x release line to fix bugs and address compatibility and compliance issues.

After upgrading, you'll no longer see the warning about the use of the logger gem when using Ruby 3.4. This is only a short-term solution for Ruby 3.4 and will need to be permanently fixed in a future release for Ruby 3.5. On the topic of logging, an error is now logged if an unterminated preprocessor conditional directive is detected. If the `sourcemap` option is enabled on the processor, the message will identify the file and line where the conditional started. (This change also allowed us to uncover cases when the conditional stack was incorrect). If you are extending Asciidoctor `Logger` class to implement a custom logger, all kwargs are now passed to the superclass correctly.

If you're converting to DocBook, you will notice that the link attribute on an inline image is supported (but not yet for a block image). For reproducible builds, the `SOURCE_DATE_EPOCH` environment variable is now ignored if empty.

If you're writing a converter from scratch, you'll find the documentation on how to get started to be much more helpful. You'll also appreciate the fact that the converter will not crash if you're missing a convert handler for a node when extending the base converter.

When using the verse block, you'll notice that the `code` tag no longer displays as a block.

Finally, two changes have been made for better compatibility with Opal to support Asciidoctor.js.

## Distribution

- [RubyGem (asciidoctor)](https://rubygems.org/gems/asciidoctor)

Asciidoctor is also packaged for [Fedora](https://apps.fedoraproject.org/packages/rubygem-asciidoctor), [Debian](https://packages.debian.org/sid/asciidoctor), [Ubuntu](https://packages.ubuntu.com/search?keywords=asciidoctor), [Alpine Linux](https://pkgs.alpinelinux.org/packages?name=asciidoctor), [OpenSUSE](https://software.opensuse.org/package/rubygem-asciidoctor), and [Homebrew](https://formulae.brew.sh/formula/asciidoctor). You can use the system's package manager to install the package named **asciidoctor**.

## Changelog

### Compliance

* Support link attribute on inline image macro when converting to DocBook (#4385)
* Add magic comment `backticks_javascript: true` to achieve compatibility with Opal 2.0 (#4775) (*@janbiedermann*)
* Extract the require logic of the OpenURI library for Asciidoctor.js compatibility (#4244) (*@ggrossetie*)

### Improvements

* Suppress warning about loading logger from stdlib when using Ruby 3.4 (#4769)
* Log error if unterminated preprocessor conditional directive is detected (#3545)
* Coerce names passed to the `positional_attrs` directive on an extension to strings (#4674)
* Ignore `SOURCE_DATE_EPOCH` environment variable if value is empty instead of exiting with non-zero exit code (#4631)
* Change Brazilian Portuguese translation for toc-title (#4653) (*@giflw*)

### Bug Fixes

* Consider `convert_` prefix when looking for missing convert method in converter (#4669) (*@eugoka*)
* Don't push conditional onto stack if conditional preprocessor directive is invalid when skipping lines (#4603)
* Only style code tag as block element when inside pre in listing block; not inside verse block (#4610)
* Pass kwargs to Logger superclass and only assign defaults when kwarg is not specified (#4773)
* Don't add role=include to link macro that replaces include directive when running in compat mode (#4608)

### Documentation

* Rewrite documentation for how to create a custom converter from scratch and make examples more thorough (#4699)

### Build / Infrastructure

* Fix classification of several substitution tests (#4691) (*@scouten*)

## Release meta

Released on: 2025-10-13
Released by: @mojavelinux
Release beer: Oktoberfest by Athletic Brewing Company

Logs: [resolved issues](https://github.com/asciidoctor/asciidoctor/issues?q=is%3Aissue+label%3Av2.0.24+is%3Aclosed) | [source diff](https://github.com/asciidoctor/asciidoctor/compare/v2.0.23...v2.0.24) | [gem diff](https://my.diffend.io/gems/asciidoctor/v2.0.23/v2.0.24)

## Credits

A very special thanks to all the **awesome** [supporters of the Asciidoctor OpenCollective campaign](https://opencollective.com/asciidoctor), who provide critical funding for the ongoing development of this project.
Update the key ASCIIDOCTOR_VERSION in the README.adoc file

1 file(s) updated with ":ASCIIDOCTOR_VERSION: 2.0.24": * README.adoc

v2.0.24
This is a patch release in the 2.0.x release line to fix bugs and address compatibility and compliance issues.

After upgrading, you'll no longer see the warning about the use of the logger gem when using Ruby 3.4. This is only a short-term solution for Ruby 3.4 and will need to be permanently fixed in a future release for Ruby 3.5. On the topic of logging, an error is now logged if an unterminated preprocessor conditional directive is detected. If the `sourcemap` option is enabled on the processor, the message will identify the file and line where the conditional started. (This change also allowed us to uncover cases when the conditional stack was incorrect). If you are extending Asciidoctor `Logger` class to implement a custom logger, all kwargs are now passed to the superclass correctly.

If you're converting to DocBook, you will notice that the link attribute on an inline image is supported (but not yet for a block image). For reproducible builds, the `SOURCE_DATE_EPOCH` environment variable is now ignored if empty.

If you're writing a converter from scratch, you'll find the documentation on how to get started to be much more helpful. You'll also appreciate the fact that the converter will not crash if you're missing a convert handler for a node when extending the base converter.

When using the verse block, you'll notice that the `code` tag no longer displays as a block.

Finally, two changes have been made for better compatibility with Opal to support Asciidoctor.js.

## Distribution

- [RubyGem (asciidoctor)](https://rubygems.org/gems/asciidoctor)

Asciidoctor is also packaged for [Fedora](https://apps.fedoraproject.org/packages/rubygem-asciidoctor), [Debian](https://packages.debian.org/sid/asciidoctor), [Ubuntu](https://packages.ubuntu.com/search?keywords=asciidoctor), [Alpine Linux](https://pkgs.alpinelinux.org/packages?name=asciidoctor), [OpenSUSE](https://software.opensuse.org/package/rubygem-asciidoctor), and [Homebrew](https://formulae.brew.sh/formula/asciidoctor). You can use the system's package manager to install the package named **asciidoctor**.

## Changelog

### Compliance

* Support link attribute on inline image macro when converting to DocBook (#4385)
* Add magic comment `backticks_javascript: true` to achieve compatibility with Opal 2.0 (#4775) (*@janbiedermann*)
* Extract the require logic of the OpenURI library for Asciidoctor.js compatibility (#4244) (*@ggrossetie*)

### Improvements

* Suppress warning about loading logger from stdlib when using Ruby 3.4 (#4769)
* Log error if unterminated preprocessor conditional directive is detected (#3545)
* Coerce names passed to the `positional_attrs` directive on an extension to strings (#4674)
* Ignore `SOURCE_DATE_EPOCH` environment variable if value is empty instead of exiting with non-zero exit code (#4631)
* Change Brazilian Portuguese translation for toc-title (#4653) (*@giflw*)

### Bug Fixes

* Consider `convert_` prefix when looking for missing convert method in converter (#4669) (*@eugoka*)
* Don't push conditional onto stack if conditional preprocessor directive is invalid when skipping lines (#4603)
* Only style code tag as block element when inside pre in listing block; not inside verse block (#4610)
* Pass kwargs to Logger superclass and only assign defaults when kwarg is not specified (#4773)
* Don't add role=include to link macro that replaces include directive when running in compat mode (#4608)

### Documentation

* Rewrite documentation for how to create a custom converter from scratch and make examples more thorough (#4699)

### Build / Infrastructure

* Fix classification of several substitution tests (#4691) (*@scouten*)

## Release meta

Released on: 2025-10-13
Released by: @mojavelinux
Release beer: Oktoberfest by Athletic Brewing Company

Logs: [resolved issues](https://github.com/asciidoctor/asciidoctor/issues?q=is%3Aissue+label%3Av2.0.24+is%3Aclosed) | [source diff](https://github.com/asciidoctor/asciidoctor/compare/v2.0.23...v2.0.24) | [gem diff](https://my.diffend.io/gems/asciidoctor/v2.0.23/v2.0.24)

## Credits

A very special thanks to all the **awesome** [supporters of the Asciidoctor OpenCollective campaign](https://opencollective.com/asciidoctor), who provide critical funding for the ongoing development of this project.
Update the value of ARG asciidoctor_version in the Dockerfile

changed lines [16] of file "/tmp/updatecli/github/asciidoctor/docker-asciidoctor/Dockerfile"

v2.0.24
This is a patch release in the 2.0.x release line to fix bugs and address compatibility and compliance issues.

After upgrading, you'll no longer see the warning about the use of the logger gem when using Ruby 3.4. This is only a short-term solution for Ruby 3.4 and will need to be permanently fixed in a future release for Ruby 3.5. On the topic of logging, an error is now logged if an unterminated preprocessor conditional directive is detected. If the `sourcemap` option is enabled on the processor, the message will identify the file and line where the conditional started. (This change also allowed us to uncover cases when the conditional stack was incorrect). If you are extending Asciidoctor `Logger` class to implement a custom logger, all kwargs are now passed to the superclass correctly.

If you're converting to DocBook, you will notice that the link attribute on an inline image is supported (but not yet for a block image). For reproducible builds, the `SOURCE_DATE_EPOCH` environment variable is now ignored if empty.

If you're writing a converter from scratch, you'll find the documentation on how to get started to be much more helpful. You'll also appreciate the fact that the converter will not crash if you're missing a convert handler for a node when extending the base converter.

When using the verse block, you'll notice that the `code` tag no longer displays as a block.

Finally, two changes have been made for better compatibility with Opal to support Asciidoctor.js.

## Distribution

- [RubyGem (asciidoctor)](https://rubygems.org/gems/asciidoctor)

Asciidoctor is also packaged for [Fedora](https://apps.fedoraproject.org/packages/rubygem-asciidoctor), [Debian](https://packages.debian.org/sid/asciidoctor), [Ubuntu](https://packages.ubuntu.com/search?keywords=asciidoctor), [Alpine Linux](https://pkgs.alpinelinux.org/packages?name=asciidoctor), [OpenSUSE](https://software.opensuse.org/package/rubygem-asciidoctor), and [Homebrew](https://formulae.brew.sh/formula/asciidoctor). You can use the system's package manager to install the package named **asciidoctor**.

## Changelog

### Compliance

* Support link attribute on inline image macro when converting to DocBook (#4385)
* Add magic comment `backticks_javascript: true` to achieve compatibility with Opal 2.0 (#4775) (*@janbiedermann*)
* Extract the require logic of the OpenURI library for Asciidoctor.js compatibility (#4244) (*@ggrossetie*)

### Improvements

* Suppress warning about loading logger from stdlib when using Ruby 3.4 (#4769)
* Log error if unterminated preprocessor conditional directive is detected (#3545)
* Coerce names passed to the `positional_attrs` directive on an extension to strings (#4674)
* Ignore `SOURCE_DATE_EPOCH` environment variable if value is empty instead of exiting with non-zero exit code (#4631)
* Change Brazilian Portuguese translation for toc-title (#4653) (*@giflw*)

### Bug Fixes

* Consider `convert_` prefix when looking for missing convert method in converter (#4669) (*@eugoka*)
* Don't push conditional onto stack if conditional preprocessor directive is invalid when skipping lines (#4603)
* Only style code tag as block element when inside pre in listing block; not inside verse block (#4610)
* Pass kwargs to Logger superclass and only assign defaults when kwarg is not specified (#4773)
* Don't add role=include to link macro that replaces include directive when running in compat mode (#4608)

### Documentation

* Rewrite documentation for how to create a custom converter from scratch and make examples more thorough (#4699)

### Build / Infrastructure

* Fix classification of several substitution tests (#4691) (*@scouten*)

## Release meta

Released on: 2025-10-13
Released by: @mojavelinux
Release beer: Oktoberfest by Athletic Brewing Company

Logs: [resolved issues](https://github.com/asciidoctor/asciidoctor/issues?q=is%3Aissue+label%3Av2.0.24+is%3Aclosed) | [source diff](https://github.com/asciidoctor/asciidoctor/compare/v2.0.23...v2.0.24) | [gem diff](https://my.diffend.io/gems/asciidoctor/v2.0.23/v2.0.24)

## Credits

A very special thanks to all the **awesome** [supporters of the Asciidoctor OpenCollective campaign](https://opencollective.com/asciidoctor), who provide critical funding for the ongoing development of this project.
GitHub Action workflow link
Updatecli logo

Created automatically by Updatecli

Options:

Most of Updatecli configuration is done via its manifest(s).

  • If you close this pull request, Updatecli will automatically reopen it, the next time it runs.
  • If you close this pull request and delete the base branch, Updatecli will automatically recreate it, erasing all previous commits made.

Feel free to report any issues at github.com/updatecli/updatecli.
If you find this tool useful, do not hesitate to star our GitHub repository as a sign of appreciation, and/or to tell us directly on our chat!

@asciidoctor-updateclibot asciidoctor-updateclibot bot added chore Chore tasks (CI, automation, etc.) dependencies Pull requests that update a dependency file labels Oct 14, 2025
@dduportal dduportal merged commit 16c163d into main Oct 15, 2025
4 checks passed
@dduportal dduportal deleted the updatecli_main_427a06ace6ad24a6fd8c694a8b51585c585a1641eb858fd8b2d5aefe5abd96af branch October 15, 2025 06:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

chore Chore tasks (CI, automation, etc.) dependencies Pull requests that update a dependency file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants