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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.adoc +185 -83
  3. data/README.adoc +31 -126
  4. data/data/fonts/ABOUT-mplus1p-subset +1 -0
  5. data/data/fonts/ABOUT-notosans-subset +1 -0
  6. data/data/fonts/ABOUT-notoserif-subset +1 -0
  7. data/data/fonts/mplus1mn-bold-subset.ttf +0 -0
  8. data/data/fonts/mplus1mn-bold_italic-subset.ttf +0 -0
  9. data/data/fonts/mplus1mn-italic-subset.ttf +0 -0
  10. data/data/fonts/mplus1mn-regular-subset.ttf +0 -0
  11. data/data/fonts/mplus1p-regular-fallback.ttf +0 -0
  12. data/data/fonts/notosans-bold-subset.ttf +0 -0
  13. data/data/fonts/notosans-bold_italic-subset.ttf +0 -0
  14. data/data/fonts/notosans-italic-subset.ttf +0 -0
  15. data/data/fonts/notosans-regular-subset.ttf +0 -0
  16. data/data/fonts/notoserif-bold-subset.ttf +0 -0
  17. data/data/fonts/notoserif-bold_italic-subset.ttf +0 -0
  18. data/data/fonts/notoserif-italic-subset.ttf +0 -0
  19. data/data/fonts/notoserif-regular-subset.ttf +0 -0
  20. data/data/themes/base-theme.yml +10 -20
  21. data/data/themes/default-for-print-theme.yml +4 -4
  22. data/data/themes/default-for-print-with-fallback-font-theme.yml +2 -3
  23. data/data/themes/default-for-print-with-font-fallbacks-theme.yml +3 -0
  24. data/data/themes/{sans-with-fallback-font-theme.yml → default-sans-theme.yml} +1 -1
  25. data/data/themes/default-sans-with-font-fallbacks-theme.yml +3 -0
  26. data/data/themes/default-theme.yml +5 -4
  27. data/data/themes/default-with-fallback-font-theme.yml +2 -9
  28. data/data/themes/default-with-font-fallbacks-theme.yml +9 -0
  29. data/docs/theming-guide.adoc +5 -6050
  30. data/lib/asciidoctor/pdf/converter.rb +505 -294
  31. data/lib/asciidoctor/pdf/ext/pdf-core/page.rb +8 -0
  32. data/lib/asciidoctor/pdf/ext/prawn/document/column_box.rb +16 -0
  33. data/lib/asciidoctor/pdf/ext/prawn/extensions.rb +110 -58
  34. data/lib/asciidoctor/pdf/ext/prawn/formatted_text/box.rb +14 -0
  35. data/lib/asciidoctor/pdf/ext/prawn/formatted_text/indented_paragraph_wrap.rb +39 -0
  36. data/lib/asciidoctor/pdf/ext/prawn-table/cell/asciidoc.rb +3 -10
  37. data/lib/asciidoctor/pdf/ext/prawn.rb +2 -0
  38. data/lib/asciidoctor/pdf/formatted_text/source_wrap.rb +7 -2
  39. data/lib/asciidoctor/pdf/nopngmagick.rb +3 -0
  40. data/lib/asciidoctor/pdf/optimizer.rb +12 -5
  41. data/lib/asciidoctor/pdf/text_transformer.rb +14 -0
  42. data/lib/asciidoctor/pdf/theme_loader.rb +9 -3
  43. data/lib/asciidoctor/pdf/version.rb +1 -1
  44. metadata +9 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: da863e1bc05edaf64e5e443bb042fdaa01cc048ac559c9955bac4d7c27fff1c1
4
- data.tar.gz: 0712e9ee6655c004b82f64c78d3c1eb326c182576e447669cce11e4ff7ca34db
3
+ metadata.gz: b935ce3aea7b70edb830a1f0c5bda65946906f5237c62e092520a3278601d382
4
+ data.tar.gz: fc94d51df27157920ce16afb6550a05c045ffa3b0dd5f5db033c90bd17c84304
5
5
  SHA512:
6
- metadata.gz: 8626792d427b27b635a6836fa0c1c7bf75faff5d82f1a71d74a23333e516086475e268cd524a5f5d2c0cfc9827b5b0f72a9d41fd6cc6b7c568506d914daf6840
7
- data.tar.gz: 764bc2e6b6f069d437583c095a92f9e92969e306c872ea92c52e805c0063fa1d810390a303b597252adb9ca33015bd340f5e8d3851a0d64bb96d0cdc5d523329
6
+ metadata.gz: a51edc93917183ef48c430a33df763404706a6dc72a4fc248b03760a8f3c7c21d53b2aa3a289f01acd2e765c34ad9a1d5b0022590a51a6d4d3acbe406d779155
7
+ data.tar.gz: ab163214c8bf89866dd2eaed94e6c99662431268757b5e1e7023545bd3fb58484008f633d49974b32cc4b1e13455cb54ef77dc7e3e385d5feac36bdf67d8897e
data/CHANGELOG.adoc CHANGED
@@ -1,9 +1,111 @@
1
1
  = {project-name} Changelog
2
2
  :project-name: Asciidoctor PDF
3
- :uri-repo: https://github.com/asciidoctor/asciidoctor-pdf
3
+ :url-repo: https://github.com/asciidoctor/asciidoctor-pdf
4
4
 
5
5
  This document provides a high-level view of the changes to the {project-name} by release.
