Right on the tails of the previous release, this minor patch release comes out of thoroughly testing the Asciidoctor 1 to Asciidoctor 2 upgrade on several large documentation sites. That hope that the previous release was the last one in the 2.0.x series before work begins on 2.1.x now extends to this release.
The main issue this release fixes is to provide fallback xreftext for HTML output and the correct linkend value for DocBook output when an xref resolves to the current document and no link text is provided. This release also brings three minor fixes to how attrlists are parsed, though the impact of these changes is likely very small. While working on parsing, we discovered that trailing punctuation (., ?, and !) was getting included in the target URL of an autolink in certain cases. The trailing punctuation now stays outside of the link. In the manpage output, keyboard references are now formatted in monospace. Additionally, text formatting markup should now be interpreted more accurately.
Consult the CHANGELOG to find the full list of changes in this release.
Don't include trailing period, question mark, or exclamation point in target (URL) of autolink (#3860)
Don't assign nil value to named attribute mapped to absent positional attribute when parsing attrlist (#4033)
Remove leading and trailing spaces around role on inline phrase (#4035)
Ignore empty role on inline phrase defined using legacy syntax and followed by comma (#4035)
Use xreftext on document as fallback link text in HTML output for inter-document xref that resolves to current document when no link text is provided (#4032)
Use xreftext on document as fallback link text in HTML output for internal xref with empty fragment when no link text is provided (#4032)
Use document ID as linkend in DocBook output for internal xref with empty fragment; auto-generating one if necessary (#4032)
Improvements
Format keyboard references in monospace in manpage output
Build / Infrastructure
Get remaining invoker tests working on JRuby 9.1 for Windows
Credits
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 include trailing period, question mark, or exclamation point in target (URL) of autolink (#3860)
Don't assign nil value to named attribute mapped to absent positional attribute when parsing attrlist (#4033)
Remove leading and trailing spaces around role on inline phrase (#4035)
Ignore empty role on inline phrase defined using legacy syntax and followed by comma (#4035)
Use xreftext on document as fallback link text in HTML output for inter-document xref that resolves to current document when no link text is provided (#4032)
Use xreftext on document as fallback link text in HTML output for internal xref with empty fragment when no link text is provided (#4032)
Use document ID as linkend in DocBook output for internal xref with empty fragment; auto-generating one if necessary (#4032)
Improvements::
Format keyboard references in monospace in manpage output
Build / Infrastructure::
Get remaining invoker tests working on JRuby 9.1 for Windows
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)
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)
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
884917c
Release 2.0.15094b920
update output of -v flag in README [skip ci]e6174c9
add entry for 2.0.15 release to what's new pagea9edcf8
use document ID as linkend for self xref in DocBook output, auto-generating o...0fb24ef
fix invoker tests that use run_command on JRuby 9.1 for Windows (PR #4042)ab09787
change interdoc xref to inter-document xref in CHANGELOG [skip ci]4562ece
fix order of section in CHANGELOG [skip ci]a70d2e3
resolves #3860 don't include trailing punctuation in target of autolink (PR #...1c37c9f
handle case when self xref without link text is inside AsciiDoc table cell2456bf4
use value of refid attribute as linkend for internal xref in DocBook converte...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)