This patch release was a quick turnaround from the previous one to fix issues that were discovered while testing the Asciidoctor 2 upgrade in Antora. It also provided the opportunity to fix a few additional bugs we uncovered while grooming the issue tracker. If all goes well, we expect this to be the last release of the 2.0.x series before work begins on 2.1.x.
The main issue we discovered is that the caption attribute on a block was not being honored if the global *-caption attribute (e.g., example-caption) was unset. It turns out, this regression has been around ever since the Asciidoctor 2.0.0 release, but we only just discovered it. Now, the caption attribute on the block always wins out. We also discovered that, in certain cases, document attributes unset by the API could still be set in an AsciiDoc table cell. That loophole has been closed. Additionally, if a default attribute (like table-caption) is unset in the parent document, it remains unset in the AsciiDoc table cell. There are certain attributes which can be controlled independently by the AsciiDoc table cell. That list now includes showtitle/notitle. When fixing the security vulnerability in the counter attribute directive, we inadvertently broke counters when the attribute is locked. The counter now operates even when the attribute is locked.
Consult the CHANGELOG to find the full list of changes in this release.
During this release cycle, we finally got the Asciidoctor test suite running on JRuby for Windows for the first time.
A very special thanks to all the awesomesupporters 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.
Don't allow AsciiDoc table cell to set document attribute that was unset from the API (exceptions include: compat-mode, toc, showtitle, and notitle) (#4017)
Ensure default document attributes unset in parent document remain unset in AsciiDoc table cell (#2586)
Allow the showtitle / notitle attribute to be toggled in an AsciiDoc table cell if set or unset in parent document (#4018)
Ensure mtime of input file honors TZ environment variable on JRuby for Windows (affects value of docdatetime attribute) (#3550)
Honor caption attribute on blocks that support captioned title even if corresponding *-caption document attribute (e.g., example-caption) is not set (#4023)
Suppress missing attribute warning when applying substitutions to implicit document title for assignment to intrinsic doctitle attribute (#4024)
Increment counter (but not the corresponding attribute) if attribute is locked (#4013)
Improvements::
Use attribute, if set, as seed value for counter even if not already registered as a counter (#4014)
Allow subs attribute value on Inline node returned by process method for custom inline macro to be a String (#3938)
Allow value of user-home attribute to be overridden by API or CLI (#3732)
Rollback change for #3470, which added logic to remove leading and trailing empty lines in an AsciiDoc include file; instead skip empty lines before processing document header (#3997)
Don't allow counter and counter2 attribute directives to override locked attributes (#3939) (@mogztter)
Fix crash when resolving next value in sequence for counter with non-numeric value (#3940)
Honor list of tags following negated wildcard on include directive (#3932)
Update default stylesheet to remove dash in front of cite on nested quote block (#3847)
Don't mangle formatting macros when uppercasing section titles in man page output (#3892)
Don't escape hyphen in manname in man page output
Remove extra .sp line before content of verse block in man page output
Fix layout of footnotes in man page output (#3989)
Fix formatting of footnote text with URL in man page output (#3988)
Remove redundant trailing space on URL followed by non-adjacent text in man page output (#4004)
Use .bp macro at location of page break in man page output (#3992)
Improvements::
Extract method to create lexer and formatter in Rouge adapter (#3953) (@Oblomov)
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.
Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
dependabot[bot]
commented
3 years ago
Updates the requirements on asciidoctor to permit the latest version.
Release notes
Sourced from asciidoctor's releases.
Changelog
Sourced from asciidoctor's changelog.
... (truncated)
Commits
c3b4ff6Release 2.0.14bfbcc63groom entries in CHANGELOG [skip ci]db039c3resolves #3732 allow value of user-home attribute to be overridden by API or ...d3507c9resolves #3938 allow subs attribute value on Inline node returned by process ...2caae2ffix branch names of dependent projects in CI trigger601ccd2revise CHANGELOG entries [skip ci]d2bceefdon't call apply_subs for custom inline macro if no subs are resolved1d7f4d5fix docs for expand_subs method on Substitutor; simplify code branch for symb...833275bresolves #4024 suppress missing attribute warning when processing value for d...51ec291verify attribute entry in document header can reference intrinsic doctitle at...Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)