6
- For a detailed view of what has changed, refer to the {uri-repo}/commits/main[commit history] on GitHub.
6
+ For a detailed view of what has changed, refer to the {url-repo}/commits/main[commit history] on GitHub.
7
+
8
+ == 2.0.0.beta.2 (2022-05-14) - @mojavelinux
9
+
10
+ Enhancements::
11
+
12
+ * add support for float attribute on image; wrap ensuing paragraphs around image with `float` attribute (#353)
13
+ * add `supports_float_wrapping?` method for extended converter to override to enlist other blocks in float wrapping; add example to docs (#353)
14
+ * add `image-float-gap` key to theme to control space around image float (#353)
15
+ * add support for `text-transform` property on first line of abstract in theme (#2141)
16
+ * rename `resolve_alignment_from_role` to `resolve_text_align_from_role` to reflect proper terminology and purpose; alias old method name
17
+ * add support for orphan avoidance to discrete headings to match behavior of section titles (using call to `arrange_heading`) (#2151)
18
+ * rename `arrange_section` to `arrange_heading` to reflect proper terminology and purpose
19
+ * add `index-column-gap` key to theme to control size of gap between columns
20
+ * coerce `image-caption-max-width` to `fit-content` if `float` attribute is set on block image (#2150)
21
+ * add support for text box with fixed height via `:height` option to `typeset_text` helper
22
+ * configure `typeset_text` and `ink_prose` to return remaining fragments when `:height` option is specified
23
+ * add support for `:indent_paragraphs` option to formatted text box (#353)
24
+ * 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
25
+ * add built-in default-sans theme
26
+
27
+ Improvements::
28
+
29
+ * rename theme suffix with-fallback-font to with-font-fallbacks
30
+ * rename sans-with-fallback-font theme to default-sans-with-font-fallbacks
31
+ * configure spacing around thematic break using `thematic-break-padding` key instead of margin top and bottom (#2164)
32
+ * rename `convert_listing_or_literal` to `convert_code` and alias old name
33
+ * reify convert handler for STEM blocks (`convert_stem`)
34
+ * reify convert handler for pass blocks (`convert_pass`) and remove block decoration
35
+
36
+ Bug Fixes::
37
+
38
+ * honor `caption-align` when element align is not `left` and `caption-max-width` is % of element width (e.g., `fit-content(50%)`) (#2156)
39
+ * do not orphan sidebar title (#2158)
40
+ * allow theme to set font style of first line of abstract to `normal_italic` (#2138)
41
+ * add support for `:color` option to `Prawn::Text::Formatted::Box` directly and remove workarounds
42
+ * preserve columns on subsequent pages in the index section (#2149)
43
+ * fix return value of `cursor` method inside block for column box in index section
44
+ * correctly detect preceding code block when determining whether to collapse top margin of colist
45
+ * apply bottom margin to thematic break that falls at top of page (#2164)
46
+ * allow extended converter to override `convert_code` method to handle `convert_listing` and `convert_literal` calls
47
+ * restore margin below pass block
48
+ * remove use of deprecated theme keys in default-for-print theme
49
+
50
+ === Details
51
+
52
+ {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]
53
+
54
+ == 2.0.0.beta.1 (2022-05-04) - @mojavelinux
55
+
56
+ Enhancements::
57
+
58
+ * introduce `index-pagenum-sequence-style` document attribute to control style of sequential page numbers in index when media=screen (#1656)
59
+ * allow entry for document in outline to be controlled using `outline-title` attribute (#1789)
60
+ * allow extended converter to insert or filter toc entries by overriding `get_entries_for_toc` method (#2097)
61
+ * add `asciidoctor/pdf/nopngmagick` script to unregister Gmagick handler for PNG images only (#1687)
62
+ * allow theme to configure which end the caption is placed for a block image (#2115)
63
+ * add `Page#imported` method to mark page as imported (which suppresses running content)
64
+ * add support for `smallcaps` text transform by replacing lowercase letters with small capital variants (#1192)
65
+ * use `base-border-color` as default border color; control appearance of border using `border-width` value alone (#2134)
66
+ * remove border colors in base theme so all border colors can be controlled using `base-border-color` when extending theme
67
+ * enable running footer when using base theme
68
+
69
+ Bug Fixes::
70
+
71
+ * allow border width of block image to be specified as an array (1, 2, or 4 values) (#2119)
72
+ * rename `delete_page` extension method to `delete_current_page` to avoid conflict with incompatible method on `Prawn::Document`
73
+ * remap `table-caption-side` theme key to `table-caption-end` (#2125)
74
+ * add missing glyph for `ÿ` in built-in fonts
75
+ * remove use of deprecated keys in chronicles-dark-theme.yml
76
+
77
+ === Details
78
+
79
+ {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]
80
+
81
+ == 2.0.0.alpha.3 (2022-05-01) - @mojavelinux
82
+
83
+ Enhancements::
84
+
85
+ * allow border width of block to be specified per edge using 4-value array (#2102)
86
+ * 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)
87
+ * 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)
88
+ * allow theme to set border and padding on headings per level (#434)
89
+
90
+ Improvements::
91
+
92
+ * reduce top and bottom padding on quote and verse blocks in base theme
93
+ * use uniform top and bottom padding on quote blocks in default theme
94
+ * change `inscribe_` method prefix in converter to `ink_`
95
+
96
+ Bug Fixes::
97
+
98
+ * allow `ink_toc` method in extended converter to insert page above TOC page
99
+ * remap `layout_` methods contributed to converter by prepended module
100
+ * neutralize padding hacks in themes designed before the converter had smart margins
101
+ * allow the smallest ends or sides border width on block to be less than 1
102
+ * cap border corners on block when width is defined using array (uniform or otherwise) (#2103)
103
+ * fix crash in certain circumstances when theme does not define value for `base-border-width` key
104
+ * use sensible fallbacks for table border and grid color and width (retains backwards compatibility)
105
+
106
+ === Details
107
+
108
+ {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]
7
109
 
8
110
  == 2.0.0.alpha.2 (2022-04-29) - @mojavelinux
9
111
 
@@ -12,15 +114,15 @@ Enhancements::
12
114
  * separate `align` and `text-align` keys in theme schema; remap old keys for backwards compatibility (#2095)
13
115
  * allow theme to control the border on all sides of tables independently (#902)
14
116
  * keep section title with first block of content is `breakable` option is set on section (#2075, #38)
15
- * pass `part`, `chapterlike`, and `hidden` options to `arrange_section` method
117
+ * pass the `part` and `chapterlike` options to the `arrange_section` method for convenience
16
118
  * add support for `background-color` property on caption (#1995)
17
119
  * add support for image-based icons, resolved from `iconsdir` and having the `icontype` file extension (#1770)
18
- * add `asciidoctor/pdf/nogmagick` script to prevent Gmagick from handling PNG images (#1687)
120
+ * add `asciidoctor/pdf/nogmagick` script to prevent loading prawn-gmagick gem (#1687)
19
121
  * change name of `untitled` option on special section to `notitle`
20
122
  * allow the title of any section to be hidden using the `notitle` option
21
123
  * allow imported PDF page to be referenced in TOC by enclosing in parent section with `notitle` option (#1213)
22
124
  * allow entry for preface to be added to TOC without adding title to body using the `notitle` option on the preface section (#1786)
23
- * automatically promote the `notitle` option from the first block in the premable to preface section; restore lead role on opening paragraph (#1786)
125
+ * automatically promote the `notitle` option from the first block in the preamble to preface section; restore lead role on opening paragraph (#1786)
24
126
 
25
127
  Improvements::
26
128
 
@@ -36,7 +138,7 @@ Bug Fixes::
36
138
  * delete dests on page before deleting it (keeps generated PDF clean of obsolete destinations)
37
139
  * don't call `arrange_section` if section title is hidden
38
140
  * remove `theme_font` enclosure around call to `start_new_chapter` and `start_new_part`
39
- * change `layout_` method prefix to `inscribe_` in converter (#2099)
141
+ * change `layout_` method prefix in converter to `inscribe_` (#2099)
40
142
 
41
143
  === Details
42
144
 
@@ -47,13 +149,13 @@ Bug Fixes::
47
149
  Enhancements::
48
150
 
49
151
  * make delimited blocks breakable by default; require the `unbreakable` option on the block to retain the previous "`keep together`" behavior (#2004, #578, #509, #240)
50
- * add support for the %unbreakable option on a table to prevent it from being split across pages (#2022, #871, #819, #331)
51
- * 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)
152
+ * add support for the `unbreakable` option on a table to prevent it from being split across pages (#2022, #871, #819, #331)
153
+ * 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)
52
154
  * implement smart bottom margins on blocks to prevent extra space below blocks, particularly nested blocks (#1515, #1513, #1845)
53
155
  * 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)
54
156
  * allow location of anchor for block to be positioned relative to content using `block-anchor-top` key in theme (#2013)
55
- * 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)
56
- * 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)
157
+ * 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)
158
+ * 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)
57
159
  * allow theme to configure page numbering to start at cover (#1727)
58
160
  * allow the front and back cover images to be defined in the theme (#1584)
59
161
  * allow the front and back cover images to be specified as a data URI (#1584)
@@ -90,7 +192,7 @@ Enhancements::
90
192
  * normalize space characters in authors content and drop lines with unresolved attribute references (#1642)
91
193
  * skip image block with missing image if computed alt text resolves to empty string (#1645)
92
194
  * custom theme does not inherit from base theme by default; must be specified explicitly using `extends: base` (#1640)
93
- * allow theme to configure number of index columns using `index_columns` key (#1663)
195
+ * allow theme to configure number of index columns using `index-columns` key (#1663)
94
196
  * configure AsciiDoc table cell to inherit font properties from table and scale font size of nested blocks (#926)
95
197
  * scale font size of literal table cell (#1696)
96
198
  * add support for `id` attribute on link macro
@@ -101,13 +203,13 @@ Enhancements::
101
203
  * allow admonition icon image to be remote (if allow-uri-read is set) or data URI (#1711)
102
204
  * allow theme to configure font color of unresolved footnote using unresolved role
103
205
  * show textual label on admonition if icon image fails to embed (#1741)
104
- * allow theme to disable title page by assigning false to `title_page` category key (#1754)
206
+ * allow theme to disable title page by assigning false to `title-page` category key (#1754)
105
207
  * allow Rouge theme to be specified as theme class or instance (API only)
106
208
  * allow theme to control font size of dot leader in TOC
107
- * allow section to override outlinelevels for self and children using `outlinelevels` attribute on section
209
+ * allow section to override `outlinelevels` for self and children using `outlinelevels` attribute on section
108
210
  * use value of `author` attribute for PDF info and pdfmark if locked by the API (#1778)
109
211
  * only extend theme in extends hierarchy once unless modified with `!important` (#1800)
110
- * add print-optimized themes (default-for-print and default-for-print-with-fallback-font) (#1699)
212
+ * add print-optimized themes (`default-for-print` and `default-for-print-with-fallback-font`) (#1699)
111
213
  * add support for power operator in theme (with same precedence as multiply and divide) (#1813)
112
214
  * include floor and ceil match characters in fallback font (#1832) (*@oddhack*)
113
215
  * allow horizontal and vertical lines of table grid to be styled independently (#1875) (*@hextremist*)
@@ -134,7 +236,7 @@ Bug Fixes::
134
236
  * do not insert blank line in index when term is forced to break (#1665)
135
237
  * honor prepress page margins on subsequent pages in index (#1929)
136
238
  * use more robust strategy for line height normalization that accounts for case when line contains only monospaced text (#1650)
137
- * add support for line-height property on lead role as documented
239
+ * add support for `line-height` property on `lead` role as documented
138
240
  * prevent generator from allocating space for placeholder null char (used for anchors) if font is missing glyph (#1672)
139
241
  * ensure background and admonition icon image files are closed after being read (#1566)
140
242
  * ensure temporary images generated by running content are cleaned up (#1566)
@@ -191,10 +293,10 @@ Bug Fixes::
191
293
  * fix vertical center alignment of normal table cell
192
294
  * short-circuit xreftext containing a circular reference path
193
295
  * prevent PDF page import from corrupting references in PDF (#1726)
194
- * display decimal list marker correctly when list is reversed (e.g., 10., 09., 08., etc)
296
+ * display decimal list marker correctly when list is reversed (e.g., 10., 09., 08., etc.)
195
297
  * use correct spacing for dotted border dash on table (length and spacing should match width)
196
298
  * set color space on page with only image so font color is preserved in running content (#1742)
197
- * compute font size for superscript and subscript correctly when parent element uses em and % units (#1745)
299
+ * compute font size for superscript and subscript correctly when parent element uses `em` and `%` units (#1745)
198
300
  * respect hyphenation exceptions when word is adjacent to non-word character (#1715)
199
301
  * fix crash when TOC is enabled and index is empty
200
302
  * align TOC section properly when index exceeds one page and `section_indent` is positive (#1735)
@@ -229,7 +331,7 @@ Bug Fixes::
229
331
  * verify alignment of list marker in AsciiDoc table cell (#1965)
230
332
  * don't crash if value of `width` attribute on image has invalid format (#1970)
231
333
  * don't render borders and backgrounds in scratch document
232
- * don't insert blank page after document title if first block (chapter or toc macro) has nonfacing option (#1988)
334
+ * don't insert blank page after document title if first block (chapter or toc macro) has `nonfacing` option (#1988)
233
335
  * coerce negated variable reference to number if value of variable is numeric
234
336
  * prepress page margins should honor value of `pdf-folio-placement` (#1918)
235
337
  * ensure callout number in callout list stays with primary text when item is advanced to next page (#1967)
@@ -505,7 +607,7 @@ Bug Fixes::
505
607
  * allow theme to control font properties (font size, font color, etc) of description list term (#1289)
506
608
  * allow theme to override caption styles for specific block categories: blockquote, code, example, footnotes, image, listing, and table (#307)
507
609
  * allow theme to control style of verse block independently of a quote block (#40)
508
- * position list marker correctly when media=prepress and list item is advanced to next page or split across pages (#1303)
610
+ * position list marker correctly when `media=prepress` and list item is advanced to next page or split across pages (#1303)
509
611
  * layout horizontal dlist in two columns (#310)
510
612
  * apply normal substitutions to content of manname section (#1294)
511
613
  * optimize PDF using quality specified in value of optimize attribute if optimize attribute is set (#535)
@@ -542,7 +644,7 @@ Bug Fixes::
542
644
  * allow multiple font dirs to be specified using the pdf-fontsdir attribute (#80)
543
645
  * fill and stroke bounds of example across all pages (#362)
544
646
  * allow page background color and background image to be used simultaneously (#1186)
545
- * allow theme to specifiy initial zoom (#305)
647
+ * allow theme to specify initial zoom (#305)
546
648
  * strip surrounding whitespace from text in normal table cells
547
649
  * allow attribute references to be used in image paths in theme (#588)
548
650
  * resolve variables in font catalog in theme file
@@ -555,11 +657,11 @@ Bug Fixes::
555
657
  * reduce min font size in base theme
556
658
  * allow theme to configure the minimum height required after a section title for it to stay on same page (#1210)
557
659
  * convert hyphen to underscore in theme key for admonition icon type (#1217)
558
- * always resolve images in running content relative to themesdir (instead of document) (#1183)
660
+ * always resolve images in running content relative to `themesdir` (instead of document) (#1183)
559
661
  * fix placement of toc in article when doctitle is not set (#1240)
560
662
  * honor text alignment role on abstract paragraph(s)
561
- * don't insert blank page at start of document if media=prepress and document does not have a cover (#1181)
562
- * insert blank page after cover if media=prepress (#1181)
663
+ * don't insert blank page at start of document if `media=prepress` and document does not have a cover (#1181)
664
+ * insert blank page after cover if `media=prepress` (#1181)
563
665
  * add support for stretch role on table (as preferred alias for spread) (#1225)
564
666
  * include revremark on title page if specified (#1198)
565
667
  * allow theme to configure border around block image (#767)
@@ -583,13 +685,13 @@ Bug Fixes::
583
685
  * only apply title page background image to the title page (#1144)
584
686
  * 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)
585
687
  * fix crash when image_width is defined in theme (#995)
586
- * fix crash when toc is enabled and toc-title attribute is unset
688
+ * fix crash when toc is enabled and `toc-title` attribute is unset
587
689
  * correctly map legacy Font Awesome icon names when icon set is not specified (#1157)
588
690
  * coerce color values in theme that contain uppercase letters (#1149)
589
691
  * prevent table alignment from modifying margins of subsequent pages; only align table if width is less than bounds (#1170)
590
692
  * ensure base font color is set
591
693
  * use more robust mechanism to detect an empty page; tare content stream after adding page background color or image
592
- * ignore pdf-themesdir unless pdf-theme is specified (#1167)
694
+ * ignore `pdf-themesdir` unless pdf-theme is specified (#1167)
593
695
  * allow theme to control glyphs used for conums (#133)
594
696
  * allow theme to control background and border of inline kbd (#313, #1004)
595
697
  * add support for link on image in running content (#1002)
@@ -606,12 +708,12 @@ Bug Fixes::
606
708
 
607
709
  == 1.5.0.beta.1 (2019-07-08) - @mojavelinux
608
710
 
609
- * rename pdf-style and pdf-stylesdir attributes to pdf-theme and pdf-themesdir, respectively (while still honoring the old names for compatibility) (#1127)
610
- * don't load fallback font by default; move fallback font to default-with-fallback-font theme
711
+ * rename `pdf-style` and `pdf-stylesdir` attributes to `pdf-theme` and `pdf-themesdir`, respectively (while still honoring the old names for compatibility) (#1127)
712
+ * don't load fallback font by default; move fallback font to `default-with-fallback-font` theme
611
713
  * apply cell padding to table cells in the head row (#1098)
612
- * allow the theme to control the padding of table cells in the head row using the table_head_cell_padding key (#1098)
714
+ * allow the theme to control the padding of table cells in the head row using the `table_head_cell_padding` key (#1098)
613
715
  * fix position of table caption for reduced-width tables when caption align is center (#1138)
614
- * adjust width of table caption to match width of table unless table_caption_max_width is none in theme (#1138)
716
+ * adjust width of table caption to match width of table unless `table_caption_max_width` is none in theme (#1138)
615
717
  * fix position of text in running header (#1087)
616
718
  * ignore start attribute on ordered list if marker is disabled
617
719
  * allow start value to be negative for ordered lists that use arabic or roman numbering (#498)
@@ -620,13 +722,13 @@ Bug Fixes::
620
722
  * scale SVG background image to fit page in the same way raster image is scaled (#765)
621
723
  * allow page background size to be controlled using image macro attributes (#1117)
622
724
  * allow page background image position to be controlled using position attribute on image macro (#1124)
623
- * add support for fit=cover for cover, page background, and running content images (#1136)
725
+ * add support for `fit=cover` for cover, page background, and running content images (#1136)
624
726
  * change default background image position to center (#1124)
625
727
  * allow cover image position to be controlled using position attribute on image macro (#1134)
626
728
  * change default cover image position to center (#1134)
627
729
  * allow cover image size to be controlled using fit, pdfwidth, and width attributes; don't scale image by default (#1134)
628
- * set enable_file_requests_with_root and enable_web_requests options for all SVGs (#683)
629
- * automatically set pdf-stylesdir if pdf-style ends with .yml and pdf-stylesdir is not specified (#1126)
730
+ * set `enable_file_requests_with_root` and `enable_web_requests` options for all SVGs (#683)
731
+ * automatically set `pdf-stylesdir` if `pdf-style` ends with .yml and `pdf-stylesdir` is not specified (#1126)
630
732
  * replace hyphens with underscores in top-level theme keys
631
733
  * allow hyphens to be used in variable references in theme (#1122)
632
734
  * allow theme to control background and border of inline code (literal) (#306)
@@ -674,7 +776,7 @@ Bug Fixes::
674
776
  * add visual regression capability to test suite (@beatchristen)
675
777
  * ensure index section doesn't get numbered when using Asciidoctor < 1.5.7
676
778
  * add part signifier and part number to part title if partnums is set; allow signifier to be customized using part-signifier attribute (#597)
677
- * add support for the chapter-signifier attribute as the prefered alternative to chapter-label
779
+ * add support for the chapter-signifier attribute as the preferred alternative to chapter-label
678
780
  * warn if the image referenced in the running content cannot be found (#731)
679
781
 
680
782
  == 1.5.0.alpha.17 (2019-04-23) - @mojavelinux
@@ -687,7 +789,7 @@ Bug Fixes::
687
789
  * drop support for Rouge < 2
688
790
  * add a test suite (#37)
689
791
  * allow running content (header and footer) to be enabled on title and toc pages; controlled by running_content_start_at property in theme (#606)
690
- * add support for nbsp named entity (i.e., `+&nbsp;`); replace occurances of nbsp named entity with a single space in outline
792
+ * add support for nbsp named entity (i.e., `+&nbsp;`); replace occurrences of nbsp named entity with a single space in outline
691
793
  * upgrade to FontAwesome 5; introduce the fas, far, and fab icon sets, now preferred over fa; drop support for octicons (#891) (@jessedoyle)
692
794
  * place footnotes at end of chapters in books or end of document otherwise (#85) (@bcourtine)
693
795
  * fix rendering of footnotes directly adjacent to text in a normal table cell (#927)
@@ -699,14 +801,14 @@ Bug Fixes::
699
801
  * set line spacing for non-AsciiDoc table cells (#296)
700
802
  * consider all scripts when looking for leading alpha characters in index (#853)
701
803
  * don't create title page for article doctype unless title-page attribute is set (#105)
702
- * don't show article title if notitle attribute is set (#998)
804
+ * don't show article title if `notitle` attribute is set (#998)
703
805
  * generate name section for manpage doctype automatically (#882)
704
806
  * remove unprocessed passthroughs in literal cells
705
807
  * apply font style from theme to formatted text description list term (#854)
706
808
  * prevent tempfile for remote image from being deleted before it's used (#947)
707
809
  * handle case when uri to make breakable is empty (#936)
708
- * add support for frame=ends as alternative to frame=topbot on table
709
- * allow table frame and grid to be set globally using the table-frame and table-grid attributes (#822)
810
+ * add support for `frame=ends` as alternative to `frame=topbot` on table
811
+ * allow table frame and grid to be set globally using the `table-frame` and `table-grid` attributes (#822)
710
812
  * disable table stripes by default (#1049)
711
813
  * allow table stripes to be enabled globally using table-stripes attribute (#1049)
712
814
  * use new logging subsystem, if available; otherwise, use shim (#905)
@@ -766,8 +868,8 @@ Bug Fixes::
766
868
  * document in README how to install Asciidoctor PDF on Ruby 2.0.0
767
869
  * enable Travis CI; configure CI-based deployment to RubyGems.org
768
870
 
769
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.16[issues resolved] |
770
- {uri-repo}/releases/tag/v1.5.0.alpha.16[git tag]
871
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.16[issues resolved] |
872
+ {url-repo}/releases/tag/v1.5.0.alpha.16[git tag]
771
873
 
772
874
  == 1.5.0.alpha.15 (2017-03-27) - @mojavelinux
773
875
 
@@ -801,8 +903,8 @@ Bug Fixes::
801
903
  * document that background images are scaled to fit bounds of page
802
904
  * add note in theming guide about using double quoted strings
803
905
 
804
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.15[issues resolved] |
805
- {uri-repo}/releases/tag/v1.5.0.alpha.15[git tag]
906
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.15[issues resolved] |
907
+ {url-repo}/releases/tag/v1.5.0.alpha.15[git tag]
806
908
 
807
909
  == 1.5.0.alpha.14 (2017-02-05) - @mojavelinux
808
910
 
@@ -908,16 +1010,16 @@ Bug Fixes::
908
1010
  * clarify in README how inline image are sized
909
1011
  * clarify instructions in README about how to specify a page number range for printing
910
1012
  * document in theming guide how to define and apply a custom Rouge theme
911
- * rename pdfmarks to pdfmarks; document pdfmark attribute in theming guide
1013
+ * rename `pdfmarks` to `pdfmarks`; document pdfmark attribute in theming guide
912
1014
  * describe the quoted string value type in the theming guide
913
1015
  * add self-referencing anchor to each key prefix in theming guide
914
- * document nonfacing option for sections (@jnerlich)
915
- * fix documentation for toc_dot_leader_font_color in theming guide (@davidgamba)
1016
+ * document `nonfacing` option for sections (@jnerlich)
1017
+ * fix documentation for `toc_dot_leader_font_color` in theming guide (@davidgamba)
916
1018
  * document that dot leader inherits font properties from toc category
917
1019
  * fill in missing defaults for keys in theming guide
918
1020
  * rewrite intro to Keys section in theming guide
919
1021
  * add keys for prose, menu, and conum categories to theming guide
920
- * document outline_list_marker_font_color key in theming guide
1022
+ * document `outline_list_marker_font_color` key in theming guide
921
1023
  * refactor measurement value helpers into module (#677)
922
1024
  * add reproducible flag to examples
923
1025
  * add inline ref and corresponding xref to chronicles example
@@ -925,12 +1027,12 @@ Bug Fixes::
925
1027
  * update instructions and Gemfile config to use with Ruby 1.9.3
926
1028
  * configure build as the default rake task
927
1029
 
928
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.14[issues resolved] |
929
- {uri-repo}/releases/tag/v1.5.0.alpha.14[git tag]
1030
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.14[issues resolved] |
1031
+ {url-repo}/releases/tag/v1.5.0.alpha.14[git tag]
930
1032
 
931
1033
  == 1.5.0.alpha.13 (2016-09-19) - @mojavelinux
932
1034
 
933
- * Add support for mirror (recto/verso) margins and facing pages when media=prepress
1035
+ * Add support for mirror (recto/verso) margins and facing pages when `media=prepress`
934
1036
  * Add non-breaking hyphen glyph to built-in fonts so its intended behavior is honored (#462)
935
1037
  * Add page break before a book part (#329)
936
1038
  * Allow running (header/footer) content to be arranged in columns (#449)
@@ -945,7 +1047,7 @@ Bug Fixes::
945
1047
  * Add support for literal and verse table cell styles
946
1048
  * Preserve indentation in literal and verse table cells
947
1049
  * Preserve paragraph breaks in normal table cells
948
- * Honor value of width attribute even when autowidth option is set on table (#519)
1050
+ * Honor value of width attribute even when `autowidth` option is set on table (#519)
949
1051
  * Align table title to left edge of table, regardless of table alignment (#469)
950
1052
  * Add support for reversed option on ordered list (#491)
951
1053
  * Don't drop whitespace in front of conum on final line of source block (#470)
@@ -955,16 +1057,16 @@ Bug Fixes::
955
1057
  * Resolve bare image-related attribute values relative to base_dir
956
1058
  * Only allow Prawn SVG to fetch remote images if the allow-uri-read attribute is set (#548)
957
1059
  * Introduce page_margin_inner and page_margin_outer keys to theme
958
- * Start title page, toc, main content, parts, and chapters on recto page when media=prepress and doctype=book
959
- * Allow default font style for table to be set via theme (table_font_style)
1060
+ * Start title page, toc, main content, parts, and chapters on recto page when `media=prepress` and `doctype=book`
1061
+ * Allow default font style for table to be set via theme (`table_font_style`)
960
1062
  * Use correct default bullet per nested unordered list level (#529)
961
- * Call start_new_part at start of each book part
962
- * Delegate to layout_part_title method to layout part title
1063
+ * Call `start_new_part` at start of each book part
1064
+ * Delegate to `layout_part_title` method to layout part title
963
1065
  * Don't match a special section as a chapter unless the doctype is book
964
1066
  * Fix list marker placement when list item touches bottom of page
965
1067
  * Eliminate excessive spacing between list items that contain nested lists
966
1068
  * Drop lines in running (header/footer) content with unresolved attributes (#522)
967
- * Ensure start_new_chapter is always executed at a chapter transition (#524)
1069
+ * Ensure `start_new_chapter` is always executed at a chapter transition (#524)
968
1070
  * Add support for root xref (e.g., &lt;&lt;included-doc#&gt;&gt;) (#521)
969
1071
  * Prevent block from spilling to next page if there's no more content (#361)
970
1072
  * Add support for px units to pdf-page-size attribute
@@ -992,8 +1094,8 @@ Bug Fixes::
992
1094
  * Configure README for better preview on GitHub
993
1095
  * Update chronicles example to modern AsciiDoc syntax; update content
994
1096
 
995
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.13[issues resolved] |
996
- {uri-repo}/releases/tag/v1.5.0.alpha.13[git tag]
1097
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.13[issues resolved] |
1098
+ {url-repo}/releases/tag/v1.5.0.alpha.13[git tag]
997
1099
 
998
1100
  == 1.5.0.alpha.12 (2016-08-05) - @mojavelinux
999
1101
 
@@ -1010,7 +1112,7 @@ Bug Fixes::
1010
1112
  * Document theme-related AsciiDoc attributes in theming guide (#428)
1011
1113
  * Section title alignment should be customizable via theme (#343)
1012
1114
  * Collapse all whitespace when normalizing (#355)
1013
- * Require space on either side of math operator to avoid interpretting dates as math equations (#429)
1115
+ * Require space on either side of math operator to avoid interpreting dates as math equations (#429)
1014
1116
  * Allow specifying a font style for a title on the title page (#423)
1015
1117
  * Fix Prawn SVG to support arrow heads on lines (#75)
1016
1118
  * Upgrade prawn-svg to 0.25.1
@@ -1029,8 +1131,8 @@ Bug Fixes::
1029
1131
  * Add hints to theming guide about how to apply styles when using Maven or Gradle (@fwilhe)
1030
1132
  * Fix gemspec to collect files when project is not a git repository or git is not available
1031
1133
 
1032
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.12[issues resolved] |
1033
- {uri-repo}/releases/tag/v1.5.0.alpha.12[git tag]
1134
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.12[issues resolved] |
1135
+ {url-repo}/releases/tag/v1.5.0.alpha.12[git tag]
1034
1136
 
1035
1137
  == 1.5.0.alpha.11 (2016-01-05) - @mojavelinux
1036
1138
 
@@ -1053,14 +1155,14 @@ Bug Fixes::
1053
1155
  * Document that page background colors & images do not currently work in AsciidoctorJ PDF
1054
1156
  * Use failproof relative require logic in bin script
1055
1157
 
1056
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.11[issues resolved] |
1057
- {uri-repo}/releases/tag/v1.5.0.alpha.11[git tag]
1158
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.11[issues resolved] |
1159
+ {url-repo}/releases/tag/v1.5.0.alpha.11[git tag]
1058
1160
 
1059
1161
  == 1.5.0.alpha.10 (2015-11-01) - @mojavelinux
1060
1162
 
1061
1163
  * Allow admonition icon to be customized by theme (#121) (@jessedoyle)
1062
1164
  * Update to prawn-icon 1.0.0 (#335) (@jessedoyle)
1063
- * Only generate the pdfmarks file if the pdfmarks attribute is set
1165
+ * Only generate the pdfmarks file if the `pdfmarks` attribute is set
1064
1166
  * Honor table alignment (via align attribute or role) (#299)
1065
1167
  * Use Hash for ViewerPreferences; set initial magnification (#303)
1066
1168
  * Handle case when colpcwidth is unspecified (#314)
@@ -1071,8 +1173,8 @@ Bug Fixes::
1071
1173
  * Document theme key that sets sidebar padding (#344)
1072
1174
  * Handle case when CodeRay passes nil text to text_token
1073
1175
 
1074
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.10[issues resolved] |
1075
- {uri-repo}/releases/tag/v1.5.0.alpha.10[git tag]
1176
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.10[issues resolved] |
1177
+ {url-repo}/releases/tag/v1.5.0.alpha.10[git tag]
1076
1178
 
1077
1179
  == 1.5.0.alpha.9 (2015-08-02) - @mojavelinux
1078
1180
 
@@ -1107,8 +1209,8 @@ Bug Fixes::
1107
1209
  * Upgrade thread_safe gem
1108
1210
  * Prevent crash if doc has no sections (@abatalev)
1109
1211
 
1110
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.9[issues resolved] |
1111
- {uri-repo}/releases/tag/v1.5.0.alpha.9[git tag]
1212
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.9[issues resolved] |
1213
+ {url-repo}/releases/tag/v1.5.0.alpha.9[git tag]
1112
1214
 
1113
1215
  == 1.5.0.alpha.8 (2015-06-23) - @mojavelinux
1114
1216
 
@@ -1145,8 +1247,8 @@ Bug Fixes::
1145
1247
  * Update theming guide
1146
1248
  * Fix cross references in README
1147
1249
 
1148
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.8[issues resolved] |
1149
- {uri-repo}/releases/tag/v1.5.0.alpha.8[git tag]
1250
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.8[issues resolved] |
1251
+ {url-repo}/releases/tag/v1.5.0.alpha.8[git tag]
1150
1252
 
1151
1253
  == 1.5.0.alpha.7 (2015-05-31) - @mojavelinux
1152
1254
 
@@ -1176,7 +1278,7 @@ Bug Fixes::
1176
1278
  * Show warning when image cannot be read (#148)
1177
1279
  * Allow page background image to be specified (#134)
1178
1280
  * Support PDF format as cover page (#113)
1179
- * Accomodate numbered list with large numbers (#91)
1281
+ * Accommodate numbered list with large numbers (#91)
1180
1282
  * Position list marker correctly (#140)
1181
1283
  * Allow theme to set font size & family of table cells (#139)
1182
1284
  * Unencode character entities in document title (#136)
@@ -1199,8 +1301,8 @@ Bug Fixes::
1199
1301
  * Use SafeYAML to load theme files
1200
1302
  * Handle transparent value for table background colors
1201
1303
 
1202
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.7[issues resolved] |
1203
- {uri-repo}/releases/tag/v1.5.0.alpha.7[git tag]
1304
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.7[issues resolved] |
1305
+ {url-repo}/releases/tag/v1.5.0.alpha.7[git tag]
1204
1306
 
1205
1307
  == 1.5.0.alpha.6 (2014-11-28) - @mojavelinux
1206
1308
 
@@ -1209,8 +1311,8 @@ Bug Fixes::
1209
1311
  * Add example for specifying theme file (Leif Gruenwoldt) (#61)
1210
1312
  * Add thread_safe gem to remove warning when registering converter
1211
1313
 
1212
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.6[issues resolved] |
1213
- {uri-repo}/releases/tag/v1.5.0.alpha.6[git tag]
1314
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.6[issues resolved] |
1315
+ {url-repo}/releases/tag/v1.5.0.alpha.6[git tag]
1214
1316
 
1215
1317
  == 1.5.0.alpha.5 (2014-09-15) - @mojavelinux
1216
1318
 
@@ -1220,35 +1322,35 @@ Bug Fixes::
1220
1322
  * Don't activate implicit header include processor by default (#48, #25)
1221
1323
  * Draw box around listings and literal blocks than span more than one page (#11)
1222
1324
 
1223
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.5[issues resolved] |
1224
- {uri-repo}/releases/tag/v1.5.0.alpha.5[git tag]
1325
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.5[issues resolved] |
1326
+ {url-repo}/releases/tag/v1.5.0.alpha.5[git tag]
1225
1327
 
1226
1328
  == 1.5.0.alpha.4 (2014-09-09) - @mojavelinux
1227
1329
 
1228
1330
  * Fix yield statement so Asciidoctor PDF can be used with JRuby
1229
1331
  * Document that the coderay gem must be installed to run the examples (#42)
1230
1332
 
1231
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.4[issues resolved] |
1232
- {uri-repo}/releases/tag/v1.5.0.alpha.4[git tag]
1333
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.4[issues resolved] |
1334
+ {url-repo}/releases/tag/v1.5.0.alpha.4[git tag]
1233
1335
 
1234
1336
  == 1.5.0.alpha.3 (2014-09-08) - @mojavelinux
1235
1337
 
1236
1338
  * Remove unnecessary dependencies (tilt, slim, thread_safe)
1237
1339
 
1238
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.3[issues resolved] |
1239
- {uri-repo}/releases/tag/v1.5.0.alpha.3[git tag]
1340
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.3[issues resolved] |
1341
+ {url-repo}/releases/tag/v1.5.0.alpha.3[git tag]
1240
1342
 
1241
1343
  == 1.5.0.alpha.2 (2014-09-05) - @mojavelinux
1242
1344
 
1243
1345
  * Add magic encoding header to source file so Asciidoctor PDF can be used with Ruby 1.9.3 (#33, #36)
1244
1346
 
1245
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.2[issues resolved] |
1246
- {uri-repo}/releases/tag/v1.5.0.alpha.2[git tag]
1347
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.2[issues resolved] |
1348
+ {url-repo}/releases/tag/v1.5.0.alpha.2[git tag]
1247
1349
 
1248
1350
  == 1.5.0.alpha.1 (2014-09-04) - @mojavelinux
1249
1351
 
1250
1352
  * Rewrite as proper Asciidoctor converter (#29)
1251
1353
  * Initial pre-release
1252
1354
 
1253
- {uri-repo}/issues?q=milestone%3Av1.5.0.alpha.1[issues resolved] |
1254
- {uri-repo}/releases/tag/v1.5.0.alpha.1[git tag]
1355
+ {url-repo}/issues?q=milestone%3Av1.5.0.alpha.1[issues resolved] |
1356
+ {url-repo}/releases/tag/v1.5.0.alpha.1[git tag]