What’s New in 2.0
The new features, improvements, and bug fixes made in each patch release of the Asciidoctor 2.0 release line. The releases are ordered from newest to oldest.
Cumulative issues resolved: 2.0.x
Asciidoctor 2.0.20
Release date: 2023.05.18
Bug Fixes
-
Update
release-versionattribute in READMEs and man page during release -
Rebuild man page during release
Asciidoctor 2.0.19
Release date: 2023.05.17
Improvements
-
Return empty string instead of nil if raw or verbatim block has no lines
-
Don’t uppercase monospace span in section title in manpage output (#4402)
-
Simplify processing of implicit link (i.e., autolink) by separating implicit and explicit match
-
Generate partintro block consistently (#4450)
-
Add Kiswahili translation for built-in labels (PR #4454) (@bkmgit)
Compliance
-
Fix call order so use of an include file with invalid encoding continues to raise error when using Ruby >= 3.2.0
-
Fix test assertion for fallback Rouge stylesheet to be compatible with Rouge 4.1 (#4406) (@tmzullinger)
-
Support
notitleoption on section as alternative tountitledto hide title (#4437) -
Add support for Haml 6 to template converter (#4429)
Bug Fixes
-
Process constrained inline passthrough inside monospace span (#4458)
-
Catalog inline ref defined using anchor macro even when resolved reftext is empty
-
Use while loop rather than recursion to locate next line to process; prevents stack limit error (#4368)
-
Avoid matching numeric character references when searching for # in xref target (#4393)
-
Use correct selector to collapse margin on first and last child of sidebar
-
Don’t allow target of include directive to start with a space (to distinguish it from a dlist item) or to end with a space
-
Manify alt text of block image in manpage output (#4401)
-
Adjust font size of term in horizontal dlist to match font size of term in regular dlist
-
Implicitly attach nested list that starts with block attribute lines to dlist entry (#4268)
-
Don’t swallow square brackets when processing escaped URL macro
-
Treat
uri:classloader:as an absolute path prefix when running on JRuby (#3929) -
Apply reftext substitutions to value of
mantitleattribute in DocBook output (#4448) -
Enclose
<reftext>tag in<article>tag in DocBook output for man page (#4452) -
Correctly handle compat role on monospace and constrained passthrough when box attrlist or formatted text is escaped
Build / Infrastructure
-
Update latest CRuby in CI workflow to 3.2
-
Update latest JRuby in CI workflow to 9.4.2.0
Asciidoctor 2.0.18
Release date: 2022.10.15
Bug Fixes
-
Change internal
uriish?helper to only detect a URI pattern at start of a string; avoids misleading messages (#4357) -
Prevent highlight.js warning when no language is set on source block; don’t call
highlightBlockifdata-langattribute is absent (#4263) -
Don’t raise error if
Asciidoctor::Extensions.unregisteris called before groups are initialized (#4270) -
If path is included both partially and fully, store it with true value (included fully) in includes table of document catalog
-
Reset registry if activate is called on it again (#4256)
-
Format source location in exception message when extension code is malformed
-
Fix lineno on reader when
skip-front-matterattribute is set but end of front matter is not found -
Fix
Asciidoctor::Cli::Invokerconstructor when first argument is a hash -
Update default stylesheet to honor marker on unordered list when marker is defined on ancestor unordered list (#4361)
Improvements
-
Propagate
:to_diroption to document of AsciiDoc table cell (#4297) -
Force encoding of attribute data passed via CLI to UTF-8 if transcoding fails (#4351) (@zkaip)
Asciidoctor 2.0.17
Release date: 2022.01.05
Bug Fixes
-
Don’t crash if process method for custom block returns an abstract block with context :compound that isn’t of type Block (e.g., a list)
-
Ignore return value of process method for custom block or block macro if value matches parent argument
-
Remove unnamespaced selectors in Pygments stylesheet
-
Normalize output from Pygments to use
linenosclass for inline line numbering and trim space after number; update default stylesheet accordingly -
Change
AbstractBlock#sections?to return false when called on block that isn’t a Section or Document (PR #3591) (@Mogztter) -
Hide built-in marker on HTML summary element in Safari when using default stylesheet (#4162)
-
Hide outline around HTML summary when activated in Safari (#4162)
-
Include primary video in value of playlist attribute when embedding YouTube video (#4156)
-
Honor
stripes=noneon nested table (#4165) -
Update default stylesheet to fix spacing around empty list item (#4184)
-
Honor
:header_onlyoption when parsing document with manpage doctype (#4192) -
Use numeric character reference for closing square bracket around alt text of icon
-
Process
authororauthorsdocument attribute in document header when implicit doctitle is absent (#4206) -
Patch open-uri-cached gem to work with Ruby 3.1 (update: drop patch now that open-uri-cached has been fixed) (#4227)
Improvements
-
Prevent line numbers on source blocks in HTML output from being selected (applies to pygments and coderay) (#4128)
-
Allow hash to be specified for Vimeo video either in video ID or using hash attribute (#4176)
-
Remove unnecessary specificity in default stylesheet for styling p element inside list item
-
Remove obsolete gist embed styles from default stylesheet
-
Allow
--failure-levelto be set to default value,FATAL -
Sort levels in help for
--failure-leveloption in ascending order -
Invert FR translations for caution & warning admonition labels (#4212) (@cyChop)
-
Add tests for open-uri-cached integration that’s activated by the
cache-uriattribute -
Don’t warn if negated tag is not found in include file (#4230)
Asciidoctor 2.0.16
Release date: 2021.08.03
Bug Fixes
-
Include all lines outside of specified tagged region when tag filter on include directive is a single negated tag (#4048)
-
Only interpret negated wildcard in tag filter on include directive as implicit globstar if it precedes other tags (#4086)
-
Change
ifevaldirective to resolve to false if comparison operation cannot be performed (#4046) -
Don’t crash if
:to_fileoption is passed toloadorload_fileand value is not a string (#4055) -
Use automatic link text if ID in shorthand xref is followed by dangling comma (e.g.,
<<idname,>>) -
Update default stylesheet to indent blocks attached to list item in checklist (#2550)
-
Update default stylesheet to re-enable styling of implicit lead role on first paragraph of preamble inside AsciiDoc table cell
-
Update default stylesheet to fix conflict between text decoration and bottom border on abbr[title] element
-
Change invalid font family "sans" in default stylesheet to "sans-serif"
-
Fix missing automatic reftext for internal xrefs in manpage output (#4110)
-
Replace numeric character reference for plus in manpage output (#4059)
-
Replace numeric character reference for degree sign in manpage output (#4059)
-
Convert apostrophe to the portable
\*(Aqvariable instead of the groff-specific escape\(aq(#4060) (@felipec) -
Document the
-e, --embeddedoption flag in the man page, which replaces the outdated-e, --erubyoption flag
Improvements
-
Use queue to iterate over lines in reader instead of stack (#4106)
-
Uppercase automatic reftext for level-2 section titles in manpage output if reftext matches section title (#4110)
-
Show safe modes in strictness order in CLI help (#4065)
-
Remove redundant styles from the default stylesheet
-
Update font styles for summary element in default stylesheet to match font styles of paragraph (#4114)
-
Update default stylesheet to indent content of details element (#4116)
-
Update default stylesheet to use custom marker for summary element to make appearance consistent (#4116)
-
Add Vietnamese translation of built-in attributes (PR #4066) (@nguyenhoa93)
-
Add Thai translation of built-in attributes (PR #4113) (@ammaneena)
Build / Infrastructure
-
Import source of default stylesheet into this repository; use PostCSS with cssnano to minify (#4062)
-
Use autoprefixer to manage browser prefixes in default stylesheet (#4118)
Asciidoctor 2.0.15
Release date: 2021.04.27
Bug Fixes
-
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)
Asciidoctor 2.0.14
Release date: 2021.04.19
Bug fixes
-
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
showtitleandnotitleto be toggled in AsciiDoc table cell if set in parent document (#4018) -
Ensure mtime of input file honors TZ environment variable on JRuby for Windows (affects value of
docdatetimeattribute) (#3550) -
Honor caption attribute on blocks that support captioned title even if corresponding
*-captiondocument attribute (e.g.,example-caption) is unset (#4023) -
Suppress missing attribute warning when applying substitutions to implicit document title for assignment to intrinsic
doctitleattribute (#4024)If you want to use an attribute reference in the document title (i.e., level-0 section title), and you also need to reference the
doctitleattribute somewhere in the document, then any attributes you reference in the document title must be defined before that line (aka follow document order, just like any other attribute entry). Otherwise, they will remain unresolved in the value of thedoctitleattribute (though they will still work in the document title itself).
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-homeattribute to be overridden by API or CLI (#3732)
Asciidoctor 2.0.13
Release date: 2021.04.10
Bug fixes
-
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
counterandcounter2attribute 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 the 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
mannamein man page output -
Remove extra
.spline 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
.bpmacro at location of page break in man page output (#3992)
Improvements
-
Extract method to create lexer and formatter in Rouge adapter (#3953) (@Oblomov)
-
Add support for pygments.rb 2.x (#3969) (@slonopotamus)
-
Allow
NullLoggerto be enabled by setting the:loggeroption to a falsy value (#3982) -
Substitute attributes in manpurpose part of NAME section in man page doctype (#4000)
-
Output all mannames in name section of HTML output for man page doctype (#3757)
Build and infrastructure
-
Enable running tests as root (PR #3874) (@mikemckiernan)
-
Import documentation for processor into Asciidoctor core repository (#3861) (@graphitefriction)
-
Speed up CI by using Bundler cache (PR #3901) (@slonopotamus)
-
Run tests against both pygments.rb 1.x and 2.x (#3969) (@slonopotamus)
Documentation
-
Multiple copyedits and typo fixes (PR #3858)(PR #3912)(PR #3913) (@mogztter)
-
Improve Dutch translation by removing diacritic from first letter of
toc-titleand adding translations forpartandsection(PR #3895) (@jdevreese) -
Update attributes-it.adoc (PR #3886) (@ciampix)
-
Correct extension registry errors in options.adoc (PR #3902) (@djencks)
-
Minor improvements to docs features page (PR #3917) (@Younes-L)
-
Add Belarusian translation of built-in attributes (PR #3928) (@morganov)
-
Document the
header_onlyoption (PR #3934) (@mogztter) -
Add a pandoc command using docker and update command on MS Word migration page (PR #3956) (@dacog)
-
Apply minor typo and flow change to default stylesheet docs (PR #3977) (@chrisperrault)
-
Update instructions for Migrating from Confluence XHTML (#3994) (@juliojgd)
Asciidoctor 2.0.12
Release date: 2020.11.10
Bug Fixes
-
Set
typeandtargetproperty on unresolved footnote reference and unsetidproperty (fixes regression) (#3825) -
Fix crash when inlining an SVG if the explicit width or height value on the image node is not a string (#3829)
-
Reset word wrap behavior to normal on tables, then re-enable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)
Compliance
-
Defer use of Ruby >= 2.3 constructs to restore compatibility with Ruby 2.0 until at least next minor release (#3827)
-
Don’t append the default px unit identifier to the explicit width or height value when inlining an SVG (#3829)
Build and infrastructure
-
Migrate Linux CI jobs to GitHub Actions (#3837)
-
Migrate Windows CI jobs to GitHub Actions (#3839)
-
Run CI job on macOS (#3842)
Asciidoctor 2.0.11
Release date: 2020.11.02
Bug fixes
-
Fix infinite loop when callout list with obsolete syntax is found inside list item (#3472)
-
Fix infinite loop when xreftext contains a circular reference path in HTML and man page converters (#3543)
-
Apply text formatting to table cells in implicit header row when column has the
aorlstyle (#3760) -
Fix errant reference warning for valid reference when running in compat mode (#3555)
-
Initialize backend traits for converter (if not previously initialized) using assigned basebackend; mimics Asciidoctor < 2 behavior (#3341)
-
Set
source_locationon preamble block whensourcemapoption is enabled (#3799) -
Link the
notitleandshowtitleattributes so they act as opposites for the same toggle (#3804) -
Pass options to constructor of Rouge lexer instead of
#lexmethod; restores compatibility with Rouge >= 3.4 (#3336) -
Don’t clobber
cgi-styleoptions on language when enablingstart_inlineoption on the Rouge PHP lexer (#3336) -
Fix parsing of wrapped link and xref text, including when an attrlist signature is detected (#3331)
-
Restore deprecated writable number property on
AbstractBlock -
Always use title as xreftext if target block has an empty caption, regardless of
xrefstylevalue (#3745) -
Allow a bibliography reference to be used inside a footnote (#3325)
-
Fix bottom margin collapsing on AsciiDoc table cell (#3370)
-
Remove excess hard line break in multi-line AsciiMath blocks (#3407)
-
Only strip trailing spaces from lines of AsciiDoc include file (#3436)
-
Remove errant optional flag in regexp for menu macro that breaks Asciidoctor.js (#3433)
-
Preserve repeating backslashes when generating man page output (#3456)
-
Honor percentage width specified on macro of inline SVG (#3464)
-
Removing leading and trailing blank lines in AsciiDoc include file to match assumption of parser (#3470)
-
Activate extensions when
:extensionsoption is set, even if Extensions API is not yet loaded (#3570) -
Don’t activate global extensions if
:extensionsoption isfalse(#3570) -
Escape ellipsis at start of line in man page output (#3645) (@jnavila)
-
Don’t register footnote with ID if a footnote is already registered with that ID (#3690)
-
Honor
startattribute on ordered list in man page output (#3714) -
Warn instead of crashing if SVG to inline is empty (#3638) (@mogztter)
-
Compute highlight line ranges on source block relative to value of
startattribute (#3519) (@mogztter) -
Prevent collapsible block from incrementing example number by assigning an empty caption (#3639)
-
Use custom init function for highlight.js to select the correct
codeelements (#3761) -
Fix resolved value of
:to_dirwhen both:to_fileand:to_diroptions are set to absolute paths (#3778) -
Fix crash if value of
stylesheetsattribute contains a folder and the destination directory for the stylesheet does not exist (even when the:mkdirsoption is set) (#3808) -
Fix crash if value passed by API for
copycssattribute is not a string (#3592) -
Restore label in front of each bibliography entry in DocBook output that was dropped by fix for #3085 (#3782)
-
Apply max width to each top-level container instead of body in HTML output (#3513)
-
Don’t apply
border-collapse:separate to HTML for table blocks; fixes double border at boundary ofcolspanandrowspan(#3793) (@ahus1) -
Don’t remove right border on last table cell in row (#2563)
-
Rework table borders to leverage border collapsing (apply frame border to table, grid border to cells, and selectively override border on cells to accommodate frame) (#3387)
Compliance
-
Add support for
mutedoption to self-hosted video (#3408) -
Move
<style>element for convert-time syntax highlighters (coderay, rouge, pygments) into head (#3462) -
Move
<style>element for client-side syntax highlighters (highlight.js, prettify) into head (#3503) -
Define entry point API methods (
load,convert,load_file,convert_file) as class methods instead ofmodule_functionto avoid conflict withKernel.load(#3625) -
Retain attribute order on HTML
codeelement for source block to remain consistent with output from Asciidoctor 1.5.x (#3786) -
Correct language code for Korean language file from
krtoko(#3807) (@jnavila)
Improvements
-
Apply word wrap (i.e.,
word-wrap: anywhere) to body in default stylesheet (#3544) -
Allow
nobreakandnowraproles to be used on any inline element (#3544) -
Add CSS class to support
pre-wraprole to preserve leading, trailing, and repeating spaces in phrase (#3815) -
Preserve guard around XML-style callout when icons are not enabled (#3319)
-
Use
.fam Ccommand to switch font family for verbatim blocks to monospaced text in man page output (#3561) -
Remove redundant test for
halignandvalignattributes on table cell in DocBook converter -
Allow encoding of include file to be specified using
encodingattribute (#3248) -
Allow template to be used to override outline by only specifying the outline template (#3491)
-
Upgrade MathJax from 2.7.5 to 2.7.9
-
Upgrade highlight.js from 9.15.10 to 9.18.3 (note that this increases script size from 48.8 KB to 71.5 KB)
-
Skip unused default attribute assignments for embedded document
-
Allow a URL macro to have a preceding single or double quote (#3376)
-
Add support for erubi template engine; use it in place of erubis in test suite; note the use of erubis is deprecated (#3737)
-
Download and embed remote custom stylesheet if
allow-uri-readis set (#3765) -
Remove direction property from default stylesheet (#3753) (@abdnh)
-
remove max width setting on content column for print media in default stylesheet (#3802)
-
Normalize frame value
topbotto "ends" in HTML output (consistently useframe-endsclass) (#3797) -
Add role setter method on
AbstractNode(#3614) -
Map
chapter-signifierandpart-signifierattributes in locale attribute files to replacechapter-labelandpart-label(#3817)
Build and infrastructure
-
Run test suite on TruffleRuby nightly (@mogztter, @erebor)
-
Upgrade TruffleRuby to 20.0.0 (@mogztter)
-
Trigger upstream builds for AsciidoctorJ on GitHub Actions (@robertpanzer)
Asciidoctor 2.0.10
Release date: 2019.05.31
Bug fixes
-
Fix Asciidoctor.convert_file to honor
header_footer: falseoption when writing to file (#3316) -
Fix placement of title on excerpt block (#3289)
-
Always pass same options to
SyntaxHighlighter#docinfo, regardless of value of location argument -
Fix signature of
SyntaxHighlighter#docinfomethod (#3300) -
When
iconsis set toimage, enable image icons, but don’t use it as the value of theicontypeattribute (#3308)
Asciidoctor 2.0.9
Release date: 2019.04.30
Bug fixes
-
Process multiple single-item menu macros in same line (#3279)
-
Register images in catalog correctly (#3283)
-
Rename
AbstractNode#optionsmethod toAbstractNode#enabled_optionsso it doesn’t get shadowed byDocument#options(#3282) -
Don’t fail to convert document if
altattribute is not set on block or inline image (typically by an extension) -
Fix lineno of source location on blocks that follow a detached list continuation (#3281)
-
Assume inline image type is image if not set (typically by an extension)
Asciidoctor 2.0.8
Release date: 2019.04.22
Bug fixes
-
Restore background color applied to literal blocks by default stylesheet (#3258)
-
Use portability constants (
CC_ALL,CC_ANY) in regular expressions defined in built-in converters (DocBook5 and ManPage) -
Use portability constant (
CC_ANY) in regular expression for custom inline macros -
Use smarter margin collapsing for AsciiDoc table cell content; prevent passthrough content from being cut off (#3256)
-
Don’t limit footnote ref to ASCII charset; allow any word character in Unicode to be used (#3269)
Improvements
-
register_formethods accept arguments as symbols (#3274) -
Use
Concurrent::Mapinstead ofConcurrent::Hashin template converter -
Use
module_functionkeyword to define methods in Helpers -
Move regular expression definitions to separate source file (internal change)
Asciidoctor 2.0.7
Release date: 2019.04.13
Bug fixes
-
Fix crash when resolving ID from text and at least one candidate contains an unresolved xref (#3254)
-
Fix compatibility with Rouge 2.0
Improvements
-
Improve documentation for the
-aCLI option; explain that@modifier can be placed at end of name as alternative to end of value -
Move source for main API entry points (
load,load_file,convert,convert_file) to separate files (internal change) -
Define main API entry points (
load,load_file,convert,convert_file) as module functions
Asciidoctor 2.0.6
Release date: 2019.04.04
Bug fixes
-
Assume implicit AsciiDoc extension on inter-document xref macro target with no extension (e.g.,
document#); restores Asciidoctor 1.5.x behavior (#3231) -
Don’t fail to load application if call to
Dir.homefails; use a rescue with fallback values (#3238) -
Helpers.rootnameshould only consider final path segment when dropping file extension
Improvements
-
Implement
Helpers.extnameas a more efficient and flexibleFile.extnamemethod -
Check for AsciiDoc file extension using
end_with?instead of resolving the extname and using a lookup
Asciidoctor 2.0.5
Release date: 2019.04.01
Bug fixes
-
Fix crash when source highlighter is Rouge and source language is not set on block (#3223)
-
Update CLI and
SyntaxHighlighterto allow Asciidoctor to load cleanly on Ruby 2.0 - 2.2 -
CLI should use
$stdininstead ofSTDINto be consistent with the use of$stdout -
Mark encoding of
stdioobjects used in CLI as UTF-8 (#3225) -
Make
Asciidoctor::SyntaxHighlighter::Config.register_formethod public as documented
Asciidoctor 2.0.4
Release date: 2019.03.31
Bug fixes
-
Allow Asciidoctor to load cleanly on Ruby 2.0 - 2.2 for distributions that provide support for these older Ruby versions
-
Make
Asciidoctor::Converter::Config.register_formethod public as documented -
Remove unused
Asciidoctor::Converter::BackendTraits#derive_backend_traitsprivate method -
Move
Asciidoctor::Converter::BackendTraits.derive_backend_traitsmethod toAsciidoctor::Converter -
Mark
renderandrender_filemethods as deprecated in API docs
Asciidoctor 2.0.3
Release date: 2019.03.28
Bug fixes
-
Fix crash when attribute list is used on literal monospace phrase (#3216)
-
Update use of magic regexp variables to fix compatibility with Opal / Asciidoctor.js (#3214)
Asciidoctor 2.0.2
Release date: 2019.03.26
Bug fixes
-
Apply verbatim substitutions to literal paragraphs attached to list item (#3205)
-
Implement
#linesand#sourcemethods onTable::Cellbased on cell text (#3207)
Asciidoctor 2.0.1
Release date: 2019.03.25
Bug fixes
-
Convert titles of cataloged block and section nodes containing attribute references eagerly to resolve attributes while in scope (#3202)
-
Customize MathJax (using a
postfilterhook) to applydisplaymathformatting to AsciiMath block (#2498) -
Fix misspelling of deprecated
default_attrsDSL function (missing trailing "s") -
Remove unused location property (
attr_accessor :location) onDocinfoProcessorclass -
Look for deprecated extension option
:pos_attrsif:positional_attrsoption is missing (#3199) -
Add detail to load error message if path differs from gem name (#1884)
Asciidoctor 2.0.0
Release date: 2019.03.22
Enhancements and compliance
-
Drop support for Ruby < 2.3 and JRuby < 9.1 and remove workarounds (#2764)
-
Drop support for Slim < 3 (#2998)
-
Drop the converter for the
docbook45backend from core; moved to github.com/asciidoctor/asciidoctor-docbook45 (#3005) -
Apply substitutions to section and block titles in
normalsubstitution order (#1173) -
Make syntax highlighter pluggable; extract all logic into adapter classes (#2106)
-
Add syntax highlighter adapter for Rouge (#1040)
-
Redesign Converter API based on SyntaxHighlighter API; remap deprecated API to new API to ensure compatibility (#2891)
-
Repurpose built-in converters as regular converters (#2891)
-
Make registration and resolution of global converters thread-safe (#2891)
-
Fold the default converter factory into the Converter module (#2891)
-
Add a default implementation for
Converter#convertin the Base converter (#2891) -
Rename
Converter::BackendInfotoConverter::BackendTraits; mapbackend_infoto newbackend_traitsmethod (#2891) -
Allow built-in converter classes to be resolved using
Converter.forand instantiated usingConverter.create(#2891) -
Allow converter factory to be passed using
:converter_factoryAPI option (#2891) -
Honor
htmlsyntaxif defined on converter (#2891) -
Add
backend_traits_sourcekeyword argument toCompositeConverterconstructor (#2891) -
Add support for
startattribute when using prettify to highlight source blocks with line numbering enabled -
Use
String#encodeto encode String as UTF-8 instead of usingString#force_encoding(#2764) -
Add
FILE_READ_MODE,URI_READ_MODE, andFILE_WRITE_MODEconstants to control open mode when reading files and URIs and writing files (#2764) -
Set visibility of private and protected methods (#2764)
-
Always run docinfo processor extensions regardless of safe mode (gives control to extension) (#2966)
-
Use infinitive verb form for extension DSL method names; map deprecated method names where appropriate
-
Add docinfo insertion slot for header location to built-in converters (#1720)
-
Add support for the
mutedoption on Vimeo videos (allowsautoplayto work in Chrome) (#3014) -
Use value of
prettify-themeattribute as is if it starts with http:// or https:// (#3020) -
Allow
icontypeto be set usingiconsattribute (#2953) -
When using a server-side syntax highlighter, highlight content of source block even if source language is not set (#3027)
-
Automatically promote a listing block without an explicit style to a source block if
source-languageis set (#1117) -
Remove the 2-character (i.e.,
"") quote block syntax -
Don’t allow block role to inherit from document attribute; only look for role in block attributes (#1944)
-
Split out functionality of
-wCLI flag (script warnings) from-vCLI flag (verbose logging) (#3030) -
Log possible invalid references at info level (#3030)
-
Log dropped lines at info level when
attribute-missing=drop-line(#2861) -
Honor
attribute-missingsetting when processing include directives and block macros (#2855) -
Log warning when include directive is not resolved due to missing attribute or blank target; always include warning in output document (#2868)
-
Use the third argument of
AbstractNode#attr/AbstractNode#attr?to set the name of a fallback attribute to look for on the document (#1934) -
Change default value of third argument to
Abstractnode#attr/AbstractNode#attr?tonilso attribute doesn’t inherit by default (#3059) -
Look for
table-frame,table-grid, andtable-stripesattributes on document as fallback forframe,grid, andstripesattributes on table (#3059) -
Add support for hover mode for table stripes (
stripes=hover) (#3110) -
Always assume the target of a shorthand inter-document xref is a reference to an AsciiDoc document (source-to-source) (#3021)
-
If the target of a formal xref macro has a file extension, assume it’s a path reference (#3021)
-
Never assume target of a formal xref macro is a path reference unless a file extension or fragment is present (#3021)
-
Encode characters in URI to comply with RFC-3986
-
Implement full support for styled xreftext in man page converter (#3077)
-
Allow the
idandroleproperties to be set on a list item of ordered and unordered lists via the API (#2840) -
Yield processor instance to registration block for document processor if block has non-zero arity (i.e., has parameters)
-
Add
Document#parsed?method to check whether document has been parsed -
Modify
Cellclass to extend fromAbstractBlockinstead ofAbstractNode(#2963) -
Implement
block?andinline?methods onColumn, both which returnfalse(#2963) -
Drop
versetable cell style (treat as normal table cell) (#3111) -
Allow negated
substo be specified on inline pass macro (#2191) -
Log warning if
footnoterefmacro is found and compat mode is not enabled (#3114) -
Log info message if inline macro processor returns a String value (#3176)
-
Apply
substoInlinenode returned by inline macro processor ifsubsattribute is specified (#3178) -
Add
create_inline_passhelper method to base extension processor class (#3178) -
Log debug message instead of warning if block style is unknown (#3092)
-
Allow backend to delegate to a registered backend using the syntax
synthetic:delegatewhen using custom templates (e.g.,slides:html) (#891) -
AbstractBlock#find_bylooks inside AsciiDoc table cells iftraverse_documentsselector option istrue(#3101) -
AbstractBlock#find_byfinds table cells, which can be selected using the:table_cellcontext in the selector (#2524) -
Allow ampersand to be used in email address (#2553)
-
Propagate ID assigned to inline passthrough (#2912)
-
Rename control keywords in
find_byto better align with the standardNodeFilterterminology -
Stop
find_byiteration if filter block returns:stopdirective -
Rename
header_footeroption to standalone (while still honoringheader_footerfor backwards compatibility) (#1444) -
Replace anchors and xrefs before footnotes (replace footnotes last in macros substitution group)
-
Apply substitution for custom inline macro before all other macros
-
Only promote index terms automatically (A, B, C becomes A > B > C + B > C + C) if
indexterm-promotionoption is set on document (#1487) -
Add support for
seeandsee-alsoon index terms; parse attributes onindextermmacros if text contains=(#2047) -
Drop
:indextermstable from document catalog (in preparation for solution to #450 in a 2.x release) -
Load additional languages for highlight.js as defined in the comma-separated
highlightjs-languagesattribute (#3036) -
Log warning if conditional expression in
ifevaldirective is invalid (#3161) -
Drop lines that contain an invalid preprocessor directive (#3161)
-
Rename
AbstractBlock#find_bydirectives; use:prunein place of:skip_childrenand:rejectin place of:skip -
Convert example block into details/summary tag set if
collapsibleoption is set; open by default ifopenoption is set (#1699) -
Substitute replacements in author values used in document header (#2441)
-
Require space after semicolon that separates multiple authors (#2441)
-
Catalog inline anchors at start of callout list items (#2818) (@owenh000)
-
Add
parse_attributeshelper method to base extensionProcessorclass (#2134)
Improvements
-
Propagate document ID to DocBook output (#3011)
-
Always store section numeral as string; compute Roman numeral for part at assignment time (@vmj)
-
Refactor code to use modern Hash syntax
-
Define
LIB_DIRconstant; rename *_PATH constants to *_DIR constants to be consistent with RubyGems terminology (#2764) -
Only define
ROOT_DIRif not already defined (for compatibility with Asciidoctor.js) -
Move custom docinfo content in footer below built-in docinfo content in footer in HTML converter (#3017)
-
Read and write files using File methods instead of IO methods (#2995)
-
Value comparison in
AbstractNode#attr?is only performed if expected value is truthy -
Align default CodeRay style with style for other syntax highlighters (#2106)
-
Ensure
linenosclass is added tolinenoscolumn when source highlighter ispygmentsandpygments-css=style -
Disable table stripes by default (#3110)
-
Rename CSS class of Pygments line numbering table to
linenotable(to align with Rouge) (#1040) -
Remove unused
Converter#convert_with_optionsmethod (#2891) -
Add
-e,--embeddedCLI flag as alias for-s, --no-header-footer(require long option to specify eRuby implementation) (#1444) -
Don’t store the
optionsattribute on the block once the options are parsed (#3051) -
Add an
optionsmethod onAbstractNodeto retrieve the set of option names (#3051) -
Pass
:input_mtimeoption toDocumentconstructor; letDocumentconstructor assign docdate/time/year attributes (#3029) -
Never mutate strings; add a
frozen_string_literal: truemagic comment to top of all Ruby source files (#3054) -
Always use
docdateanddoctimeto computedocyearanddocdatetime(#3064) -
Rename
PreprocessorReader#exceeded_max_depth?toPreprocessorReader#exceeds_max_depth?and returnnilif includes are disabled -
Stop populating
:idstable in document catalog (#3084) -
Always use
:refstable in document catalog to look for registered IDs (#3084) -
Don’t compute and store reference text in document catalog (#3084)
-
Populate reference text table lazily for resolving ID by reference text (#3084)
-
Don’t store fallback reference text on
:bibrefnode (#3085) -
Call
AbstractNode#reftextinstead ofAbstractNode#textto retrieve reference text forbibrefnode (#3085) -
Only map unparsed attrlist of inline macro to target when format is short
-
Add clearer exception message when source data is binary or has invalid encoding (#2884)
-
Rename context for table cell and table column to
:table_celland:table_column, respectively -
Rename
hardbreaksdocument attribute tohardbreaks-option; retainhardbreaksas a deprecated alias (#3123) -
Extend TLD for implicit email addresses to 5 characters (#3154)
-
Truncate with precision (instead of rounding) when computing absolute width for columns in DocBook output (#3131)
-
Drop legacy LaTeX math delimiters (e.g,
$..$) if present (#1339) -
Use proper terminology in warning message about mismatched preprocessor directive (#3165)
-
Rename low-level extension attribute name
:pos_attrsto:positional_attrs -
Mark
default_attrsextension DSL method deprecated in favor ofdefault_attributes -
Upgrade MathJax to 2.7.5
Bug fixes
-
Fix crash caused by inline passthrough macro with the macros
subclearing the remaining passthrough placeholders (#3089) -
Fix crash if
ifevaldirective is missing expression (#3164) -
Prevent relative
leveloffsetfrom making section level negative and causing hang (#3152) -
Don’t fail to parse Markdown-style quote block that only contains attribution line (#2989)
-
Enforce rule that Setext section title must have at least one alphanumeric character; fixes problem with block nested inside quote block (#3060)
-
Apply header substitutions to
doctitlevalue when assigning it back to thedoctitledocument attribute (#3106) -
Don’t fail if value of
pygments-styleattribute is not recognized; gracefully fallback to default style (#2106) -
Do not alter the
$LOAD_PATH(#2764) -
Fix crash if stem block is empty (#3118)
-
Remove conditional comment for IE in output of built-in HTML converter; fixes sidebar table of contents (#2983)
-
Fix styling of source blocks with
linenumsenabled when using prettify as syntax highlighter (#640) -
Update default stylesheet to support prettify themes (#3020)
-
Remove hard-coded color values on source blocks in default stylesheet (#3020)
-
Add fallback if relative path cannot be computed because the paths are located on different drives (#2944)
-
Ignore explicit section level style (#1852)
-
Don’t eat space before callout number in source block if
line-commentattribute is empty (#3121) -
Check if type is defined in a way that’s compatible with autoload
-
Fix invalid check for DSL in extension class (previously always returned true)
-
Scope constant lookups (#2764)
-
Use byteslice instead of slice to remove BOM from string (#2764)
-
Don’t fail if value of
-aCLI option is empty string or equals sign (#2997) -
Allow failure level of CLI to be set to
info -
Reader#push_includeshould not fail if data is nil -
Fix deprecated ERB trim mode that was causing warning (#3006)
-
Move time anchor after query string on Vimeo video to avoid dropping options
-
Allow color for generic text, line numbers, and line number border to inherit from Pygments style (#2106)
-
Enforce and report relative include depth properly (
depth=0rather thandepth=1disables nested includes) -
Allow
outfilesuffixto be soft set from API (#2640) -
Don’t split paragraphs in table cell at line that resolves to blank if adjacent to other non-blank lines (#2963)
-
Initialize the level to
WARNwhen instantiating theNullLogger -
next_adjacent_blockshould not fail when called on dlist item (#3133) -
Don’t suppress browser styles for summary tag; add pointer cursor and panel margin bottom (#3155)
-
Only consider TLDs in email address that have ASCII alpha characters
-
Allow underscore in domain of email address
Build and infrastructure
-
Clear
SOURCE_DATE_EPOCHenv var when testing timezones (PR #2969) (@aerostitch) -
Remove compat folder (removes the AsciiDoc.py config file that provides pseudo-compliance with Asciidoctor and a stylesheet for an old Font Awesome migration)
-
Add Ruby 2.6.0 to build matrix
-
Stop running CI job on unsupported versions of Ruby
-
Exclude test suite, build script, and Gemfile from gem (#3044)
-
Split build tasks out into individual files