RubyGems - asciidoctor - Versions diffs - 1.5.6.2 → 1.5.7 - Mend

asciidoctor 1.5.6.2 → 1.5.7

Potentially problematic release.

This version of asciidoctor might be problematic. Click here for more details.

Files changed (112) hide show

checksums.yaml +4 -4
data/CHANGELOG.adoc +330 -143
data/README-fr.adoc +441 -0
data/README-jp.adoc +418 -0
data/README-zh_CN.adoc +430 -0
data/README.adoc +454 -0
data/Rakefile +57 -0
data/asciidoctor.gemspec +7 -1
data/data/locale/attributes-ar.adoc +22 -0
data/data/locale/attributes-bg.adoc +22 -0
data/data/locale/attributes-ca.adoc +22 -0
data/data/locale/attributes-cs.adoc +22 -0
data/data/locale/attributes-da.adoc +22 -0
data/data/locale/attributes-de.adoc +22 -0
data/data/locale/attributes-en.adoc +23 -0
data/data/locale/attributes-es.adoc +22 -0
data/data/locale/attributes-fa.adoc +22 -0
data/data/locale/attributes-fi.adoc +22 -0
data/data/locale/attributes-fr.adoc +22 -0
data/data/locale/attributes-hu.adoc +22 -0
data/data/locale/attributes-id.adoc +22 -0
data/data/locale/attributes-it.adoc +22 -0
data/data/locale/attributes-ja.adoc +22 -0
data/data/locale/attributes-kr.adoc +22 -0
data/data/locale/attributes-nb.adoc +22 -0
data/data/locale/attributes-nl.adoc +22 -0
data/data/locale/attributes-nn.adoc +22 -0
data/data/locale/attributes-pl.adoc +22 -0
data/data/locale/attributes-pt.adoc +22 -0
data/data/locale/attributes-pt_BR.adoc +22 -0
data/data/locale/attributes-ro.adoc +22 -0
data/data/locale/attributes-ru.adoc +22 -0
data/data/locale/attributes-sr.adoc +22 -0
data/data/locale/attributes-sr_Latn.adoc +22 -0
data/data/locale/attributes-tr.adoc +22 -0
data/data/locale/attributes-uk.adoc +22 -0
data/data/locale/attributes-zh_CN.adoc +22 -0
data/data/locale/attributes-zh_TW.adoc +22 -0
data/data/locale/attributes.adoc +8 -649
data/data/stylesheets/asciidoctor-default.css +77 -72
data/features/xref.feature +366 -7
data/lib/asciidoctor.rb +107 -93
data/lib/asciidoctor/abstract_block.rb +247 -239
data/lib/asciidoctor/abstract_node.rb +56 -58
data/lib/asciidoctor/block.rb +3 -3
data/lib/asciidoctor/callouts.rb +1 -1
data/lib/asciidoctor/cli/invoker.rb +36 -9
data/lib/asciidoctor/cli/options.rb +63 -25
data/lib/asciidoctor/converter.rb +23 -13
data/lib/asciidoctor/converter/base.rb +4 -0
data/lib/asciidoctor/converter/docbook45.rb +16 -9
data/lib/asciidoctor/converter/docbook5.rb +115 -97
data/lib/asciidoctor/converter/factory.rb +29 -31
data/lib/asciidoctor/converter/html5.rb +229 -192
data/lib/asciidoctor/converter/manpage.rb +72 -50
data/lib/asciidoctor/converter/template.rb +12 -12
data/lib/asciidoctor/core_ext.rb +5 -1
data/lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb +6 -0
data/lib/asciidoctor/document.rb +168 -77
data/lib/asciidoctor/extensions.rb +79 -47
data/lib/asciidoctor/helpers.rb +33 -11
data/lib/asciidoctor/inline.rb +3 -2
data/lib/asciidoctor/list.rb +2 -1
data/lib/asciidoctor/logging.rb +122 -0
data/lib/asciidoctor/parser.rb +406 -382
data/lib/asciidoctor/path_resolver.rb +169 -162
data/lib/asciidoctor/reader.rb +166 -121
data/lib/asciidoctor/section.rb +45 -28
data/lib/asciidoctor/stylesheets.rb +13 -5
data/lib/asciidoctor/substitutors.rb +328 -254
data/lib/asciidoctor/table.rb +105 -48
data/lib/asciidoctor/timings.rb +34 -6
data/lib/asciidoctor/version.rb +1 -1
data/man/asciidoctor.1 +41 -23
data/man/asciidoctor.adoc +14 -8
data/test/api_test.rb +1004 -0
data/test/attributes_test.rb +241 -50
data/test/blocks_test.rb +549 -124
data/test/converter_test.rb +170 -78
data/test/document_test.rb +208 -767
data/test/extensions_test.rb +188 -53
data/test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim +1 -1
data/test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim +1 -1
data/test/fixtures/file-with-missing-include.adoc +1 -0
data/test/fixtures/include-file.jsx +8 -0
data/test/fixtures/lists.adoc +96 -0
data/test/fixtures/other-chapters.adoc +11 -0
data/test/fixtures/outer-include.adoc +5 -0
data/test/fixtures/sample.asciidoc +5 -1
data/test/fixtures/subdir/index.adoc +3 -0
data/test/fixtures/subdir/inner-include.adoc +3 -0
data/test/fixtures/subdir/middle-include.adoc +5 -0
data/test/fixtures/tagged-class-enclosed.rb +0 -1
data/test/fixtures/unclosed-tag.adoc +3 -0
data/test/fixtures/unexpected-end-tag.adoc +4 -0
data/test/invoker_test.rb +101 -40
data/test/links_test.rb +266 -72
data/test/lists_test.rb +243 -45
data/test/logger_test.rb +211 -0
data/test/manpage_test.rb +124 -6
data/test/options_test.rb +46 -1
data/test/paragraphs_test.rb +23 -10
data/test/parser_test.rb +30 -1
data/test/paths_test.rb +115 -33
data/test/preamble_test.rb +1 -1
data/test/reader_test.rb +337 -81
data/test/sections_test.rb +656 -72
data/test/substitutions_test.rb +182 -57
data/test/tables_test.rb +324 -57
data/test/test_helper.rb +77 -32
data/test/text_test.rb +7 -7
metadata +67 -3

