[dependabot]

Bumps asciidoctor from 4.1.1 to 4.2.1.

Release notes

Sourced from asciidoctor's releases.

v4.2.1

Summary

Release meta

Released on: 2026-11-02 Released by: ggrossetie Published by: GitHub

Logs: full diff

Changelog

Improvements

• Add Table.Cell#getBackgroundColor() (alias backgroundColor), which returns the cellbgcolor value captured for the cell, including a value set by {set:cellbgcolor:...} in the text of the cell or a preceding cell, so that converters outside the core can support it (#1917)

v4.2.0

Summary

Release meta

Released on: 2026-11-02 Released by: ggrossetie Published by: GitHub

Logs: full diff

Changelog

Bug Fixes

• Derive the authorinitials attribute from an author attribute entry in a header that has a document title but no author line (e.g., :author: Doc Writer gives DW), like Asciidoctor, instead of leaving it unset
• Output empty attribute values like Asciidoctor in the DocBook converter, such as an empty id, role or reftext (xml:id="", role="", xreflabel=""), table width, list mark, index term see and see-also, and an empty revdate, copyright, author email, name parts or initials, and front-cover-image in the document info, and only output the reftext of an open block that has an id (#1903)
• Output the size attributes of a DocBook cover image defined using the image macro syntax (e.g., :front-cover-image: ![Cover](https://github.com/asciidoctor/asciidoctor.js/blob/HEAD/cover.png)), which were ignored (#1903)
• Output an empty manmanual, mansource and docdate like Asciidoctor in the manpage converter, and use toInt for the start attribute of an ordered list (#1903)
• Keep empty and zero values in the Extension API (resolveAttributes defaults, createSection id and style, createImageBlock target, alt and title), accept an empty value in the converter trait accessors (e.g., outfilesuffix('')), and copy an empty stylesheet when copycss is set (#1903)
• Output empty attribute values like Asciidoctor in the html5 and semantic-html5 converters, such as an empty role or id (e.g., class="paragraph ", id=""), style, link on images, window on links, start/end on audio and video, Vimeo hash and YouTube list/playlist, stripes on tables, attribution and citetitle on quotes and verses, the language of a source block (also with highlight.js and html-pipeline), cellbgcolor, and chapter and part signifiers, and render an empty stem block with its delimiters (#1903)
• Treat an empty or non-numeric sectnumlevels, toclevels and levels (toc macro) as 0, like Asciidoctor, instead of falling back to the default or NaN (#1903)
• Keep the rest of a Vimeo or YouTube video target after the first / (e.g., video::123/abc/def[vimeo]), like Ruby’s split('/', 2) (#1903)
• Link the TOC entry of a section without an id to # instead of #null (#1903)
• Treat an empty attribute value as set, like Asciidoctor, in substitutions and in the document model, such as an empty attribute-undefined (only drops the reference instead of the whole line), the subject and body of a mailto link, the text of a footnoteref macro, index terms and see-also, the caption prefixes (e.g., table-caption, appendix-caption) and section signifiers (<name>-refsig) used in xreftext, doctitle, toc-placement, docdate and localdate, and the content of a docinfo file or docinfo processor (#1903)
• Split the menu path, the see-also index term attribute and the lines to highlight like Asciidoctor, so that menu:File[>] is a plain menu reference, and an open range of lines to highlight ends at the last line (#1903)
• Only derive docyear and localyear from a date in ISO format, and use toInt for the start attribute of a highlighted source block and max-attribute-value-size (#1903)
• Treat an empty role and an empty expected value as set in AbstractNode#addRole() and AbstractNode#hasAttribute() (#1903)
• Treat an empty attribute value as set, like Asciidoctor, when parsing the document, such as an empty style ([""]), id ([id=]), title ([title=]), language ([,""]), attribution, revision number or remark, authorinitials, manpurpose, and empty block attributes above the document title. Empty entries in the lines include attribute, and a lines attribute that is set but empty (which now takes precedence over tag), are handled like in Asciidoctor (#1903)
• Use 0 for an empty or non-numeric value where Asciidoctor converts it to an integer, such as the start attribute of an ordered list (instead of NaN), leveloffset and the operands of an ifeval directive (#1903)
• Parse an indented paragraph with an unknown style as a literal block, add % to a scaledwidth value that ends with digits, and skip missing attribute references in the document title regardless of the attribute-missing attribute (#1903)

... (truncated)

Changelog

Sourced from asciidoctor's changelog.

== v4.2.1 (2026-11-02)

Improvements::

• Add Table.Cell#getBackgroundColor() (alias backgroundColor), which returns the cellbgcolor value captured for the cell, including a value set by {set:cellbgcolor:...} in the text of the cell or a preceding cell, so that converters outside the core can support it (#1917)

== v4.2.0 (2026-11-02)

Bug Fixes::

• Derive the authorinitials attribute from an author attribute entry in a header that has a document title but no author line (e.g., :author: Doc Writer gives DW), like Asciidoctor, instead of leaving it unset
• Output empty attribute values like Asciidoctor in the DocBook converter, such as an empty id, role or reftext (xml:id="", role="", xreflabel=""), table width, list mark, index term see and see-also, and an empty revdate, copyright, author email, name parts or initials, and front-cover-image in the document info, and only output the reftext of an open block that has an id (#1903)
• Output the size attributes of a DocBook cover image defined using the image macro syntax (e.g., :front-cover-image: image:cover.png[Cover,200,300]), which were ignored (#1903)
• Output an empty manmanual, mansource and docdate like Asciidoctor in the manpage converter, and use toInt for the start attribute of an ordered list (#1903)
• Keep empty and zero values in the Extension API (resolveAttributes defaults, createSection id and style, createImageBlock target, alt and title), accept an empty value in the converter trait accessors (e.g., outfilesuffix('')), and copy an empty stylesheet when copycss is set (#1903)
• Output empty attribute values like Asciidoctor in the html5 and semantic-html5 converters, such as an empty role or id (e.g., class="paragraph ", id=""), style, link on images, window on links, start/end on audio and video, Vimeo hash and YouTube list/playlist, stripes on tables, attribution and citetitle on quotes and verses, the language of a source block (also with highlight.js and html-pipeline), cellbgcolor, and chapter and part signifiers, and render an empty stem block with its delimiters (#1903)
• Treat an empty or non-numeric sectnumlevels, toclevels and levels (toc macro) as 0, like Asciidoctor, instead of falling back to the default or NaN (#1903)
• Keep the rest of a Vimeo or YouTube video target after the first / (e.g., video::123/abc/def[vimeo]), like Ruby's split('/', 2) (#1903)
• Link the TOC entry of a section without an id to # instead of #null (#1903)
• Treat an empty attribute value as set, like Asciidoctor, in substitutions and in the document model, such as an empty attribute-undefined (only drops the reference instead of the whole line), the subject and body of a mailto link, the text of a footnoteref macro, index terms and see-also, the caption prefixes (e.g., table-caption, appendix-caption) and section signifiers (<name>-refsig) used in xreftext, doctitle, toc-placement, docdate and localdate, and the content of a docinfo file or docinfo processor (#1903)
• Split the menu path, the see-also index term attribute and the lines to highlight like Asciidoctor, so that menu:File[>] is a plain menu reference, and an open range of lines to highlight ends at the last line (#1903)
• Only derive docyear and localyear from a date in ISO format, and use toInt for the start attribute of a highlighted source block and max-attribute-value-size (#1903)
• Treat an empty role and an empty expected value as set in AbstractNode#addRole() and AbstractNode#hasAttribute() (#1903)
• Treat an empty attribute value as set, like Asciidoctor, when parsing the document, such as an empty style ([""]), id ([id=]), title ([title=]), language ([,""]), attribution, revision number or remark, authorinitials, manpurpose, and empty block attributes above the document title. Empty entries in the lines include attribute, and a lines attribute that is set but empty (which now takes precedence over tag), are handled like in Asciidoctor (#1903)
• Use 0 for an empty or non-numeric value where Asciidoctor converts it to an integer, such as the start attribute of an ordered list (instead of NaN), leveloffset and the operands of an ifeval directive (#1903)
• Parse an indented paragraph with an unknown style as a literal block, add % to a scaledwidth value that ends with digits, and skip missing attribute references in the document title regardless of the attribute-missing attribute (#1903)
• Assign the id defined inline on the document title (e.g., = Document Title [[docid]]) to the document and register it in the catalog, so that cross references to it resolve (#1903)
• Coerce a level-0 special section (e.g., [appendix]) to level 1 in any doctype, not only in a book, and make a level-0 [abstract] section a level-1 chapter in a book, instead of a part (#1903)
• Add referrerpolicy="strict-origin-when-cross-origin" to the YouTube <iframe> of the video macro, in the html5 and semantic-html5 backends, so YouTube receives the referrer it now requires to play embedded videos (asciidoctor/asciidoctor#4711)
• Output one line break per blank line between the equations of an AsciiMath block, like Asciidoctor, instead of one extra break, in the html5 and semantic-html5 converters (#1914)
• Return an image data URI as-is from AbstractNode#generateDataUriFromUri() instead of fetching it to build a new data URI (asciidoctor/asciidoctor#4887)
• Apply the cellbgcolor background color to AsciiDoc table cells (a|), like Asciidoctor, in the html5 and semantic-html5 converters (#1917)
• Don't apply any substitutions to a block when the subs attribute is empty (e.g., [subs=]) instead of applying its default substitutions, and don't warn about an invalid substitution type when the subs attribute only contains spaces or ends with a comma (#1899)
• Return a Cursor instead of a plain object from the getSourceLocation() method of a table cell when the sourcemap option is enabled (asciidoctor/asciidoctor.js#1900)
• Don't select an extra empty line at the end of an included file that ends with a newline when selecting lines (e.g., lines=2..) or tags, which ended the enclosing paragraph (#1898)
• Report the line number of the first item as the line number of a callout list when the sourcemap option is enabled, instead of the line after the list (asciidoctor/asciidoctor#4892)
• Use the format attribute of an image, when set, to determine the MIME type of the data URI generated for that image (e.g., image::diagram[format=svg] with data-uri set), instead of the file extension or the Content-Type header of a remote image (asciidoctor/asciidoctor#4894)
• Treat a file name that ends with a dot (e.g., image.) as having no file extension, like Asciidoctor (https://github.com/asciidoctor/asciidoctor/commit/c43a6442[asciidoctor@c43a6442])
• Remove repeat forward slashes when cleaning a path, in both system and web paths (e.g., /assets//images becomes /assets/images), while preserving the root of a UNC path and the URL scheme (asciidoctor/asciidoctor#4419)
• Only use the content type sent by the server to determine the MIME type of the data URI generated for a remote image if it cannot be determined from the image target (asciidoctor/asciidoctor#3791)
• Set compat mode correctly in the document header when the compat-mode attribute is unset from the API or CLI, base the link generated for an include directive on the compat mode of the document, and don't track an attribute unset from the document body as a modified header attribute (asciidoctor/asciidoctor#4898)

Improvements::

• Support JavaScript templates and custom template engines that compile or render asynchronously (i.e., return a Promise), wait for an asynchronous configure function in the helpers file, and export the TemplateEngine registry from @asciidoctor/core to register custom template engines (#1910, #1911)
• Propagate the role on the document to the <h1> tag of the embedded (non-standalone) HTML output of the html5 backend, for regular documents and manual pages (asciidoctor/asciidoctor#4837)
• Support the link attribute (including link=self) on the block image macro when converting to DocBook, wrapping the <mediaobject> in a <link> as already done for inline images (asciidoctor/asciidoctor#4870)
• Include the document keywords in the <info> element of the DocBook output, as a <keywordset>, and add Document#keywords() (alias getKeywords()), which returns the trimmed, non-blank entries of the comma-separated keywords attribute (asciidoctor/asciidoctor#4866)
• Prevent the image-based admonition icon from being selected when selecting the surrounding text (user-select: none) in the default stylesheet (asciidoctor/asciidoctor#4824)
• Add a title attribute to the image-based admonition icon, like the font-based icon, in the html5 and semantic-html5 backends (asciidoctor/asciidoctor#4820)

... (truncated)

Commits

• 89e078b 4.2.1
• f58ccec feat(core): add Table.Cell#getBackgroundColor()
• d43a97c 4.2.0
• 205ac34 feat(core): convert a local video to a videoobject in DocBook
• b3903e0 fix(core): manage compat mode only from the document header, like Ruby
• dda57bd perf(core): speed up UriSniffRx
• 32f1669 feat(core): add full support for an image target defined as a data URI
• 4c0d6c9 test(core): verify the type attribute of an ordered list with explicit numbering
• 48cd4e7 fix(core): remove repeat slashes when partitioning a path
• 46db399 ci: manage Node.js and Deno versions with mise instead of Volta
• Additional commits viewable in compare view

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 show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @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)