v1.5.6.1

This release fixes regressions and integration problems that were introduced in the 1.5.6 release. Mostly notably, compatibility with Asciidoctor Diagram was restored, content in a delimited block after a skipped block is preserved, attributes are substituted in the target of inline image occurring in a section or block title, and an unnecessary warning when attempting to copy the stylesheet is suppressed. We're also happy to report that Travis CI now takes care of releasing the gem to RubyGems.org. Additional changes can be found in the changelog below.

If you're upgrading from an earlier version, you're advised to skip 1.5.6 and move directly to 1.5.6.1. Downstream projects, such as Asciidoctor.js and AsciidoctorJ, will based their 1.5.6 release on this version rather than 1.5.6.

Distributions

• RubyGem (asciidoctor)

Asciidoctor is also packaged for Fedora, Debian, Ubuntu, Mint, Alpine Linux, and OpenSUSE. Please use the system's package manager to install the package named asciidoctor.

Changelog

Bug fixes

• continue to read blocks inside a delimited block after content is skipped (PR #2318)
• don't create an empty paragraph for skipped content inside a delimited block (PR #2319)
• allow the subs argument of Substitutors#apply_subs to be nil
• coerce group name to symbol when registering extension (#2324)
• eagerly substitute attributes in target of inline image macro (#2330)
• don't warn if source stylesheet can't be read but destination already exists (#2323)
• track include path correctly if path is absolute and outside of base directory (#2107)
• preprocess second line of setext section title (PR #2321)
• preprocess second line of setext discrete heading (PR #2332)
• return filename as relative path if filename doesn't share common root with base directory (#2107)

Improvements / Refactoring

• change default text for inter-document xref (PR #2316)
• add additional tests to test behavior of Reader#peek_lines
• parse revision info line correctly that only has version and remark; add missing test for scenario
• rename AtxSectionRx constant to AtxSectionTitleRx for consistency with SetextSectionTitleRx constant
• use terms "atx" and "setext" to refer to section title syntax (PR #2334)
• rename HybridLayoutBreakRx constant to ExtLayoutBreakRx
• change terminology from "floating title" to "discrete heading"
• consolidate skip blank lines and check for end of reader (PR #2325)
• have Reader#skip_blank_lines report end of file (PR #2325)
• don't mix return type of Parser.build_block method (PR #2328)
• don't track eof state in reader (PR #2320)
• use shift instead of advance to consume line when return value isn't needed (PR #2322)
• replace terminology "floating title" with "discrete heading"
• remove unnecessary nil_or_empty? checks in substitutor
• leverage built-in assert / refute methods in test suite

Build / Infrastructure

• config Travis CI job to release gem (PR #2333)
• add SHA1 hash to message used for triggered builds
• trigger build of AsciidoctorJ on every change to core
• trigger build of Asciidoctor Diagram on every change to core

Release meta

Released on: 2017-07-23
Released by: @mojavelinux
Release beer: She'brew Double IPA

Logs: resolved issues | full diff

Credits

Thanks to the following people who contributed to this release:

@Mogztter, @JBR69, @robertpanzer, @ztmr, and @pepijnve.

Special thanks goes to @vogella for providing additional financial support following the 1.5.6 release.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release and the ongoing development of the project.

v1.5.6

This iteration began as a minor release and morphed into one of the most important and substantial releases to date. This release brings several landmark features, major performance improvements (25% increase in speed), critical bug fixes, and lots of important internal restructuring.

The most recognizable new feature is surely the formal cross reference text (e.g., Figure 1, “Architecture”). To support this feature, the references table is now populated with nodes instead of just reference text, making it easier for extensions to use this information. Additionally, bibliography anchors now support reference text and more warnings have been added if references are invalid.

There are also major enhancements to partial includes, which can now be used to exclude in addition to including tagged regions. In the area of security, rel="noopener" attribute is added to all links that target _blank. Block extensions now have access to the context of the block that was matched via the cloaked-context attribute. In the bug category, complex content on callout list items is retained in HTML output, the operation logic for ifndef has been made compliant, lines that shouldn't be recognized aren't, and substitutions are applied more consistently and accurately.

But that's just a partial summary. To get the whole story, check out the changelog below.

Distributions

• RubyGem (asciidoctor)

Asciidoctor is also packaged for Fedora, Debian, Ubuntu, Mint, Alpine Linux, and OpenSUSE. Please use the system's package manager to install the package named asciidoctor.

Changelog

Enhancements

• use custom cross reference text if xrefstyle attribute is set (full, short, basic) (#858, #1132)
• store referenceable nodes under refs key in document catalog (PR #2220)
• apply reftext substitutions (specialchars, quotes, replacements) to value returned by reftext method (PR #2220)
• add xreftext method to AbstractBlock, Section, and Inline to produce formatted text for xref (PR #2220)
• introduce attributes chapter-refsig, section-refsig, and appendix-refsig to set reference signifier for chapter, section, and appendix, respectively (PR #2220)
• add rel="noopener" to links that target _blank or when noopener option is set (#2071)
• add option to exclude tags when including a file (#1516)
• add meta for shortcut icon if favicon attribute is set (#1574)
• allow use of linenums option to enable line numbers on a source block (#1981)
• allow extension groups to be unregistered individually (#1701)
• catalog bibliography anchors and capture reftext (#560, #1562)
• automatically add bibliography style to unordered list in bibliography section (#1924)
• disable startinline option when highlighting PHP if mixed option is set on source block (PR #2015) (@ricpelo)
• configure Slim to resolve includes in specified template dirs (#2214)
• dump manpage when -h manpage flag is passed to CLI (#2302)
• add resolves_attributes method to DSL for macros (#2122)
• invoke convert on result of custom inline macro if value is an inline node (#2132)
• resolve attributes for custom short inline macros if requested (#1797)
• add convenience method to create section from extension; use same initialization logic as parser (#1957)
• add handles? method to DSL for IncludeProcessor (#2119)
• pass through preload attribute to video tag (#2046)
• add start and end times for audio element (#1930)
• set localyear and docyear attributes (#1372)
• pass cloaked context to block extension via cloaked-context attribute (#1606)
• add support for covers in DocBook 5 converter (#1939)
• accept named pipe (fifo) as the input file (#1948)
• add AbstractBlock#next_adjacent_block helper method
• rename Document#references to catalog; alias references to catalog (PR #2237)
• rename extensions_registry option to extension_registry
• rename Extensions.build_registry method to create
• autoload extensions source file when Asciidoctor::Extensions is referenced (PR #2114, PR #2312)
• apply default_attrs to custom inline macro (PR #2127)
• allow tab separator for table to be specified using \t (#2073)
• add Cell#text= method

Improvements

• significant improvements to performance, especially in parser and substitutors
• process include directive inside text of short form preprocessor conditional (#2146)
• add support for include tags in languages that only support only circumfix comments (#1729)
• allow spaces in target of block image; target must start and end with non-space (#1943)
• add warning in verbose mode if xref is not found (@fap-) (#2268)
• add warning if duplicate ID is detected (#2244)
• validate that output file will not overwrite input file (#1956)
• include docfile in warning when stylesheet cannot be read (#2089)
• warn if doctype=inline is used and block has unexpected content model (#1890)
• set built-in docfilesuffix attribute (#1673)
• make sourcemap field on Document read/write (#1916)
• allow target of xref to begin with attribute reference (#2007)
• allow target of xref to be expressed with leading # (#1546)
• allow kbd and btn macros to wrap across multiple lines (#2249)
• allow menu macro to span multiple lines; unescape escaped closing bracket
• make menu macro less greedy
• allow ampersand to be used as the first character of the first segment of a menu (#2171)
• enclose menu caret in HTML tag (#2165)
• use black text for menu reference; tighten word spacing (#2148)
• fix parsing of keys in kbd macro (PR #2222)
• add support for the window option for the link on a block image (#2172)
• set correct level for special sections in parser (#1261)
• always set numbered property on appendix to true
• store number for formal block on node (#2208)
• set sectname of header section to header (#1996)
• add the remove_attr method to AbstractNode (#2227)
• use empty string as default value for set_attr method (#1967)
• make start argument to system_path optional (#1965)
• allow API to control subs applied to ListItem text (#2035)
• allow text of ListItem to be assigned (in an extension) (#2033)
• make generate_id method on section a static method (#1929)
• validate name of custom inline macro; cache inline macro rx (#2136)
• align number in conum list to top by default (#1999)
• fix CSS positioning of interactive checkbox (#1840)
• fix indentation of list items when markers are disabled (none, no-bullet, unnumbered, unstyled) (PR #2286)
• instruct icon to inherit cursor if inside a link
• close all files opened internally (#1897)
• be more precise about splitting kbd characters (#1660)
• rename limit method on String to limit_bytesize (#1889)
• leverage Ruby's match? method to speed up non-capturing regexps (PR #1938)
• preserve inline break in manpages (@letheed)
• check for presence of SOURCE_DATE_EPOCH instead of value; fail if value is malformed
• add Rows#by_section method to return table sections (#2219)
• cache which template engines have been loaded to avoid unnecessary processing
• rename assign_index method to enumerate_section (PR #2242)
• don't process double quotes in xref macro (PR #2241)
• optimize attr and attr? methods (PR #2232)
• use IO.write instead of File.open w/ block; backport for Opal
• backport IO.binread to Ruby 1.8.7 to avoid runtime check
• cache backend and doctype values on document
• allow normalize option to be set on PreprocessorReader; change default to false
• move regular expression constants for Opal to Asciidoctor.js build (PR #2070)
• add missing comma in warning message for callout list item out of sequence
• combine start_with? / end_with? checks into a single method call
• rename UriTerminator constant to UriTerminatorRx
• promote subs to top-level constants; freeze arrays
• rename PASS_SUBS constant to NONE_SUBS
• rename EOL constant to LF (retain EOL as alias)
• rename macro regexp constants so name follows type (e.g., InlineImageMacroRx)

Compliance

• retain block content in items of callout list when converting to HTML and man page (#1478)
• only substitute specialchars for content in literal table cells (#1912)
• fix operator logic for ifndef directive with multiple attributes (#1983)
• only recognize uniform underline for setext section title (#2083)
• don't match headings with mixed leading characters (#2074)
• fix layout break from matching lines it shouldn't
• fix behavior of attribute substitution in docinfo content (PR #2296)
• encode spaces in URI (PR #2274)
• treat empty string as a valid block title
• preprocess lines of a simple block (#1923)
• don't drop trailing blank lines when splitting source into lines (PR #2045)
• only drop known AsciiDoc extensions from the inter-document xref path (#2217)
• don't number special sections or special subsections by default (#2234)
• assign sectname based on name of manuscript element (#2206)
• honor leveloffset when resolving implicit doctitle (#2140)
• permit leading, trailing, and repeat operators in target of preprocessor conditional (PR #2279)
• don't match link macro in block form (i.e., has two colons after prefix) (#2202)
• do not match bibliography anchor that begins with digit (#2247)
• use [ \t] (or \s) instead of \p{Blank} to match spaces (#2204)
• allow named entity to have trailing digits (e.g., there4) (#2144)
• only assign style to image alt text if alt text is not specified
• substitute replacements in non-generated alt text of block image (PR #2285)
• keep track of whether alt text is auto-generated by assigning default-alt attribute (PR #2287)
• suppress info element in docbook output if noheader attribute is set (#2155)
• preserve leading indentation in literal and verse table cells (#2037)
• preserve whitespace in literal and verse table cells (#2029)
• set doctype-related attribut...

v1.5.5

Primarily a bug, compatibility, and security fix release, this update also introduces a full set of translations for built-in labels thanks to our awesome community! Additionally, during this release cycle, @diguage contributed a Chinese translation of the README and @Mizuho32 contributed a Japanese translation of the README.

Distributions

• RubyGem (asciidoctor)

Asciidoctor is also packaged for Fedora, Debian, Ubuntu, Mint, Alpine Linux, and OpenSUSE. Please use the system's package manager to install the package named asciidoctor.

Changelog

Enhancements

• Add preference to limit the maximum size of an attribute value (#1861)
• Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (@JojoBoulix) (#1721)
• Add reversed attribute to ordered list if reversed option is enabled (#1830)
• Add support for additional docinfo locations (e.g., :header)
• Configure default stylesheet to break monospace word if exceeds length of line; add roles to prevent breaks (#1814)
• Introduce translation file for built-in labels (@ciampix)
• Provide translations for built-in labels in 21 languages:
  • kr - @JmyL
  • it - @ciampix
  • bg - @ivannov
  • da - @maxandersen
  • pt - @radcortez
  • es - @eddumelendez
  • jp - @leathersole
  • no - @aslakknutsen
  • fa - @shahryareiv
  • ru - @AlexanderZobkov
  • zh - @dongwq
  • pt_BR - @rmpestano
  • fr - @ncomet
  • fi - @lgvz
  • hu - @patoi
  • sr - @BojanStipic
  • de - @fwilhe
  • tr - @rahmanusta
  • ca - @abelsromero
  • ar - @aboullaite
  • nl - @roelvs
• Translate README to Chinese (@diguage)
• Translate README to Japanese (@Mizuho32)

Improvements

• Style nested emphasized phrases properly when using default stylesheet (#1691)
• Honor explicit table width even when autowidth option is set (#1843)
• Only explicit noheader option on table should disable implicit table header (#1849)
• Support docbook orient="land" attribute on tables (#1815)
• Add alias named list to retrieve parent List of ListItem
• Update push_include method to support chaining (#1836)
• Enable font smoothing on Firefox on OSX (#1837)
• Support combined use of sectanchors and sectlinks in HTML5 output (#1806)
• fix API docs for find_by
• Upgrade to Font Awesome 4.6.3 (@allenan, @mogztter) (#1723)
• README: add install instructions for Alpine Linux
• README: Switch yum commands to dnf in README
• README: Mention Mint as a Debian distro that packages Asciidoctor
• README: Add caution advising against using gem update to update a system-managed gem (@oddhack)
• README: sync French version with English version (@flashcode)
• Add missing endline after title element when converting open block to HTML
• Move list_marker_keyword method from AbstractNode to AbstractBlock
• Rename definition list to description list internally

Compliance

• Support 6-digit decimal char refs, 5-digit hexidecimal char refs (#1824)
• Compatibility fixes for Opal
• Check for number using Integer instead of Fixnum class for compatibility with Ruby 2.4

Bug fixes

• Use method_defined? instead of respond_to? to check if method is already defined when patching (#1838)
• Fix invalid conditional in HTML5 converter when handling of SVG
• Processor#parse_content helper no longer shares attribute list between blocks (#1651)
• Fix infinite loop if unordered list marker is immediately followed by a dot (#1679)
• Don't break SVG source when cleaning if svg start tag name is immediately followed by endline (#1676)
• Prevent template converter from crashing if .rb file found in template directory (#1827)
• Fix crash when generating section ID when both idprefix & idseparator are blank (#1821)
• Use stronger CSS rule for general text color in Pygments stylesheet (#1802)
• Don't duplicate forward slash for path relative to root (#1822)

Infrastructure

• Build gem properly in the absense of a git workspace, make compatible with JRuby (#1779)
• Run tests in CI using latest versions of Ruby, including Ruby 2.3 (@ferdinandrosario)

Release meta

Released on: 2016-10-05
Released by: @mojavelinux
Release beer: Boulevard Rye-on-Rye X - Sazerac (2016)

Logs: resolved issues | full diff

Credits

Thanks to the following people who contributed to this release:

@JmyL, @ciampix, @ivannov, @maxandersen, @radcortez, @eddumelendez, @leathersole, @aslakknutsen, @shahryareiv, @AlexanderZobkov, @dongwq, @rmpestano, @ncomet, @lgvz, @patoi, @BojanStipic, @fwilhe, @rahmanusta, @abelsromero, @aboullaite, @roelvs, @gjtorikian, @thoragan, @pavs, @bk2204, @jojoboulix, @mogztter and @andya9.

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.4

Primarily a bug fix release that includes numerous improvements to the manpage converter thanks to @ds26gte, upgraded Font Awesome and MathJax components, compatibility changes for Asciidoctor.js and other bug fixes.

During this release cycle, a French translation of the README was contributed by @anthonny and revised by @Mogztter, @gscheibel and @mgreau. The French translation is the first translation of this document.

Distributions

• RubyGem (asciidoctor)
• Fedora RPM (asciidoctor)

Changelog

Enhancements

• translate README into French (@anthonny, @mogztter, @gscheibel, @mgreau) (#1630)
• allow linkstyle in manpage output to be configured (#1610)

Improvements

• upgrade to MathJax 2.6.0 and disable loading messages
• upgrade to Font Awesome 4.5.0
• disable toc if document has no sections (#1633)
• convert inline asciimath to MathML (using asciimath gem) in DocBook converter (#1622)
• add attribute to control build reproducibility (@bk2204) (#1453)
• recognize file:/// as a file root in Opal browser env (#1561)
• honor icon attribute on admonition block when font-based icons are enabled (@robertpanzer) (#1593)
• resolve custom icon relative to iconsdir; add file extension if absent (#1634)
• allow asciidoctor cli to resolve library path when invoked without leading ./

Compliance

• allow special section to be nested at any depth (#1591)
• ensure colpcwidth values add up to 100%; increase precision of values to 4 decimal places (#1647)
• ignore blank cols attribute on table (#1647)
• support shorthand syntax for block attributes on document title (#1650)

Bug fixes

• don't include default toc in AsciiDoc table cell; don't pass toc location attributes to nested document (#1582)
• guard against nil dlist list item in find_by (#1618)
• don't swallow trailing line when include file is not readable (#1602)
• change xlink namespace to xl in DocBook 5 output to prevent parse error (#1597)
• make callouts globally unique within document, including AsciiDoc table cells (#1626)
• initialize Slim-related attributes regardless of when Slim was loaded (@terceiro) (#1576)
• differentiate literal backslash from escape sequence in manpage output (@ds26gte) (#1604)
• don't mistake line beginning with . for troff macro in manpage output (@ds26gte) (#1589)
• escape leading dots so user content doesn't trigger troff macros in manpage output (@ds26gte) (#1631)
• use \c after .URL macro to remove extraneous space in manpage output (@ds26gte) (#1590)
• fix missing endline after .URL macro in manpage output (#1613)
• properly handle spacing around .URL/.MTO macro in manpage output (@ds26gte) (#1641)
• don't swallow doctitle attribute followed by block title (#1587)
• change strategy for splitting names of author; fixes bug in Opal/Asciidoctor.js
• don't fail if library is loaded more than once

Infrastructure

• remove trailing endlines in project source code
• update contributing guidelines
• explicitly test ifeval scenario raised in issue #1585
• remove backreference substitution hack for Opal/Asciidoctor.js
• fix assignment of default Hash value for Opal/Asciidoctor.js
• add JRuby 9.0.4.0 and Ruby 2.3.0 to the Travis CI build matrix

Release meta

Released on: 2016-01-05
Released by: @mojavelinux
Release beer: Depth-Charged Double Bastard (2015)

Logs: resolved issues | full diff

Credits

Thanks to the following people who contributed to this release:

Dorai Sitaram (@ds26gte), Guillaume Grossetie (@mogztter), brian m. carlson (@bk2204), Leif Gruenwoldt (@leif81), Jens Getreu (@getreu), Anthonny Quérouil (@anthonny), Robert Panzer (@robertpanzer), Jean-Michel Bruel (@jmbruel), Guillaume Scheibel (@gscheibel), Dave Smith (@devunwired), Willem Salembier (@wsalembi)

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.3

A 1.5.x micro substantial release that introduces a few key enhancements as well as many bug fixes, minor improvements and internal changes. Specifically, this release adds advanced support for SVGs, no more swallowed exceptions, a built-in manpage backend, AsciiMath conversion DocBook through integration with the asciimath gem, more understandable docinfo configuration and a slew of fixes and improvements.

Distributions

• RubyGem (asciidoctor)
• Fedora RPM (asciidoctor)

Changelog

Enhancements

• add support for interactive & inline SVGs (#1301, #1224)
• add built-in manpage backend (@DavidGamba) (#651)
• create Mallard backend; see asciidoctor-mallard (@bk2204) (#425)
• add AsciiMath to MathML converter to support AsciiMath in DocBook converter (@pepijnve) (#954)
• allow text of selected lines to be highlighted in source block by Pygments or CodeRay (#1429)
• use value of docinfo attribute to control docinfo behavior (#1510)
• add docinfosubs attribute to control which substitutions are performed on docinfo files (@mogztter) (#405)
• drop ability to specify multiple attributes with a single -a flag when using the CLI (@mogztter) (#405)
• make subtitle separator chars for document title configurable (@rmannibucau) (#1350)
• make XrefInlineRx regexp more permissive (Mathieu Boespflug) (#844)

Improvements

• load JavaScript and CSS at bottom of HTML document (@mogztter) (#1238)
• list available backends in help text (@plaindocs) (#1271)
• properly expand tabs in literal text (#1170, #841)
• add source-indent as document attribute (@mogztter) (#1169)
• upgrade MathJax to 2.5.3 (#1329)
• upgrade Font Awesome to 4.4.0 (@mogztter) (#1465)
• upgrade highlight.js to 8.6 (now 8.9.1) (#1390)
• don't abort if syntax highlighter isn't available (#1253)
• insert docinfo footer below footer div (#1503)
• insert toc at default location in embeddable HTML (#1443)
• replace _ and - in generated alt text for inline images
• restore attributes to header attributes after parse (#1255)
• allow docdate and doctime to be overridden (#1495)
• add CSS class .center for center block alignment (#1456)
• recognize U+2022 (bullet) as alternative marker for unordered lists (@mogztter) (#1177)
• allow videos to work for local files by prepending asset-uri-scheme (Chris) (#1320)
• always assign playlist param when loop option is enabled for YouTube video
• parse isolated version in revision line (@bk2204) (#790)
• autoload Tilt when template converter is instantiated (#1313)
• don't overwrite existing id entry in references table (#1256)
• use outfilesuffix attribute defined in header when resolving outfile (#1412)
• make AsciiDoc safe mode option on Slim engine match document (#1347)
• honor htmlsyntax attribute when backend is html/html5 (#1530)
• tighten spacing of wrapped lines in TOC (#1542)
• tune padding around table cells in horizontal dlist (#1418)
• load Droid Sans Mono 700 in default stylesheet
• set line height of table cells used for syntax highlighting
• set font-family of kbd; refine styling (#1423)
• extract condition into quote_lines? method (@mogztter)
• extract inline code into read_paragraph method (@mogztter)
• parent of block in ListItem should be ListItem (#1359)
• add helper methods to List and ListItem (#1551)
• add method AbstractNode#add_role and AbstractNode#remove_role (@robertpanzer) (#1366)
• introduce helper methods for sniffing URIs (#1422)
• add helper to calculate basename without file extension
• document -I and -r options in the manual page (@bk2204)
• fix --help output text for -I (@bk2204)
• don't require open-uri-cached if already loaded
• do not attempt to scan pattern of non-existent directory in template converter
• prevent CodeRay from bolding every 10th line number

Compliance

• use <sup> for footnote reference in text instead of <span> (#1523)
• fix alignment of wrapped text in footnote (#1524)
• include full stop after footnote number in embeddable HTML
• show manpage title & name section in embeddable HTML (#1179)
• resolve missing attribute in ifeval to empty string (#1387)
• support unbreakable & breakable options on table (rockyallen) (#1140)

Bug fixes

• don't truncate exception stack in Asciidoctor.load (#1248)
• don't fail to save cause of Java exception (@robertpanzer) (#1458)
• fix precision error in timings report (#1342)
• resolve regexp for inline macro lazily (#1336)
• block argument to find_by should filter results (#1393)
• strip comment lines in indented text of dlist item (#1537)
• preserve escaped delimiter at end of line in a table (#1306)
• correctly calculate colnames for implicit columns (#1556)
• don't crash if colspan exceeds colspec (#1460)
• account for empty records in colspec (#1375)
• ignore empty cols attribute on table
• use .inspect to print MathJax delimiters (again) (#1198)
• use while loop instead of begin/while loop to address bug in Asciidoctor.js (#1408)
• force encoding of attribute values passed from cli (#1191)
• don't copy css if stylesheet or stylesdir is a URI (#1400)
• fix invalid color value in default CodeRay theme
• built-in writer no longer fails if output is nil (#1544)
• custom template engine options should take precedence
• fallback to require with a non-relative path to support Debian package (@mogztter)
• pass opts to recursive invocations of PathResolver#system_path
• fix and test external links in docbook backend
• use format symbol :html instead of :html5 for Slim to fix warnings
• fix documentation for inline_macro and block_macro (Andrea Bedini)
• fix grammar in warning messages regarding thread_safe gem

Infrastructure

• migrate opal_ext from core to Asciidoctor.js (#1517)
• add Ruby 2.2 to CI build; only specify minor Ruby versions
• enable containerized builds on Travis CI
• add config to run CI build on AppVeyor
• exclude benchmark folder from gem (#1522)

Release meta

Released on: 2015-10-31
Released by: @mojavelinux
Release beer: St Bernardus Abt 12

Logs: resolved issues | full diff

Credits

Thanks to the following people who contributed to this release:

Jakub Jirutka (@jirutka), roel van steenberghe (@roelvs), Chris K Wensel (@cwensel), Konrad Malawski (@ktoso), Tobias Roeser (@lefou), Thomas Kern (@nerk), Robert Panzer (@robertpanzer), Katrina Owen (@kytrinyx), Pepijn Van Eeckhoudt (@pepijnve), Kendall Clark (@kendall), Alex Soto (@lordofthejars), Abel Salgado Romero (@abelsromero), Bela Hausmann (@and3k), Rob Winch (@rwinch), Mathieu Boespflug (@mboes), Chris (@crydalch), Jason Rose-Kuhrt (@jasonkuhrt), brian m. carlson (@bk2204), David Baldwin (@davebaldwin), Samual Wright (@plaindocs), David Gamba (@DavidGamba), Stephen Hay (@stephenhay), Sol Bekic (@s0lll0s), Jakub Nawalaniec (@pielgrzym), Bruce Momjian (@bmomjian), Phil Webb (@philwebb), James Carlson (@jxxcarlson), Joel C. Salomon (@jcsalomon), Guillaume Grossetie (@mogztter), Sarah White (@graphitefriction), Ken Dreyer (@ktdreyer)

A very special thanks to all the awesome supporters of the Asciidoctor Salt campaign who provided critical funding for the development of this release as well as ongoing development of the project.

v1.5.2

A 1.5.x micro release that introduce bug fixes, minor enhancements and improvements and internal changes. This release introduces several improvements to docinfo, including better encoding support, configurable docinfo directory and a docinfo extension point.

Changelog

Enhancements

• add docinfo extension (@mogztter) (#1162)
• allow docinfo to be in separate directory from content, specified by docinfodir attribute (@mogztter) (#511)
• enable TeX equation auto-numbering if eqnums attribute is set (@jxxcarlson) (#1110)

Improvements

• recognize -- as valid line comment for callout numbers; make line comment configurable (#1068)
• upgrade highlight.js to version 8.4 (#1216)
• upgrade Font Awesome to version 4.2.0 (@clojens) (#1201)
• define JAVASCRIPT_PLATFORM constant to simplify conditional logic in the JavaScript environment (#897)
• provide access to destination directory, outfile and outdir via Document object (#1203)
• print encoding information in version report produced by asciidoctor -v (#1210)
• add intrinsic attribute named cpp with value C++ (#1208)
• preserve URI targets passed to stylesheet and related attributes (#1192)
• allow numeric characters in block attribute name (#1103)
• support custom YouTube playlists (#1105)
• make start number for unique id generation configurable (#1148)
• normalize and force UTF-8 encoding of docinfo content (#831)
• allow subs and default_subs to be specified in Block constructor (#749)
• enhance error message when reading binary input files (@mogztter) (#1158)
• add append method as alias to << method on AbstractBlock (#1085)
• assign value of preface-title as title of preface node (#1090)
• fix spacing around checkbox in checklist (#1138)
• automatically load Slim's include plugin when using slim templates (@jirutka) (#1151)
• mixin Slim helpers into execution scope of slim templates (@jirutka) (#1143)
• improve DocBook output for manpage doctype (@bk2204) (#1134, #1142)

Compliance

• substitute attribute entry value in attributes defined outside of header (#1130)
• allow empty cell to appear at end of table row (#1106)
• only produce one row for table in CSV or DSV format with a single cell (#1180)

Bug fixes

• add explicit to_s call to generate delimiter settings for MathJax config (#1198)
• fix includes that reference absolute Windows paths (#1144)
• apply DSL to extension block in a way compatible with Opal

Distributions

• RubyGem (asciidoctor)

Release meta

Released on: 2014-11-27
Released by: @mojavelinux
Release beer: Avery 5 Monks

Logs: resolved issues | full diff

v1.5.1

A 1.5.x micro release that introduce bug fixes, minor improvements and internal changes.

Changelog

Bug fixes

• recognize tag directives inside comments within XML files for including tagged regions
• restore passthroughs inside footnotes when more than one footnote appears on the same line
• -S flag in cli recognizes safe mode name as lowercase string
• do not match # in character reference when looking for marked text
• add namespace to lang attribute in DocBook 5 backend
• restore missing space before conum on last line of listing when highlighting with Pygments
• place conums on correct lines when line numbers are enabled when highlighting with Pygments
• don't expand mailto links in print styles

Improvements

• implement File.read in Node (JavaScript) environment
• assign sectnumlevels and toclevels values to maxdepth attribute on AsciiDoc processing instructions in DocBook output
• add test for usage of image block macro with data URI
• use badges from shields.io in README

Release meta

Released on: 2014-09-19
Released by: @mojavelinux
Release beer: Delirium Tremens

Logs: resolved issues | full diff

v1.5.0

Asciidoctor 1.5.0 is a stable major release and sequel to 0.1.4. We shifted the numbers to adopt a semantic versioning scheme and communicate that this release is well beyond stable.

Changelog

See http://asciidoctor.org/news/2014/08/12/asciidoctor-1-5-0-released for more details about this release.

Release meta

Released on: 08-12-2014
Released by: @mojavelinux
Release beer: St. Bernardus Abt 12

v1.5.0 Release Candidate 2

The second release candidate for the upcoming 1.5.0 release. Includes compatibility fixes for compiling Asciidoctor.js.

v1.5.0 Release Candidate 1

The first release candidate for the long-awaited Asciidoctor 1.5.0 release. Only minor changes and bug fixes will be made between this version and the final release.