checksums.yaml CHANGED

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f10e996f01e533b8275c7800b7ce6a8c69d429d0454e8e01cce5c69316344d09
-  data.tar.gz: e4c1ef809b961b43a27d078c3066b2ad4ecdebc9338a40b7359073e33ad352ed
+  metadata.gz: 4c9adee957fdfaa129f4d6ddfc82ae51a1352ea6b3cdd6ac094651099be3e4c7
+  data.tar.gz: a193373b8636c2a7196761d0d05cd3c2e3dfb62a4cf304064cc522e3d274c826
 SHA512:
-  metadata.gz: 22fb1fac684b21d3710c1063fef30603a65c0a8e222a89401811a6caee7942702db606cf21403bf3869dfb43e388a56aff8f5cdcbb0d2e3a4ec34915c0952a6b
-  data.tar.gz: 85eb15b1ea8e731e29c21af82468e24f09975c28b101809e90096c9e83cd291429961c989ef528c7cf8f5cf7867935257f9ab7212f8857cb99384a0f93d1ab5e
+  metadata.gz: be33314441c4496231066060394f5df643de75f0ad7bbd02b37c474ef4dc451333e9bb21744d53c5267b11daf12fc9658ad12505f385ce3bcab4d18ce6d64941
+  data.tar.gz: 45272e1a562a3eb49e493a55545190cdf2a77af74668f154fe9a935b5ca7af3bd9878fa86cd298b9d0b1539b1c3b024b36855fbc0e672b6bd9be15b28ccf2fa5

data/CHANGELOG.adoc CHANGED

@@ -13,6 +13,183 @@ endif::[]
 This document provides a high-level view of the changes introduced in Asciidoctor by release.
 For a detailed view of what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
