asciidoctor-pdf 2.0.0.alpha.2 → 2.0.0.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da863e1bc05edaf64e5e443bb042fdaa01cc048ac559c9955bac4d7c27fff1c1
-  data.tar.gz: 0712e9ee6655c004b82f64c78d3c1eb326c182576e447669cce11e4ff7ca34db
+  metadata.gz: b935ce3aea7b70edb830a1f0c5bda65946906f5237c62e092520a3278601d382
+  data.tar.gz: fc94d51df27157920ce16afb6550a05c045ffa3b0dd5f5db033c90bd17c84304
 SHA512:
-  metadata.gz: 8626792d427b27b635a6836fa0c1c7bf75faff5d82f1a71d74a23333e516086475e268cd524a5f5d2c0cfc9827b5b0f72a9d41fd6cc6b7c568506d914daf6840
-  data.tar.gz: 764bc2e6b6f069d437583c095a92f9e92969e306c872ea92c52e805c0063fa1d810390a303b597252adb9ca33015bd340f5e8d3851a0d64bb96d0cdc5d523329
+  metadata.gz: a51edc93917183ef48c430a33df763404706a6dc72a4fc248b03760a8f3c7c21d53b2aa3a289f01acd2e765c34ad9a1d5b0022590a51a6d4d3acbe406d779155
+  data.tar.gz: ab163214c8bf89866dd2eaed94e6c99662431268757b5e1e7023545bd3fb58484008f633d49974b32cc4b1e13455cb54ef77dc7e3e385d5feac36bdf67d8897e

data/CHANGELOG.adoc

@@ -1,9 +1,111 @@
 = {project-name} Changelog
 :project-name: Asciidoctor PDF
-:uri-repo: https://github.com/asciidoctor/asciidoctor-pdf
+:url-repo: https://github.com/asciidoctor/asciidoctor-pdf
 
 This document provides a high-level view of the changes to the {project-name} by release.