+== 1.5.7 (2018-05-02) - @mojavelinux
+Enhancements::
+  * BREAKING: drop XML tags, character refs, and non-word characters (except hyphen, dot, and space) when auto-generating section IDs (#794)
+   ** hyphen, dot, and space are replaced with value of idseparator, if set; otherwise, spaces are dropped
+  * allow attribute names to contain any word character defined by Unicode (#2376, PR #2393)
+  * route all processor messages through a logger instead of using Kernel#warn (#44, PR #2660)
+  * add MemoryLogger for capturing messages sent to logger into memory (#44, PR #2660)
+  * add NullLogger to prevent messages from being logged (#44, PR #2660)
+  * log message containing source location / cursor as an object; provides more context (#44, PR #2660)
+  * pass cursor for include file to `:include_location` key in message context (PR #2729)
+  * add `:logger` option to API to set logger instance (#44, PR #2660)
+  * add `--failure-level=LEVEL` option to CLI to force non-zero exit code if specified logging level is reached (#2003, PR #2674)
+  * parse text of xref macro as attributes if attribute signature found (equal sign) (#2381)
+  * allow xrefstyle to be specified per xref by assigning the xrefstyle attribute on the xref macro (#2365)
+  * recognize target with .adoc extension in xref macro as an interdocument xref
+  * resolve nested includes in remote documents relative to URI (#2506, PR #2511)
+  * allow `relfilesuffix` attribute to control file extension used for interdoc xrefs (#1273)
+  * support `!name@` (preferred), `!name=@`, `name!@`, and `name!=@` syntax to soft unset attribute from API or CLI (#642, PR #2649)
+  * allow modifier to be placed at end of name to soft set an attribute (e.g., `icons@=font`) (#642, PR #2649)
+  * interpret `false` attribute value defined using API as a soft unset (#642, PR #2649)
+  * number parts if `partnums` attribute is set (#2298)
+  * allow footnote macro to define or reference footnote reference (footnoteref macro now deprecated) (#2347, PR #2362)
+  * allow custom converter to be used with custom templates; converter must declare that it supports templates (#2619)
+  * allow manpage path for manpage help topic to be specified using ASCIIDOCTOR_MANPAGE_PATH environment variable (PR #2653) (*@aerostitch*)
+  * if manpage cannot be found in default path inside gem, use `man -w asciidoctor` to resolve installed path (PR #2653)
+  * uncompress contents of manpage for manpage help topic if path ends with .gz (PR #2653) (*@aerostitch*)
+  * define source and manual refmiscinfo entries in manpage output if manual and source attributes are defined (PR #2636) (*@tiwai*)
+  * add syntax for adding hard line breaks in block AsciiMath equations (#2497, PR #2579) (*@dimztimz*)
+  * add positioning option to sectanchors attribute (sectanchors=before or sectanchors=after) (#2485, PR #2486)
+  * allow table striping to be configured using stripes attribute (even, odd, all, or none) or stripes roles on table (#1365, PR #2588)
+  * recognize `ends` as an alias to `topbot` for configuring the table frame
+  * add rel=nofollow property to links (text or image) when nofollow option is set (#2605, PR #2692)
+  * populate Document#source_location when sourcemap option is enabled (#2478, PR #2488)
+  * populate source_location property on list items when sourcemap option is set on document (PR #2069) (*@mogztter*)
+  * populate Table::Cell#source_location when sourcemap option is enabled (#2705)
+  * allow local include to be flagged as optional by setting optional option (#2389, PR #2413)
+  * allow block title to begin with a period (#2358, PR #2359)
+  * catalog inline anchor at start of list items in ordered and unordered lists, description list terms, and table cells (#2257)
+  * register document in catalog if id is set; assign reftext to document attributes if specified in a block attribute line (#2301, PR #2428)
+  * allow automatic width to be applied to individual columns in a table using the special value `~` (#1844)
+  * use the quote element in DocBook converter to represent smart quotes (#2272, PR #2356) (@bk2204)
+  * parse and pass all manpage names to output document master (i.e., shadow man pages) (#1811, #2543, PR #2414)
+  * parse credit line of shorthand quote block as block attributes; apply normal subs to credit line in shorthand quote blocks (#1667, PR #2452)
+  * populate copyright element in DocBook output from value of copyright attribute (#2728)
+  * preserve directories if source dir and destination dir are set (#1394, PR #2421)
+  * allow linkcss to be unset from API or CLI when safe mode is secure
+  * convert quote to epigraph element in DocBook output if block has epigraph role (#1195, PR #2664) (*@bk2204*)
+  * number special sections in addition to regular sections when sectnums=all (#661, PR #2463)
+  * upgrade to Font Awesome 4.7.0 (#2569)
+  * upgrade to MathJax 4.7.4
+Bug fixes::
+  * set `:to_dir` option value correctly when output file is specified (#2382)
+  * preserve leading indentation in contents of AsciiDoc table cell if contents starts with a newline (#2712)
+  * the shorthand syntax on the style to set block attributes (id, roles, options) no longer resets block style (#2174)
+  * match include tags anywhere on line as long as offset by word boundary on left and space or newline on right (#2369, PR #2683)
+  * warn if an include tag specified in the include directive is unclosed in the included file (#2361, PR #2696)
+  * use correct parse mode when parsing blocks attached to list item (#1926)
+  * fix typo in gemspec that removed README and CONTRIBUTING files from the generated gem (PR #2650) (*@aerostitch*)
+  * preserve id, role, title, and reftext on open block when converting to DocBook; wrap in `<para>` or `<formalpara>` (#2276)
+  * don't turn bare URI scheme (no host) into a link (#2609, PR #2611)
+  * don't convert inter-document xref to internal anchor unless entire target file is included into current file (#2200)
+  * fix em dash replacement in manpage converter (#2604, PR #2607)
+  * don't output e-mail address twice when replacing bare e-mail address in manpage output (#2654, PR #2665)
+  * use alternate macro for monospaced text in manpage output to not conflict w/ AsciiDoc macros (#2751)
+  * enforce that absolute start path passed to PathResolver#system_path is inside of jail path (#2642, PR #2644)
+  * fix behavior of PathResolver#descends_from? when base path equals / (#2642, PR #2644)
+  * automatically recover if start path passed to PathResolver#system_path is outside of jail path (#2642, PR #2644)
+  * re-enable left justification after invoking tmac URL macro (#2400, PR #2409)
+  * don't report warning about same level 0 section multiple times (#2572)
+  * record timings when calling convert and write on Document (#2574, PR #2575)
+  * duplicate header attributes when restoring; allows header attributes to be restored an arbitrary number of times (#2567, PR #2570)
+  * propagate `:catalog_assets` option to nested document (#2564, PR #2565)
+  * preserve newlines in quoted CSV data (#2041)
+  * allow opening quote around quoted CSV field to be on a line by itself
+  * output table footer after body rows (#2556, PR #2566) (*@PauloFrancaLacerda*)
+  * move @page outside of @media print in default stylesheet (#2531, PR #2532)
+  * don't throw exception if text of dd node is nil (#2529, PR #2530)
+  * don't double escape ampersand in manpage output (#2525) (*@dimztimz*)
+  * fix crash when author_1 attribute is assigned directly (#2481, PR #2487)
+  * fix CSS for highlighted source block inside colist (#2474, PR #2490)
+  * don't append file extension to data uri of admonition icon (#2465, PR #2466)
+  * fix race condition in Helpers.mkdir_p (#2457, PR #2458)
+  * correctly process nested passthrough inside unconstrained monospaced (#2442, PR #2443)
+  * add test to ensure ampersand in author line is not double escaped (#2439, PR #2440)
+  * prevent footnote ID from clashing with auto-generated footnote IDs (#2019)
+  * fix alignment of icons in footnote (#2415, PR #2416)
+  * add graceful fallback if pygments.rb fails to return a value (#2341, PR #2342)
+  * escape specialchars in source if pygments fails to highlight (#2341)
+  * do not recognize attribute entry line if name contains colon (PR #2377)
+  * allow flow indexterm to be enclosed in round brackets (#2363, PR #2364)
+  * set outfilesuffix to match file extension of output file (#2258, PR #2367)
+  * add block title to dlist in manpage output (#1611, PR #2434)
+  * scale text to 80% in print styles (#1484, PR #2576)
+  * fix alignment of abstract title when using default stylesheet (PR #2732)
+  * only set nowrap style on table caption for auto-width table (#2392)
+  * output non-breaking space for man manual if absent in DocBook output (PR #2636)
+  * don't crash if stem type is not recognized (instead, fallback to asciimath)
+Improvements / Refactoring::
+  * BREAKING: rename table spread role to stretch (#2589, PR #2591)
+  * use cursor marks to track lines more accurately; record cursor at the start of each block, list item, or table cell (PR #2701, PR #2547) (*@seikichi*)
+  * log a warning message if an unterminated delimited block is detected (#1133, PR #2612)
+  * log a warning when nested section is found inside special section that doesn't support nested sections (#2433, PR #2672)
+  * read files in binary mode to disable automatic endline coercion (then explicitly coerce to UTF-8) (PR #2583, PR #2694)
+  * resolve / expand parent references in start path passed to PathResolver#system_path (#2642, PR #2644)
+  * update PathResolver#expand_path to resolve parent references (#2642, PR #2644)
+  * allow start path passed to PathResolver#system_path to be outside jail if target brings resolved path back inside jail (#2642, PR #2644)
+  * don't run File.expand_path on Dir.pwd (assume Dir.pwd is absolute) (#2642, PR #2644)
+  * posixify working_dir passed to PathResolver constructor if absolute (#2642, PR #2644)
+  * optimize detection for footnote* and indexterm* macros (#2347, PR #2362)
+  * log a warning if a footnote reference cannot be resolved (#2669)
+  * set logger level to DEBUG when verbose is enabled
+  * coerce value of `:template_dirs` option to an Array (PR #2621)
+  * make block roles specified using shorthand syntax additive (#2174)
+  * allow paragraph to masquerade as open block (PR #2412)
+  * move callouts into document catalog (PR #2394)
+  * document ID defined in block attribute line takes precedence over ID defined inside document title line
+  * don't look for link and window attributes on document when resolving these attributes for an image
+  * when linkattrs is set, only parse attributes in link macro if equals is present
+  * skip line comments in name section of manpage (#2584, PR #2585)
+  * always activate extension registry passed to processor (PR #2379)
+  * skip extension registry activation if no groups are registered (PR #2373)
+  * don't apply lead styling to first paragraph if role is present (#2624, PR #2625)
+  * raise clearer exception when extension class cannot be resolved (#2622, PR #2623)
+  * add methods to read results from timings (#2578, PR #2580)
+  * collapse bottom margin of last block in AsciiDoc table cell (#2568, PR #2593)
+  * set authorcount to 0 if there are no authors (#2519, PR #2520)
+  * validate fragment of interdoc xref that resolves to current doc (#2448, PR #2449)
+  * put id attribute on tag around phrase instead of preceding anchor (#2445, PR #2446)
+  * add .plist extension to XML circumfix comment family (#2430, PR #2431) (*@akosma*)
+  * alias Document#title method to no args Document#doctitle method (#2429, PR #2432)
+  * upgrade missing or unreadable include file to an error (#2424, PR #2426)
+  * add compliance setting to disable natural cross references (#2405, PR #2460)
+  * make hash in inter-document xref target optional if target has extension (#2404, PR #2406)
+  * add CSS class to part that matches role (#2401, PR #2402)
+  * add fit-content class to auto-width table (#2392)
+  * automatically assign parent reference when adding node to parent (#2398, PR #2403)
+  * leave inline anchor in section title as is if section has ID (#2243, PR #2427)
+  * align and improve error message about invalid use of partintro between HTML5 and DocBook converters
+  * rephrase warning when level 0 sections are found and the doctype is not book
+  * report correct line number when duplicate bibliography anchor is found
+  * only warn if thread_safe gem is missing when using built-in template cache
+  * rename enumerate_section to assign_numeral; update API docs
+  * drop deprecated compact option from CLI; remove from manpage
+  * use more robust mechanism for lazy loading the asciimath gem
+  * use consistent phrase to indicate the processor is automatically recovering from a problem
+  * change Reader#skip_comment_lines to not return skipped lines
+  * add styles to default stylesheet for display on Kindle (kf8) devices (PR #2475)
+  * purge render method from test suite (except to verify alias)
+Documentation::
+  * translate 'section-refsig' for German language (PR #2633) (*@ahus1*)
+  * synchronize French README with English version (PR #2637) (*@flashcode*)
+Build / Infrastructure::
+  * create an official logo for the project (#48) (*@mmajko*)
+  * update Ruby versions in appveyor build matrix (PR #2388) (*@miltador*)
+  * add mailinglist, changelog, source, and issues URI to gem spec
+  * allow blocks and substitutions tests to be run directly
+  * asciidoctor formula now available for Homebrew (*@zmwangx*)
+Distribution Packages::
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+  * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
+  * https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
 // tag::compact[]
 == 1.5.6.2 (2018-03-20) - @mojavelinux
@@ -26,7 +203,7 @@ Improvements / Refactoring::
   * resolve include target correctly in browser (xmlhttprequest IO module) (#2599, #2602)
   * extract method to resolve include path (allowing Asciidoctor.js to override) (#2610)
   * don't expand docdir value passed to API (#2518)
-  * check mandatory attributes when creating an image block (#2349)
+  * check mandatory attributes when creating an image block (#2349, PR #2355) (*@mogztter*)
   * drop is_ prefix from boolean methods in PathResolver (PR #2587)
   * change Reader#replace_next_line to return true
   * organize methods in AbstractNode
@@ -35,14 +212,15 @@ Build / Infrastructure::
   * clean up dependencies
   * add Ruby 2.5.0 to CI build matrix (PR #2528)
-  * update nokogiri to 1.8.0 for ruby >= 2.1 (PR #2380)
+  * update nokogiri to 1.8.0 for ruby >= 2.1 (PR #2380) (*@miltador*)
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+  * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.6.2[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.6.2[git tag] |
@@ -51,6 +229,10 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.6.1...v1.5.6.2[full diff
 == 1.5.6.1 (2017-07-23) - @mojavelinux
+Enhancements::
+  * Don't include title of special section in DocBook output if untitled option is set (e.g., dedication%untitled)
 Bug fixes::
   * continue to read blocks inside a delimited block after content is skipped (PR #2318)
@@ -91,14 +273,16 @@ Build / Infrastructure::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+  * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
+  * https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.6.1[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.6.1[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.6...v1.5.6.1[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.6\...v1.5.6.1[full diff]
 == 1.5.6 (2017-07-12) - @mojavelinux
@@ -115,7 +299,7 @@ Enhancements::
   * 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)
+  * 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)
@@ -143,7 +327,7 @@ Improvements::
   * 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 in verbose mode if xref is not found (#2268) (*@fapdash*)
   * 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)
@@ -179,7 +363,7 @@ Improvements::
   * 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)
+  * 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
@@ -247,6 +431,7 @@ Bug fixes::
   * don't allow table borders to cascade to nested tables (#2151)
   * escape special characters in reftext of anchor (#1694)
   * sanitize content of authors meta tag in HTML output (#2112)
+  * use correct line number in warning for invalid callout item reference (#2275)
   * fix stray marks added when unescaping unconstrained passthroughs (PR #2079)
   * don't confuse escaped quotes in CSV data as enclosing quotes (#2008)
   * don't activate implicit header if cell in first line of table contains a blank line (#1284, #644)
@@ -259,7 +444,7 @@ Bug fixes::
   * fix regression of not matching short form of custom block macro
   * encode double quotes in image alt text when used in an attribute (#2061)
   * encode double quote and strip XML tags in value of xreflabel attribute in DocBook converter (PR #2220)
-  * fix typo in base64 data (PR #2094) (@mogztter)
+  * fix typo in base64 data (PR #2094) (*@mogztter*)
   * permit pass macro to surround a multi-line attribute value with hard line breaks (#2211)
   * fix sequential inline anchor macros with empty reftext (#1689)
   * don't mangle compound names when document has multiple authors (#663)
@@ -269,8 +454,8 @@ Bug fixes::
   * remove max-width on the callout number icon (#1895)
   * eagerly add hljs class for highlight.js (#2221)
   * fix SOURCE_DATE_EPOCH lookup in Opal
-  * fix paths with file URI scheme are inevitably absolute (PR #1925) (@mogztter)
-  * only resolve file URLs when JavaScript IO module is xmlhttprequest (PR #1898) (@mogztter)
+  * fix paths with file URI scheme are inevitably absolute (PR #1925) (*@mogztter*)
+  * only resolve file URLs when JavaScript IO module is xmlhttprequest (PR #1898) (*@mogztter*)
   * fix formatting of video title in manpage converter
   * don't increment line number if peek_lines overruns buffer (fixes some cases when line number is off)
   * freeze extension processor instance, not class
@@ -279,54 +464,55 @@ Bug fixes::
 Documentation::
   * enable admonition icons in README when displayed on GitHub
-  * add German translation of chapter-label (PR #1920) (@fap-)
-  * add Ukrainian translation of built-in attributes (PR #1955) (@hedrok)
-  * add Norwegian Nynorsk translation; updated Norwegian Bokmål translation of built-in attributes (PR #2142) (@huftis)
-  * add Polish translation of built-in attributes (PR #2131) (@ldziedziul)
-  * add Romanian translation of built-in attributes (PR #2125) (@vitaliel)
-  * fix Japanese translation of built-in attributes (PR #2116) (@haradats)
-  * add Bahasa Indonesia translation of built-in labels (@triyanwn)
+  * add German translation of chapter-label (PR #1920) (*@fapdash*)
+  * add Ukrainian translation of built-in attributes (PR #1955) (*@hedrok*)
+  * add Norwegian Nynorsk translation; updated Norwegian Bokmål translation of built-in attributes (PR #2142) (*@huftis*)
+  * add Polish translation of built-in attributes (PR #2131) (*@ldziedziul*)
+  * add Romanian translation of built-in attributes (PR #2125) (*@vitaliel*)
+  * fix Japanese translation of built-in attributes (PR #2116) (*@haradats*)
+  * add Bahasa Indonesia translation of built-in labels (*@triyanwn*)
 Build / Infrastructure::
   * upgrade highlight.js to 9.12.0 (#1652)
-  * include entire test suite in gem (PR #1952) (@voxik)
-  * upgrade Slim development dependency to 3.0.x (PR #1953) (@voxik)
+  * include entire test suite in gem (PR #1952) (*@voxik*)
+  * upgrade Slim development dependency to 3.0.x (PR #1953) (*@voxik*)
   * upgrade Haml development dependency to 5.0.x
   * upgrade Nokogiri to 1.6.x (except on Ruby 1.8) (PR #1213)
   * add Ruby 2.4 to CI test matrix (PR #1980)
   * upgrade cucumber and JRuby in CI build (PR #2005)
-  * fix reference to documentation in attributes.adoc (PR #1901) (@stonio)
+  * fix reference to documentation in attributes.adoc (PR #1901) (*@stonio*)
   * trap and verify all warnings when tests are run with warnings enabled
   * set default task in build to test:all
   * configure run-tests.sh script to run all tests
   * configure feature tests to only show progress
   * configure Slim in feature tests to use html as format instead of deprecated html5
   * lock version of yard to fix invalid byte sequence in Ruby 1.9.3
-  * modify rake build to trigger dependent builds (specifically, Asciidoctor.js) (@mogztter) (PR #2305)
+  * modify rake build to trigger dependent builds (specifically, Asciidoctor.js) (PR #2305) (*@mogztter*)
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+  * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.6[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.6[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.5...v1.5.6[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.5\...v1.5.6[full diff]
 == 1.5.5 (2016-10-05) - @mojavelinux
 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)
+  * Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (#1721) (*@JojoBoulix*)
   * 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 (@JmyL - kr, @ciampix - it, @ivannov - bg, @maxandersen - da, @radcortez - pt, @eddumelendez - es, @leathersole - jp, @aslakknutsen - no, @shahryareiv - fa, @AlexanderZobkov - ru, @dongwq - zh, @rmpestano - pt_BR, @ncomet - fr, @lgvz - fi, @patoi - hu, @BojanStipic - sr, @fwilhe - de, @rahmanusta - tr, @abelsromero - ca, @aboullaite - ar, @roelvs - nl)
-  * Translate README to Chinese (@diguage)
-  * Translate README to Japanese (@Mizuho32)
+  * Introduce translation file for built-in labels (*@ciampix*)
+  * Provide translations for built-in labels (*@JmyL* - kr, *@ciampix* - it, *@ivannov* - bg, *@maxandersen* - da, *@radcortez* - pt, *@eddumelendez* - es, *@leathersole* - jp, *@aslakknutsen* - no, *@shahryareiv* - fa, *@AlexanderZobkov* - ru, *@dongwq* - zh, *@rmpestano* - pt_BR, *@ncomet* - fr, *@lgvz* - fi, *@patoi* - hu, *@BojanStipic* - sr, *@fwilhe* - de, *@rahmanusta* - tr, *@abelsromero* - ca, *@aboullaite* - ar, *@roelvs* - nl)
+  * Translate README to Chinese (*@diguage*)
+  * Translate README to Japanese (*@Mizuho32*)
 Improvements::
   * Style nested emphasized phrases properly when using default stylesheet (#1691)
@@ -338,12 +524,12 @@ Improvements::
   * 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)
+  * Upgrade to Font Awesome 4.6.3 (#1723) (*@allenan*, *@mogztter*)
   * 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)
+  * 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
@@ -366,23 +552,24 @@ Bug fixes::
 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)
+  * Run tests in CI using latest versions of Ruby, including Ruby 2.3 (*@ferdinandrosario*)
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
+  * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.5[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.5[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.4...v1.5.5[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.4\...v1.5.5[full diff]
 == 1.5.4 (2016-01-03) - @mojavelinux
 Enhancements::
-  * translate README into French (@anthonny, @mogztter, @gscheibel, @mgreau) (#1630)
+  * translate README into French (#1630) (*@anthonny*, *@mogztter*, *@gscheibel*, *@mgreau*)
   * allow linkstyle in manpage output to be configured (#1610)
 Improvements::
@@ -390,9 +577,9 @@ Improvements::
   * 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)
+  * add attribute to control build reproducibility (#1453) (*@bk2204*)
   * 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)
+  * honor icon attribute on admonition block when font-based icons are enabled (#1593) (*@robertpanzer*)
   * resolve custom icon relative to iconsdir; add file extension if absent (#1634)
   * allow asciidoctor cli to resolve library path when invoked without leading ./
@@ -408,13 +595,13 @@ Bug fixes::
   * 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)
+  * initialize Slim-related attributes regardless of when Slim was loaded (#1576) (*@terceiro*)
+  * differentiate literal backslash from escape sequence in manpage output (#1604) (*@ds26gte*)
+  * don't mistake line beginning with \. for troff macro in manpage output (#1589) (*@ds26gte*)
+  * escape leading dots so user content doesn't trigger troff macros in manpage output (#1631) (*@ds26gte*)
+  * use \c after .URL macro to remove extraneous space in manpage output (#1590) (*@ds26gte*)
   * fix missing endline after .URL macro in manpage output (#1613)
-  * properly handle spacing around .URL/.MTO macro in manpage output (@ds26gte) (#1641)
+  * properly handle spacing around .URL/.MTO macro in manpage output (#1641) (*@ds26gte*)
   * 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
@@ -429,36 +616,36 @@ Infrastructure::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.4[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.4[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.3...v1.5.4[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.3\...v1.5.4[full diff]
 == 1.5.3 (2015-10-31) - @mojavelinux
 Enhancements::
   * add support for interactive & inline SVGs (#1301, #1224)
-  * add built-in manpage backend (@davidgamba) (#651)
-  * create Mallard backend; asciidoctor/asciidoctor-mallard (@bk2204) (#425)
-  * add AsciiMath to MathML converter to support AsciiMath in DocBook converter (@pepijnve) (#954)
+  * add built-in manpage backend (#651) (*@davidgamba*)
+  * create Mallard backend; asciidoctor/asciidoctor-mallard (#425) (*@bk2204*)
+  * add AsciiMath to MathML converter to support AsciiMath in DocBook converter (#954) (*@pepijnve*)
   * 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)
+  * add `docinfosubs` attribute to control which substitutions are performed on docinfo files (#405) (*@mogztter*)
+  * drop ability to specify multiple attributes with a single `-a` flag when using the CLI (#405) (*@mogztter*)
+  * make subtitle separator chars for document title configurable (#1350) (*@rmannibucau*)
   * 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)
+  * load JavaScript and CSS at bottom of HTML document (#1238) (*@mogztter*)
+  * list available backends in help text (#1271) (*@plaindocs*)
   * properly expand tabs in literal text (#1170, #841)
-  * add `source-indent` as document attribute (@mogztter) (#1169)
+  * add `source-indent` as document attribute (#1169) (*@mogztter*)
   * upgrade MathJax to 2.5.3 (#1329)
-  * upgrade Font Awesome to 4.4.0 (@mogztter) (#1465)
+  * upgrade Font Awesome to 4.4.0 (#1465) (*@mogztter*)
   * 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)
@@ -467,10 +654,10 @@ Improvements::
   * 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)
+  * recognize U+2022 (bullet) as alternative marker for unordered lists (#1177) (*@mogztter*)
   * 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)
+  * parse isolated version in revision line (#790) (*@bk2204*)
   * 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)
@@ -481,15 +668,15 @@ Improvements::
   * 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)
+  * 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)
+  * add method `AbstractNode#add_role` and `AbstractNode#remove_role` (#1366) (*@robertpanzer*)
   * 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)
+  * 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
@@ -504,7 +691,7 @@ Compliance::
 Bug fixes::
   * don't truncate exception stack in `Asciidoctor.load` (#1248)
-  * don't fail to save cause of Java exception (@robertpanzer) (#1458)
+  * don't fail to save cause of Java exception (#1458) (*@robertpanzer*)
   * fix precision error in timings report (#1342)
   * resolve regexp for inline macro lazily (#1336)
   * block argument to `find_by` should filter results (#1393)
@@ -521,7 +708,7 @@ Bug fixes::
   * 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)
+  * 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
@@ -537,28 +724,28 @@ Infrastructure::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.3[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.3[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.2...v1.5.3[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.2\...v1.5.3[full diff]
 == 1.5.2 (2014-11-27) - @mojavelinux
 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)
+  * add docinfo extension (#1162) (*@mogztter*)
+  * allow docinfo to be in separate directory from content, specified by `docinfodir` attribute (#511) (*@mogztter*)
+  * enable TeX equation auto-numbering if `eqnums` attribute is set (#1110) (*@jxxcarlson*)
 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)
+  * upgrade Font Awesome to version 4.2.0 (#1201) (*@clojens*)
   * 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)
@@ -569,13 +756,13 @@ Improvements::
   * 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)
+  * enhance error message when reading binary input files (#1158) (*@mogztter*)
   * 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)
+  * automatically load Slim's include plugin when using slim templates (#1151) (*@jirutka*)
+  * mixin Slim helpers into execution scope of slim templates (#1143) (*@jirutka*)
+  * improve DocBook output for manpage doctype (#1134, #1142) (*@bk2204*)
 Compliance::
@@ -591,14 +778,14 @@ Bug fixes::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.2[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.2[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.1...v1.5.2[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.1\...v1.5.2[full diff]
 == 1.5.1 (2014-09-29) - @mojavelinux
@@ -622,14 +809,14 @@ Improvements::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?q=milestone%3Av1.5.1[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.1[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v1.5.0...v1.5.1[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v1.5.0\...v1.5.1[full diff]
 == 1.5.0 (2014-08-12) - @mojavelinux
@@ -651,10 +838,10 @@ Enhancements::
   * {star} switch to open source fonts (Open Sans, Noto Serif and Droid Sans Mono) in default stylesheet, major refinements to theme (#879)
   * {star} embed remote images when data-uri and allow-uri-read attributes are set (#612)
   * {star} support leveloffset on include directive and honor relative leveloffset values (#530)
-  * {star} switch default docbook backend to docbook5 (@bk2204) (#554)
+  * {star} switch default docbook backend to docbook5 (#554) (*@bk2204*)
   * {star} added hide-uri-scheme attribute to hide uri scheme in automatic links (#800)
   * {star} allow substitutions to be incrementally added & removed (#522)
-  * {star} add compatibility with Opal, add shim compat library, use compatibility regexp, require libraries properly (@mogztter) (#679, #836, #846)
+  * {star} add compatibility with Opal, add shim compat library, use compatibility regexp, require libraries properly (#679, #836, #846) (*@mogztter*)
   * {star} output XHTML when backend is xhtml or xhtml5 (#494)
   * {star} add shorthand subs and specialchars as an alias for specialcharacters (#579)
   * {star} deprecate toc2 attribute in favor of position and placement values on toc attribute (e.g., toc=left) (#706)
@@ -677,9 +864,9 @@ Improvements::
   * {star} don't select lines that contain a tag directive when including tagged lines, make tag regexp more strict (#1027)
   * {star} use https scheme for assets by default
-  * {star} upgrade to Font Awesome 4.1 (@mogztter) (#752)
-  * {star} improve print styles, add print styles for book doctype (@leif81) (#997, #952)
-  * {star} add proper grid and frame styles for tables (@leif81) (#569)
+  * {star} upgrade to Font Awesome 4.1 (#752) (*@mogztter*)
+  * {star} improve print styles, add print styles for book doctype (#997, #952) (*@leif81*)
+  * {star} add proper grid and frame styles for tables (#569) (*@leif81*)
   * {star} use glyphs for checkboxes when not using font icons (#878)
   * {star} prefer source-language attribute over language attribute for defining default source language (#888)
   * {star} pass document as first argument to process method on Preprocessor
@@ -692,15 +879,15 @@ Improvements::
   * constrain subscript & superscript markup (#564, #936)
   * match cell specs when cell separator is customized (#985)
   * use stylesheet to set default table width (#975)
-  * display nested elements correctly in toc (@kenfinnigan) (#967)
-  * add support for id attribute on links (@mogztter) (#935)
-  * add support for title attribute on links (@aslakknutsen)
-  * add -t flag to cli to control output of timing information (@mogztter) (#909)
+  * display nested elements correctly in toc (#967) (*@kenfinnigan*)
+  * add support for id attribute on links (#935) (*@mogztter*)
+  * add support for title attribute on links (*@aslakknutsen*)
+  * add -t flag to cli to control output of timing information (#909) (*@mogztter*)
   * rewrite converter API (#778)
   * rewrite extensions to support extension instances for AsciidoctorJ (#804)
   * integrate thread_safe gem (#638)
   * allow inline macro extensions that define a custom regexp to be matched (#792)
-  * make Reader#push_include work with default file, path and dir (@bk2204) (#743)
+  * make Reader#push_include work with default file, path and dir (#743) (*@bk2204*)
   * honor custom outfilesuffix and introduce relfileprefix (#801)
   * add author and copyright to meta in HTML5 backend (#838)
   * output attribution in front of citetitle for quote and verse blocks
@@ -712,7 +899,7 @@ Improvements::
   * remove trailing endlines from source data (#727)
   * add flag to cli to suppress warnings (#557)
   * emit warning if tag(s) not found in include file (#639)
-  * use <th> element for vertical table headers instead of header class (@davidgamba) (#738)
+  * use <th> element for vertical table headers instead of header class (#738) (*@davidgamba*)
   * share select references between AsciiDoc-style cell & main document (#729)
   * number chapters sequentially, always (#685)
   * add vbar attribute, make brvbar resolve properly (#643)
@@ -720,20 +907,20 @@ Improvements::
   * enable sidebar toc for small screens (#628)
   * add square brackets around button in HTML output (#631)
   * make language hover text work for all languages in listing block
-  * set background color on toc2 to cover scrolling content (@neher)
+  * set background color on toc2 to cover scrolling content (*@neher*)
   * make document parsing a discrete step, make Reader accessible as property on Document
   * allow custom converter to set backend info such as outfilesuffix and htmlsyntax
-  * report an informative error message when a converter cannot be resolved (@mogztter)
+  * report an informative error message when a converter cannot be resolved (*@mogztter*)
   * add conum class to b element when icons are disabled, make conum CSS selector more specific
-  * expose Document object to extension point IncludeProcessor (@aslakknutsen)
+  * expose Document object to extension point IncludeProcessor (*@aslakknutsen*)
   * style audioblock title, simplify rules for block titles
   * alias :name_attributes to :positional_attributes in extension DSL
-  * upgrade to highlight.js 7.4 (and later 8.0) (@mogztter) (#756)
+  * upgrade to highlight.js 7.4 (and later 8.0) (#756) (*@mogztter*)
 Compliance::
   * only include xmlns in docbook45 backend if xmlns attribute is specified (#929)
-  * add xmlns attribute for xhtml output (@bk2204)
+  * add xmlns attribute for xhtml output (*@bk2204*)
   * warn if table without a body is converted to DocBook (#961)
   * wrap <para> around admonition inside example block in DocBook 4.5 (#931)
   * use <informalfigure> if block image doesn't have a title (#927)
@@ -742,20 +929,20 @@ Compliance::
   * add compliance setting to control use of shorthand property syntax (#789)
   * wrap top-level content inside preamble in DocBook backend when doctype is book (#971)
   * escape special chars in image alt text (#972)
-  * set starting number in ordered list for docbook (@megathaum) (#925)
+  * set starting number in ordered list for docbook (#925) (*@megathaum*)
   * match word characters in regular expressions as defined by Unicode (#892)
   * put source language class names on child code element of pre element (#921)
   * ignore case of attribute in conditional directives (#903)
   * allow attribute entry to reset / reseed counter (#870)
   * allow doctype to be set in AsciiDoc table cell (#863)
-  * match URL macro following entity (@jmbruel) (#819)
+  * match URL macro following entity (#819) (*@jmbruel*)
   * handle BOM when normalizing source (#824)
   * don't output revhistory if revdate is not set (#802)
   * perform normal subs on verse content (#799)
   * automatically wrap part intro content in partintro block, emit warning if part is invalid (#768)
   * force encoding of docinfo content to UTF-8 (#773)
   * add scaling & alignment attributes to block image in DocBook backend (#763)
-  * add support for pass:[anchor:<id>[<reftext>\]] macro (#531)
+  * add support for \anchor:<id>[<reftext>] macro (#531)
   * substitute anchor and xref macros in footnotes (#676)
   * remove all string mutation operations for compatibility with Opal (#735)
   * honor reftext defined in embedded section title anchor (#697)
@@ -789,18 +976,18 @@ Bug Fixes::
   * fixed broken passthroughs caused by source highlighting (#720)
   * copy custom stylesheet if linkcss is set (#300)
   * honor list continuations for indented, nested list items (#664)
-  * fix syntax errors in converters (@jljouannic)
+  * fix syntax errors in converters (*@jljouannic*)
   * fix iconfont-remote setting
-  * fix syntax error (target -> node.target) in Docbook 5 converter (@jf647)
+  * fix syntax error (target -> node.target) in Docbook 5 converter (*@jf647*)
   * output and style HTML for toc macro correctly
 Infrastructure::
   * add Ruby 2.1 to list of supported platforms
   * reenable rbx in Travis build
-  * switch tests to minitest (@ktdreyer)
-  * update RPM for Fedora Rawhide (@ktdreyer)
-  * refactor unit tests so they work in RubyMine (@cmoulliard)
+  * switch tests to minitest (*@ktdreyer*)
+  * update RPM for Fedora Rawhide (*@ktdreyer*)
+  * refactor unit tests so they work in RubyMine (*@cmoulliard*)
   * add preliminary benchmark files to repository (#1021)
   * clean out old fixtures from test suite (#960)
   * add initial Cucumber test infrastructure (#731)
@@ -808,18 +995,18 @@ Infrastructure::
   * build gemspec files using git ls-tree (#653)
   * use in-process web server for URI tests
   * update manpage to reflect updates in 1.5.0
-  * rework README (@mogztter) (#651)
+  * rework README (#651) (*@mogztter*)
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?milestone=8&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.0[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.1.4...v1.5.0[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.1.4\...v1.5.0[full diff]
 == 0.1.4 (2013-09-05) - @mojavelinux
@@ -854,11 +1041,11 @@ Enhancements::
   * ignore front matter used by static site generators if skip-front-matter attribute is set (#502)
   * sanitize contents of HTML title element in html5 backend (#504)
   * support toc position for toc2 (#467)
-  * cli accepts multiple files as input (@lordofthejars) (#227)
+  * cli accepts multiple files as input (#227) (*@lordofthejars*)
   * added Markdown-style horizontal rules and pass Markdown tests (#455)
   * added float clearing classes (.clearfix, .float-group) (#602)
   * don't disable syntax highlighting when explicit subs is used on listing block
-  * asciidoctor package now available in Debian Sid and Ubuntu Saucy (@avtobiff) (#216)
+  * asciidoctor package now available in Debian Sid and Ubuntu Saucy (#216) (*@avtobiff*)
 Compliance::
@@ -917,7 +1104,7 @@ Improvements::
   * output multiple authors in HTML backend (#399)
   * allow multiple template directories to be specified, document in usage and manpage (#437)
   * added option to cli to specify template engine (#406)
-  * added support for external video hosting services in video block macro (@xcoulon) (#587)
+  * added support for external video hosting services in video block macro (#587) (*@xcoulon*)
   * strip leading separator(s) on section id if idprefix is blank (#551)
   * customized styling of toc placed inside body content (#507)
   * consolidate toc attribute so toc with or without toc-position can make sidebar toc (#618)
@@ -946,14 +1133,14 @@ Improvements::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
-  * http://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
-  * http://packages.ubuntu.com/saucy/asciidoctor[Ubuntu (asciidoctor)]
+  * https://packages.debian.org/sid/asciidoctor[Debian (asciidoctor)]
+  * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?milestone=7&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.4[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.1.3...v0.1.4[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.1.3\...v0.1.4[full diff]
 == 0.1.3 (2013-05-30) - @mojavelinux
@@ -970,8 +1157,8 @@ Enhancements::
   * support Markdown-style quote blocks
   * added section level 5 (maps to h6 element in the html5 backend) (#334)
   * added btn inline macro (#259)
-  * added menu inline menu to identify a menu selection (@bleathem) (#173)
-  * added kbd inline macro to identify a key or key combination (@bleathem) (#172)
+  * added menu inline menu to identify a menu selection (#173) (*@bleathem*)
+  * added kbd inline macro to identify a key or key combination (#172) (*@bleathem*)
   * support alternative quote forms (#196)
   * added indent attribute to verbatim blocks (#365)
   * added prettify source-highlighter (#202)
@@ -998,7 +1185,7 @@ Compliance::
   * assign caption even if no title (#321)
   * horizontal dlist layout in docbook backend (#298)
   * set doctitle attribute (#337)
-  * allow any backend to be specified in cli (@lightguard) (#320)
+  * allow any backend to be specified in cli (#320) (*@lightguard*)
   * support for abstract and partintro (#297)
 Bug Fixes::
@@ -1012,17 +1199,17 @@ Bug Fixes::
 Improvements::
   * added tests for all special sections (#80)
-  * added test for attributes defined as string or string array (@lightguard) (#291)
+  * added test for attributes defined as string or string array (#291) (*@lightguard*)
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
 http://asciidoctor.org/news/2013/05/31/asciidoctor-0-1-3-released[release notes] |
 https://github.com/asciidoctor/asciidoctor/issues?milestone=4&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.3[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.1.2...v0.1.3[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.1.2\...v0.1.3[full diff]
 == 0.1.2 (2013-04-25) - @mojavelinux
@@ -1072,12 +1259,12 @@ Bug Fixes::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
 http://asciidoctor.org/news/2013/04/25/asciidoctor-0-1-2-released[release notes] |
 https://github.com/asciidoctor/asciidoctor/issues?milestone=3&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.2[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.1.1...v0.1.2[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.1.1\...v0.1.2[full diff]
 == 0.1.1 (2013-02-26) - @erebor
@@ -1128,11 +1315,11 @@ Improvements::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?milestone=1&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.1[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.1.0...v0.1.1[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.1.0\...v0.1.1[full diff]
 == 0.1.0 (2013-02-04) - @erebor
@@ -1180,11 +1367,11 @@ Improvements::
 Distribution Packages::
-  * http://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
+  * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
 https://github.com/asciidoctor/asciidoctor/issues?milestone=12&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.0[git tag] |
-https://github.com/asciidoctor/asciidoctor/compare/v0.0.9...v0.1.0[full diff]
+https://github.com/asciidoctor/asciidoctor/compare/v0.0.9\...v0.1.0[full diff]
 == Older releases (pre-0.0.1)