-For a detailed view of what has changed, refer to the {uri-repo}/commits/main[commit history] on GitHub.
+For a detailed view of what has changed, refer to the {url-repo}/commits/main[commit history] on GitHub.
+
+== 2.0.0.beta.2 (2022-05-14) - @mojavelinux
+
+Enhancements::
+
+* add support for float attribute on image; wrap ensuing paragraphs around image with `float` attribute (#353)
+* add `supports_float_wrapping?` method for extended converter to override to enlist other blocks in float wrapping; add example to docs (#353)
+* add `image-float-gap` key to theme to control space around image float (#353)
+* add support for `text-transform` property on first line of abstract in theme (#2141)
+* rename `resolve_alignment_from_role` to `resolve_text_align_from_role` to reflect proper terminology and purpose; alias old method name
+* add support for orphan avoidance to discrete headings to match behavior of section titles (using call to `arrange_heading`) (#2151)
+* rename `arrange_section` to `arrange_heading` to reflect proper terminology and purpose
+* add `index-column-gap` key to theme to control size of gap between columns
+* coerce `image-caption-max-width` to `fit-content` if `float` attribute is set on block image (#2150)
+* add support for text box with fixed height via `:height` option to `typeset_text` helper
+* configure `typeset_text` and `ink_prose` to return remaining fragments when `:height` option is specified
+* add support for `:indent_paragraphs` option to formatted text box (#353)
+* if `float` attribute is set on block image, set max width on caption to `fit-content` if max width not already set to a `fit-content` value
+* add built-in default-sans theme
+
+Improvements::
+
+* rename theme suffix with-fallback-font to with-font-fallbacks
+* rename sans-with-fallback-font theme to default-sans-with-font-fallbacks
+* configure spacing around thematic break using `thematic-break-padding` key instead of margin top and bottom (#2164)
+* rename `convert_listing_or_literal` to `convert_code` and alias old name
+* reify convert handler for STEM blocks (`convert_stem`)
+* reify convert handler for pass blocks (`convert_pass`) and remove block decoration
+
+Bug Fixes::
+
+* honor `caption-align` when element align is not `left` and `caption-max-width` is % of element width (e.g., `fit-content(50%)`) (#2156)
+* do not orphan sidebar title (#2158)
+* allow theme to set font style of first line of abstract to `normal_italic` (#2138)
+* add support for `:color` option to `Prawn::Text::Formatted::Box` directly and remove workarounds
+* preserve columns on subsequent pages in the index section (#2149)
+* fix return value of `cursor` method inside block for column box in index section
+* correctly detect preceding code block when determining whether to collapse top margin of colist
+* apply bottom margin to thematic break that falls at top of page (#2164)
+* allow extended converter to override `convert_code` method to handle `convert_listing` and `convert_literal` calls
+* restore margin below pass block
+* remove use of deprecated theme keys in default-for-print theme
+
+=== Details
+
+{url-repo}/releases/tag/v2.0.0.beta.2[git tag] | {url-repo}/compare/v2.0.0.beta.1\...v2.0.0.beta.2[full diff]
+
+== 2.0.0.beta.1 (2022-05-04) - @mojavelinux
+
+Enhancements::
+
+* introduce `index-pagenum-sequence-style` document attribute to control style of sequential page numbers in index when media=screen (#1656)
+* allow entry for document in outline to be controlled using `outline-title` attribute (#1789)
+* allow extended converter to insert or filter toc entries by overriding `get_entries_for_toc` method (#2097)
+* add `asciidoctor/pdf/nopngmagick` script to unregister Gmagick handler for PNG images only (#1687)
+* allow theme to configure which end the caption is placed for a block image (#2115)
+* add `Page#imported` method to mark page as imported (which suppresses running content)
+* add support for `smallcaps` text transform by replacing lowercase letters with small capital variants (#1192)
+* use `base-border-color` as default border color; control appearance of border using `border-width` value alone (#2134)
+* remove border colors in base theme so all border colors can be controlled using `base-border-color` when extending theme
+* enable running footer when using base theme
+
+Bug Fixes::
+
+* allow border width of block image to be specified as an array (1, 2, or 4 values) (#2119)
+* rename `delete_page` extension method to `delete_current_page` to avoid conflict with incompatible method on `Prawn::Document`
+* remap `table-caption-side` theme key to `table-caption-end` (#2125)
+* add missing glyph for `ÿ` in built-in fonts
+* remove use of deprecated keys in chronicles-dark-theme.yml
+
+=== Details
+
+{url-repo}/releases/tag/v2.0.0.beta.1[git tag] | {url-repo}/compare/v2.0.0.alpha.3\...v2.0.0.beta.1[full diff]
+
+== 2.0.0.alpha.3 (2022-05-01) - @mojavelinux
+
+Enhancements::
+
+* allow border width of block to be specified per edge using 4-value array (#2102)
+* allow padding on block to be specified using 2-value array for ends and sides or 3-value array with implied left side value (#2104)
+* allow margins in running content to be specified using 2-value array for ends and sides or 3-value array with implied left side value (#2104)
+* allow theme to set border and padding on headings per level (#434)
+
+Improvements::
+
+* reduce top and bottom padding on quote and verse blocks in base theme
+* use uniform top and bottom padding on quote blocks in default theme
+* change `inscribe_` method prefix in converter to `ink_`
+
+Bug Fixes::
+
+* allow `ink_toc` method in extended converter to insert page above TOC page
+* remap `layout_` methods contributed to converter by prepended module
+* neutralize padding hacks in themes designed before the converter had smart margins
+* allow the smallest ends or sides border width on block to be less than 1
+* cap border corners on block when width is defined using array (uniform or otherwise) (#2103)
+* fix crash in certain circumstances when theme does not define value for `base-border-width` key
+* use sensible fallbacks for table border and grid color and width (retains backwards compatibility)
+
+=== Details
+
+{url-repo}/releases/tag/v2.0.0.alpha.3[git tag] | {url-repo}/compare/v2.0.0.alpha.2\...v2.0.0.alpha.3[full diff]
 
 == 2.0.0.alpha.2 (2022-04-29) - @mojavelinux
 
@@ -12,15 +114,15 @@ Enhancements::
 * separate `align` and `text-align` keys in theme schema; remap old keys for backwards compatibility (#2095)
 * allow theme to control the border on all sides of tables independently (#902)
 * keep section title with first block of content is `breakable` option is set on section (#2075, #38)
-* pass `part`, `chapterlike`, and `hidden` options to `arrange_section` method
+* pass the `part` and `chapterlike` options to the `arrange_section` method for convenience
 * add support for `background-color` property on caption (#1995)
 * add support for image-based icons, resolved from `iconsdir` and having the `icontype` file extension (#1770)
-* add `asciidoctor/pdf/nogmagick` script to prevent Gmagick from handling PNG images (#1687)
+* add `asciidoctor/pdf/nogmagick` script to prevent loading prawn-gmagick gem (#1687)
 * change name of `untitled` option on special section to `notitle`
 * allow the title of any section to be hidden using the `notitle` option
 * allow imported PDF page to be referenced in TOC by enclosing in parent section with `notitle` option (#1213)
 * allow entry for preface to be added to TOC without adding title to body using the `notitle` option on the preface section (#1786)
-* automatically promote the `notitle` option from the first block in the premable to preface section; restore lead role on opening paragraph (#1786)
+* automatically promote the `notitle` option from the first block in the preamble to preface section; restore lead role on opening paragraph (#1786)
 
 Improvements::
 
@@ -36,7 +138,7 @@ Bug Fixes::
 * delete dests on page before deleting it (keeps generated PDF clean of obsolete destinations)
 * don't call `arrange_section` if section title is hidden
 * remove `theme_font` enclosure around call to `start_new_chapter` and `start_new_part`
-* change `layout_` method prefix to `inscribe_` in converter (#2099)
+* change `layout_` method prefix in converter to `inscribe_` (#2099)
 
 === Details
 
@@ -47,13 +149,13 @@ Bug Fixes::
 Enhancements::
 
 * make delimited blocks breakable by default; require the `unbreakable` option on the block to retain the previous "`keep together`" behavior (#2004, #578, #509, #240)
-* add support for the %unbreakable option on a table to prevent it from being split across pages (#2022, #871, #819, #331)
-* add support for the %breakable option on a table (special case) to keep the caption and ID with the start of the table (#2022, #993)
+* add support for the `unbreakable` option on a table to prevent it from being split across pages (#2022, #871, #819, #331)
+* add support for the `breakable` option on a table (special case) to keep the caption and ID with the start of the table (#2022, #993)
 * implement smart bottom margins on blocks to prevent extra space below blocks, particularly nested blocks (#1515, #1513, #1845)
 * drop support for `top-margin` key on block and prose categories in theme; space between delimited blocks and lists now controlled using bottom margins only (#1515)
 * allow location of anchor for block to be positioned relative to content using `block-anchor-top` key in theme (#2013)
-* allow page numbering and running content to start after first page of a document without a title page by assigning an integer to the respective `start_at` theme key (#1644)
-* allow page numbering and running content to start after toc (wherever it's placed) by assigning the keyword `after-toc` to the respective `start_at` theme key (#1763)
+* allow page numbering and running content to start after first page of a document without a title page by assigning an integer to the respective `start-at` theme key (#1644)
+* allow page numbering and running content to start after toc (wherever it's placed) by assigning the keyword `after-toc` to the respective `start-at` theme key (#1763)
 * allow theme to configure page numbering to start at cover (#1727)
 * allow the front and back cover images to be defined in the theme (#1584)
 * allow the front and back cover images to be specified as a data URI (#1584)
@@ -90,7 +192,7 @@ Enhancements::
 * normalize space characters in authors content and drop lines with unresolved attribute references (#1642)
 * skip image block with missing image if computed alt text resolves to empty string (#1645)
 * custom theme does not inherit from base theme by default; must be specified explicitly using `extends: base` (#1640)
-* allow theme to configure number of index columns using `index_columns` key (#1663)
+* allow theme to configure number of index columns using `index-columns` key (#1663)
 * configure AsciiDoc table cell to inherit font properties from table and scale font size of nested blocks (#926)
 * scale font size of literal table cell (#1696)
 * add support for `id` attribute on link macro
@@ -101,13 +203,13 @@ Enhancements::
 * allow admonition icon image to be remote (if allow-uri-read is set) or data URI (#1711)
 * allow theme to configure font color of unresolved footnote using unresolved role
 * show textual label on admonition if icon image fails to embed (#1741)
-* allow theme to disable title page by assigning false to `title_page` category key (#1754)
+* allow theme to disable title page by assigning false to `title-page` category key (#1754)
 * allow Rouge theme to be specified as theme class or instance (API only)
 * allow theme to control font size of dot leader in TOC
-* allow section to override outlinelevels for self and children using `outlinelevels` attribute on section
+* allow section to override `outlinelevels` for self and children using `outlinelevels` attribute on section
 * use value of `author` attribute for PDF info and pdfmark if locked by the API (#1778)
 * only extend theme in extends hierarchy once unless modified with `!important` (#1800)
-* add print-optimized themes (default-for-print and default-for-print-with-fallback-font) (#1699)
+* add print-optimized themes (`default-for-print` and `default-for-print-with-fallback-font`) (#1699)
 * add support for power operator in theme (with same precedence as multiply and divide) (#1813)
 * include floor and ceil match characters in fallback font (#1832) (*@oddhack*)
 * allow horizontal and vertical lines of table grid to be styled independently (#1875) (*@hextremist*)
@@ -134,7 +236,7 @@ Bug Fixes::
 * do not insert blank line in index when term is forced to break (#1665)
 * honor prepress page margins on subsequent pages in index (#1929)
 * use more robust strategy for line height normalization that accounts for case when line contains only monospaced text (#1650)
-* add support for line-height property on lead role as documented
+* add support for `line-height` property on `lead` role as documented
 * prevent generator from allocating space for placeholder null char (used for anchors) if font is missing glyph (#1672)
 * ensure background and admonition icon image files are closed after being read (#1566)
 * ensure temporary images generated by running content are cleaned up (#1566)
@@ -191,10 +293,10 @@ Bug Fixes::
 * fix vertical center alignment of normal table cell
 * short-circuit xreftext containing a circular reference path
 * prevent PDF page import from corrupting references in PDF (#1726)
-* display decimal list marker correctly when list is reversed (e.g., 10., 09., 08., etc)
+* display decimal list marker correctly when list is reversed (e.g., 10., 09., 08., etc.)
 * use correct spacing for dotted border dash on table (length and spacing should match width)
 * set color space on page with only image so font color is preserved in running content (#1742)
-* compute font size for superscript and subscript correctly when parent element uses em and % units (#1745)
+* compute font size for superscript and subscript correctly when parent element uses `em` and `%` units (#1745)
 * respect hyphenation exceptions when word is adjacent to non-word character (#1715)
 * fix crash when TOC is enabled and index is empty
 * align TOC section properly when index exceeds one page and `section_indent` is positive (#1735)
@@ -229,7 +331,7 @@ Bug Fixes::
 * verify alignment of list marker in AsciiDoc table cell (#1965)
 * don't crash if value of `width` attribute on image has invalid format (#1970)
 * don't render borders and backgrounds in scratch document
-* don't insert blank page after document title if first block (chapter or toc macro) has nonfacing option (#1988)
+* don't insert blank page after document title if first block (chapter or toc macro) has `nonfacing` option (#1988)
 * coerce negated variable reference to number if value of variable is numeric
 * prepress page margins should honor value of `pdf-folio-placement` (#1918)
 * ensure callout number in callout list stays with primary text when item is advanced to next page (#1967)
@@ -505,7 +607,7 @@ Bug Fixes::
 * allow theme to control font properties (font size, font color, etc) of description list term (#1289)
 * allow theme to override caption styles for specific block categories: blockquote, code, example, footnotes, image, listing, and table (#307)
 * allow theme to control style of verse block independently of a quote block (#40)
-* position list marker correctly when media=prepress and list item is advanced to next page or split across pages (#1303)
+* position list marker correctly when `media=prepress` and list item is advanced to next page or split across pages (#1303)
 * layout horizontal dlist in two columns (#310)
 * apply normal substitutions to content of manname section (#1294)
 * optimize PDF using quality specified in value of optimize attribute if optimize attribute is set (#535)
@@ -542,7 +644,7 @@ Bug Fixes::
 * allow multiple font dirs to be specified using the pdf-fontsdir attribute (#80)
 * fill and stroke bounds of example across all pages (#362)
 * allow page background color and background image to be used simultaneously (#1186)
-* allow theme to specifiy initial zoom (#305)
+* allow theme to specify initial zoom (#305)
 * strip surrounding whitespace from text in normal table cells
 * allow attribute references to be used in image paths in theme (#588)
 * resolve variables in font catalog in theme file
@@ -555,11 +657,11 @@ Bug Fixes::
 * reduce min font size in base theme
 * allow theme to configure the minimum height required after a section title for it to stay on same page (#1210)
 * convert hyphen to underscore in theme key for admonition icon type (#1217)
-* always resolve images in running content relative to themesdir (instead of document) (#1183)
+* always resolve images in running content relative to `themesdir` (instead of document) (#1183)
 * fix placement of toc in article when doctitle is not set (#1240)
 * honor text alignment role on abstract paragraph(s)
-* don't insert blank page at start of document if media=prepress and document does not have a cover (#1181)
-* insert blank page after cover if media=prepress (#1181)
+* don't insert blank page at start of document if `media=prepress` and document does not have a cover (#1181)
+* insert blank page after cover if `media=prepress` (#1181)
 * add support for stretch role on table (as preferred alias for spread) (#1225)
 * include revremark on title page if specified (#1198)
 * allow theme to configure border around block image (#767)
@@ -583,13 +685,13 @@ Bug Fixes::
 * only apply title page background image to the title page (#1144)
 * make sure title page background or color (and only title page background or color) gets applied to title page even when page has already been created (#1144)
 * fix crash when image_width is defined in theme (#995)
-* fix crash when toc is enabled and toc-title attribute is unset
+* fix crash when toc is enabled and `toc-title` attribute is unset
 * correctly map legacy Font Awesome icon names when icon set is not specified (#1157)
 * coerce color values in theme that contain uppercase letters (#1149)
 * prevent table alignment from modifying margins of subsequent pages; only align table if width is less than bounds (#1170)
 * ensure base font color is set
 * use more robust mechanism to detect an empty page; tare content stream after adding page background color or image
-* ignore pdf-themesdir unless pdf-theme is specified (#1167)
+* ignore `pdf-themesdir` unless pdf-theme is specified (#1167)
 * allow theme to control glyphs used for conums (#133)
 * allow theme to control background and border of inline kbd (#313, #1004)
 * add support for link on image in running content (#1002)
@@ -606,12 +708,12 @@ Bug Fixes::
 
 == 1.5.0.beta.1 (2019-07-08) - @mojavelinux
 
-* rename pdf-style and pdf-stylesdir attributes to pdf-theme and pdf-themesdir, respectively (while still honoring the old names for compatibility) (#1127)
-* don't load fallback font by default; move fallback font to default-with-fallback-font theme
+* rename `pdf-style` and `pdf-stylesdir` attributes to `pdf-theme` and `pdf-themesdir`, respectively (while still honoring the old names for compatibility) (#1127)
+* don't load fallback font by default; move fallback font to `default-with-fallback-font` theme
 * apply cell padding to table cells in the head row (#1098)
-* allow the theme to control the padding of table cells in the head row using the table_head_cell_padding key (#1098)
+* allow the theme to control the padding of table cells in the head row using the `table_head_cell_padding` key (#1098)
 * fix position of table caption for reduced-width tables when caption align is center (#1138)
-* adjust width of table caption to match width of table unless table_caption_max_width is none in theme (#1138)
+* adjust width of table caption to match width of table unless `table_caption_max_width` is none in theme (#1138)
 * fix position of text in running header (#1087)
 * ignore start attribute on ordered list if marker is disabled
 * allow start value to be negative for ordered lists that use arabic or roman numbering (#498)
@@ -620,13 +722,13 @@ Bug Fixes::
 * scale SVG background image to fit page in the same way raster image is scaled (#765)
 * allow page background size to be controlled using image macro attributes (#1117)
 * allow page background image position to be controlled using position attribute on image macro (#1124)
-* add support for fit=cover for cover, page background, and running content images (#1136)
+* add support for `fit=cover` for cover, page background, and running content images (#1136)
 * change default background image position to center (#1124)
 * allow cover image position to be controlled using position attribute on image macro (#1134)
 * change default cover image position to center (#1134)
 * allow cover image size to be controlled using fit, pdfwidth, and width attributes; don't scale image by default (#1134)
-* set enable_file_requests_with_root and enable_web_requests options for all SVGs (#683)
-* automatically set pdf-stylesdir if pdf-style ends with .yml and pdf-stylesdir is not specified (#1126)
+* set `enable_file_requests_with_root` and `enable_web_requests` options for all SVGs (#683)
+* automatically set `pdf-stylesdir` if `pdf-style` ends with .yml and `pdf-stylesdir` is not specified (#1126)
 * replace hyphens with underscores in top-level theme keys
 * allow hyphens to be used in variable references in theme (#1122)
 * allow theme to control background and border of inline code (literal) (#306)
@@ -674,7 +776,7 @@ Bug Fixes::
 * add visual regression capability to test suite (@beatchristen)
 * ensure index section doesn't get numbered when using Asciidoctor < 1.5.7
 * add part signifier and part number to part title if partnums is set; allow signifier to be customized using part-signifier attribute (#597)
-* add support for the chapter-signifier attribute as the prefered alternative to chapter-label
+* add support for the chapter-signifier attribute as the preferred alternative to chapter-label
 * warn if the image referenced in the running content cannot be found (#731)
 
 == 1.5.0.alpha.17 (2019-04-23) - @mojavelinux
@@ -687,7 +789,7 @@ Bug Fixes::
 * drop support for Rouge < 2
 * add a test suite (#37)
 * allow running content (header and footer) to be enabled on title and toc pages; controlled by running_content_start_at property in theme (#606)
-* add support for nbsp named entity (i.e., `+&nbsp;`); replace occurances of nbsp named entity with a single space in outline
+* add support for nbsp named entity (i.e., `+&nbsp;`); replace occurrences of nbsp named entity with a single space in outline
 * upgrade to FontAwesome 5; introduce the fas, far, and fab icon sets, now preferred over fa; drop support for octicons (#891) (@jessedoyle)
 * place footnotes at end of chapters in books or end of document otherwise (#85) (@bcourtine)
 * fix rendering of footnotes directly adjacent to text in a normal table cell (#927)
@@ -699,14 +801,14 @@ Bug Fixes::
 * set line spacing for non-AsciiDoc table cells (#296)
 * consider all scripts when looking for leading alpha characters in index (#853)
 * don't create title page for article doctype unless title-page attribute is set (#105)
-* don't show article title if notitle attribute is set (#998)
+* don't show article title if `notitle` attribute is set (#998)
 * generate name section for manpage doctype automatically (#882)
 * remove unprocessed passthroughs in literal cells
 * apply font style from theme to formatted text description list term (#854)
 * prevent tempfile for remote image from being deleted before it's used (#947)
 * handle case when uri to make breakable is empty (#936)
-* add support for frame=ends as alternative to frame=topbot on table
-* allow table frame and grid to be set globally using the table-frame and table-grid attributes (#822)
+* add support for `frame=ends` as alternative to `frame=topbot` on table
+* allow table frame and grid to be set globally using the `table-frame` and `table-grid` attributes (#822)
 * disable table stripes by default (#1049)
 * allow table stripes to be enabled globally using table-stripes attribute (#1049)
 * use new logging subsystem, if available; otherwise, use shim (#905)
@@ -766,8 +868,8 @@ Bug Fixes::
 * document in README how to install Asciidoctor PDF on Ruby 2.0.0
 * enable Travis CI; configure CI-based deployment to RubyGems.org
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.16[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.16[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.16[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.16[git tag]
 
 == 1.5.0.alpha.15 (2017-03-27) - @mojavelinux
 
@@ -801,8 +903,8 @@ Bug Fixes::
 * document that background images are scaled to fit bounds of page
 * add note in theming guide about using double quoted strings
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.15[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.15[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.15[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.15[git tag]
 
 == 1.5.0.alpha.14 (2017-02-05) - @mojavelinux
 
@@ -908,16 +1010,16 @@ Bug Fixes::
 * clarify in README how inline image are sized
 * clarify instructions in README about how to specify a page number range for printing
 * document in theming guide how to define and apply a custom Rouge theme
-* rename pdfmarks to pdfmarks; document pdfmark attribute in theming guide
+* rename `pdfmarks` to `pdfmarks`; document pdfmark attribute in theming guide
 * describe the quoted string value type in the theming guide
 * add self-referencing anchor to each key prefix in theming guide
-* document nonfacing option for sections (@jnerlich)
-* fix documentation for toc_dot_leader_font_color in theming guide (@davidgamba)
+* document `nonfacing` option for sections (@jnerlich)
+* fix documentation for `toc_dot_leader_font_color` in theming guide (@davidgamba)
 * document that dot leader inherits font properties from toc category
 * fill in missing defaults for keys in theming guide
 * rewrite intro to Keys section in theming guide
 * add keys for prose, menu, and conum categories to theming guide
-* document outline_list_marker_font_color key in theming guide
+* document `outline_list_marker_font_color` key in theming guide
 * refactor measurement value helpers into module (#677)
 * add reproducible flag to examples
 * add inline ref and corresponding xref to chronicles example
@@ -925,12 +1027,12 @@ Bug Fixes::
 * update instructions and Gemfile config to use with Ruby 1.9.3
 * configure build as the default rake task
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.14[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.14[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.14[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.14[git tag]
 
 == 1.5.0.alpha.13 (2016-09-19) - @mojavelinux
 
-* Add support for mirror (recto/verso) margins and facing pages when media=prepress
+* Add support for mirror (recto/verso) margins and facing pages when `media=prepress`
 * Add non-breaking hyphen glyph to built-in fonts so its intended behavior is honored (#462)
 * Add page break before a book part (#329)
 * Allow running (header/footer) content to be arranged in columns (#449)
@@ -945,7 +1047,7 @@ Bug Fixes::
 * Add support for literal and verse table cell styles
 * Preserve indentation in literal and verse table cells
 * Preserve paragraph breaks in normal table cells
-* Honor value of width attribute even when autowidth option is set on table (#519)
+* Honor value of width attribute even when `autowidth` option is set on table (#519)
 * Align table title to left edge of table, regardless of table alignment (#469)
 * Add support for reversed option on ordered list (#491)
 * Don't drop whitespace in front of conum on final line of source block (#470)
@@ -955,16 +1057,16 @@ Bug Fixes::
 * Resolve bare image-related attribute values relative to base_dir
 * Only allow Prawn SVG to fetch remote images if the allow-uri-read attribute is set (#548)
 * Introduce page_margin_inner and page_margin_outer keys to theme
-* Start title page, toc, main content, parts, and chapters on recto page when media=prepress and doctype=book
-* Allow default font style for table to be set via theme (table_font_style)
+* Start title page, toc, main content, parts, and chapters on recto page when `media=prepress` and `doctype=book`
+* Allow default font style for table to be set via theme (`table_font_style`)
 * Use correct default bullet per nested unordered list level (#529)
-* Call start_new_part at start of each book part
-* Delegate to layout_part_title method to layout part title
+* Call `start_new_part` at start of each book part
+* Delegate to `layout_part_title` method to layout part title
 * Don't match a special section as a chapter unless the doctype is book
 * Fix list marker placement when list item touches bottom of page
 * Eliminate excessive spacing between list items that contain nested lists
 * Drop lines in running (header/footer) content with unresolved attributes (#522)
-* Ensure start_new_chapter is always executed at a chapter transition (#524)
+* Ensure `start_new_chapter` is always executed at a chapter transition (#524)
 * Add support for root xref (e.g., &lt;&lt;included-doc#&gt;&gt;) (#521)
 * Prevent block from spilling to next page if there's no more content (#361)
 * Add support for px units to pdf-page-size attribute
@@ -992,8 +1094,8 @@ Bug Fixes::
 * Configure README for better preview on GitHub
 * Update chronicles example to modern AsciiDoc syntax; update content
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.13[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.13[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.13[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.13[git tag]
 
 == 1.5.0.alpha.12 (2016-08-05) - @mojavelinux
 
@@ -1010,7 +1112,7 @@ Bug Fixes::
 * Document theme-related AsciiDoc attributes in theming guide (#428)
 * Section title alignment should be customizable via theme (#343)
 * Collapse all whitespace when normalizing (#355)
-* Require space on either side of math operator to avoid interpretting dates as math equations (#429)
+* Require space on either side of math operator to avoid interpreting dates as math equations (#429)
 * Allow specifying a font style for a title on the title page (#423)
 * Fix Prawn SVG to support arrow heads on lines (#75)
 * Upgrade prawn-svg to 0.25.1
@@ -1029,8 +1131,8 @@ Bug Fixes::
 * Add hints to theming guide about how to apply styles when using Maven or Gradle (@fwilhe)
 * Fix gemspec to collect files when project is not a git repository or git is not available
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.12[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.12[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.12[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.12[git tag]
 
 == 1.5.0.alpha.11 (2016-01-05) - @mojavelinux
 
@@ -1053,14 +1155,14 @@ Bug Fixes::
 * Document that page background colors & images do not currently work in AsciidoctorJ PDF
 * Use failproof relative require logic in bin script
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.11[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.11[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.11[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.11[git tag]
 
 == 1.5.0.alpha.10 (2015-11-01) - @mojavelinux
 
 * Allow admonition icon to be customized by theme (#121) (@jessedoyle)
 * Update to prawn-icon 1.0.0 (#335) (@jessedoyle)
-* Only generate the pdfmarks file if the pdfmarks attribute is set
+* Only generate the pdfmarks file if the `pdfmarks` attribute is set
 * Honor table alignment (via align attribute or role) (#299)
 * Use Hash for ViewerPreferences; set initial magnification (#303)
 * Handle case when colpcwidth is unspecified (#314)
@@ -1071,8 +1173,8 @@ Bug Fixes::
 * Document theme key that sets sidebar padding (#344)
 * Handle case when CodeRay passes nil text to text_token
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.10[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.10[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.10[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.10[git tag]
 
 == 1.5.0.alpha.9 (2015-08-02) - @mojavelinux
 
@@ -1107,8 +1209,8 @@ Bug Fixes::
 * Upgrade thread_safe gem
 * Prevent crash if doc has no sections (@abatalev)
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.9[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.9[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.9[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.9[git tag]
 
 == 1.5.0.alpha.8 (2015-06-23) - @mojavelinux
 
@@ -1145,8 +1247,8 @@ Bug Fixes::
 * Update theming guide
 * Fix cross references in README
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.8[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.8[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.8[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.8[git tag]
 
 == 1.5.0.alpha.7 (2015-05-31) - @mojavelinux
 
@@ -1176,7 +1278,7 @@ Bug Fixes::
 * Show warning when image cannot be read (#148)
 * Allow page background image to be specified (#134)
 * Support PDF format as cover page (#113)
-* Accomodate numbered list with large numbers (#91)
+* Accommodate numbered list with large numbers (#91)
 * Position list marker correctly (#140)
 * Allow theme to set font size & family of table cells (#139)
 * Unencode character entities in document title (#136)
@@ -1199,8 +1301,8 @@ Bug Fixes::
 * Use SafeYAML to load theme files
 * Handle transparent value for table background colors
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.7[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.7[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.7[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.7[git tag]
 
 == 1.5.0.alpha.6 (2014-11-28) - @mojavelinux
 
@@ -1209,8 +1311,8 @@ Bug Fixes::
 * Add example for specifying theme file (Leif Gruenwoldt) (#61)
 * Add thread_safe gem to remove warning when registering converter
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.6[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.6[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.6[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.6[git tag]
 
 == 1.5.0.alpha.5 (2014-09-15) - @mojavelinux
 
@@ -1220,35 +1322,35 @@ Bug Fixes::
 * Don't activate implicit header include processor by default (#48, #25)
 * Draw box around listings and literal blocks than span more than one page (#11)
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.5[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.5[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.5[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.5[git tag]
 
 == 1.5.0.alpha.4 (2014-09-09) - @mojavelinux
 
 * Fix yield statement so Asciidoctor PDF can be used with JRuby
 * Document that the coderay gem must be installed to run the examples (#42)
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.4[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.4[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.4[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.4[git tag]
 
 == 1.5.0.alpha.3 (2014-09-08) - @mojavelinux
 
 * Remove unnecessary dependencies (tilt, slim, thread_safe)
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.3[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.3[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.3[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.3[git tag]
 
 == 1.5.0.alpha.2 (2014-09-05) - @mojavelinux
 
 * Add magic encoding header to source file so Asciidoctor PDF can be used with Ruby 1.9.3 (#33, #36)
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.2[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.2[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.2[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.2[git tag]
 
 == 1.5.0.alpha.1 (2014-09-04) - @mojavelinux
 
 * Rewrite as proper Asciidoctor converter (#29)
 * Initial pre-release
 
-{uri-repo}/issues?q=milestone%3Av1.5.0.alpha.1[issues resolved] |
-{uri-repo}/releases/tag/v1.5.0.alpha.1[git tag]
+{url-repo}/issues?q=milestone%3Av1.5.0.alpha.1[issues resolved] |
+{url-repo}/releases/tag/v1.5.0.alpha.1[git tag]