asciidoctor-pdf 2.1.5 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0cacde45fb257acbe2644ae3da1673e0a9fe9cd42f4b97de92a3ae2d97400fdb
-  data.tar.gz: e4e01d9fa4e923e598277c5db822632a5dc3fe67e51ebbea26d744f8d30e7315
+  metadata.gz: fa858819d28baa5f07261f05d2ac3694e571683f3c99b9cbf80b11bd7d79c4b3
+  data.tar.gz: 243f4f2a35fcd2d3a2d6c9449499c3097804865abe137058dd55975970fbded9
 SHA512:
-  metadata.gz: 2fadd03cc382136bf1387867d83d68396f58c4182a51616254562c1d6460e28e0555781e9c5c51d372cd6d3fee29f80b7c06d9fc0d6e055a2839cf63491bf92d
-  data.tar.gz: 6fa97a16ff15ac5b0dee3789d33aa2760595139299ae41eb4e0104b4346c8569ffb8f1377fd0844f2c98ec831a08156258754e2a54f25c9fb10972a681f0c592
+  metadata.gz: 64571af8d39650e26245fd746675c8af1b3b98ee0b8b6d2de705acaf93849bbc5ed51ae36543ac06105e102b79ed698a24676ca76d63c91213399bd029b58e85
+  data.tar.gz: f446904f582d0d423c9ea918a23bff541ec65be94e0be7b94a07e1e190a6e66ee4aeb2c7ad403c61773708feb30adb2949e2822a56f7f0c3bd1b291191225c48

data/CHANGELOG.adoc

@@ -5,16 +5,83 @@
 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 {url-repo}/commits/main[commit history] on GitHub.
 
-== 2.1.5 (2022-07-10) - @mojavelinux
+== 2.3.0 (2022-08-16) - @mojavelinux
+
+Enhancements::
+
+* place footnotes directly below last block of content if `footnotes-margin-top` theme key is 0 (#2291)
+* allow page / column break to be forced using `always` option (e.g., `[%always]`) (#2300)
+* insert column break instead of page break in multi-column layout if `column` role is specified on page break macro (#2293)
+* use relative font size for big and small roles (#2307)
+* use default-for-print theme by default if media is `print` or `prepress` (#2306)
+* support text alignment roles on all styled paragraphs
+* support text alignment roles on verse block
 
 Bug Fixes::
 
-* fix position of background color on caption with outside margin (#2271)
-* don't allow font scale to compound when entering nested table (#2276)
+* only indent text that starts at left margin (i.e., when text align is left or justify) (#2298)
+* apply text transform and formatting when checking height of heading for orphan prevention
+* apply text transform and formatting when computing height of background for caption
+* honor theme settings (`prose-margin-inner` and `prose-text-indent-inner`) for inner paragraphs in abstract
+* prevent footnote label from being split across lines (#2297)
+* keep footnote label with preceding text if adjacent (#2297)
+* strip formatting added to source block by custom subs when syntax highlighter is enabled (#2086)
+
+Compliance::
+
+* remove support for deprecated `spread` role on table
 
 === Details
 
-{url-repo}/releases/tag/v2.1.5[git tag] | {url-repo}/compare/v2.1.4\...v2.1.5[full diff]
+{url-repo}/releases/tag/v2.3.0[git tag] | {url-repo}/compare/v2.2.0\...v2.3.0[full diff]
+
+== 2.2.0 (2022-07-22) - @mojavelinux
+
+Enhancements::
+
+* allow page background image to be specified per layout using `+{page-layout}+` attribute reference in path (#1739)
+* allow page margin for rotated page to be configured independently using `page-margin-rotated` theme key or `pdf-page-margin-rotated` document attribute (#1719)
+* allow orphan detection to be enabled for all section titles and discrete headings by setting `heading-min-height-after` to `auto` in theme (#2268)
+* set `docimagesdir` attribute when attribute substitutions are applied to value from theme (#2278)
+* start page numbering and running content on empty verso page before first chapter of prepress book if `start-at` value is 0 (#2252)
+* don't force page break after TOC with automatic placement in article if `title-page` attribute is set and value of `toc-break-after` theme key is `auto` (#1768)
+* add `--theme` option to CLI as shorthand for `-a pdf-theme` (#2250)
+* add `--sourcemap` option to CLI to enable `:sourcemap` option on processor (#2265)
+* broaden support for relative font sizes in theme to more than just inline elements; document support for relative font sizes
+* allow theme to control font properties of marker for ordered list using `olist-marker` category (#2279)
+* allow theme to control font style of marker (per marker or all markers) for unordered list
+
+Improvements::
+
+* add internal `Document#attr_unspecified?` method to simplify check for an attribute which has not been set or unset
+
+Bug Fixes::
+
+* always set `imagesdir` attribute to value of `themesdir` when resolving images from theme
+* allow `top` keys in `title-page` theme category to accept a fixed value (e.g., `1in`) (#2269)
+* prevent orphan detection for heading (section title or discrete heading) from modifying document state (#2288)
+
+Compliance::
+
+* configure table borders in way that is compatible with prawn-table > 0.2.2
+* don't coerce font size < 1 to relative font size; relative font size should be specified in units
+
+=== Details
+
+{url-repo}/releases/tag/v2.2.0[git tag] | {url-repo}/compare/v2.1.6\...v2.2.0[full diff]
+
+== 2.1.6 (2022-07-19) - @mojavelinux
+
+Bug Fixes::
+
+* resolve font size for monospaced cell when font size value on `codespan` key in theme is relative (#2281)
+
+== 2.1.5 (2022-07-10) - @mojavelinux
+
+Bug Fixes::
+
+* fix position of background color on caption with outside margin (#2271)
+* don't allow font scale to compound when entering nested table (#2276)
 
 == 2.1.4 (2022-06-26) - @mojavelinux
 
@@ -28,10 +95,6 @@ Bug Fixes::
 * apply text-tranform from custom role on phrase after attributes have been resolved (#2263)
 * make URL check more strict so image target containing a colon is not mistaken as a URL
 
-=== Details
-
-{url-repo}/releases/tag/v2.1.4[git tag] | {url-repo}/compare/v2.1.3\...v2.1.4[full diff]
-
 == 2.1.3 (2022-06-23) - @mojavelinux
 
 Bug Fixes::

data/README.adoc

@@ -1,6 +1,6 @@
 = Asciidoctor PDF: A native PDF converter for AsciiDoc
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>
-v2.1.5, 2022-07-10
+v2.3.0, 2022-08-16
 // Settings:
 :experimental:
 :idprefix:

data/bin/asciidoctor-pdf

@@ -8,17 +8,36 @@ else
 end
 require 'asciidoctor/cli'
 
-options = Asciidoctor::Cli::Options.new backend: 'pdf', header_footer: true
+# FIXME: provide an API in Asciidoctor for sub-projects to prepend version information
+options = (Asciidoctor::Cli::Options.new backend: 'pdf', header_footer: true).extend (Module.new do
+  def print_version os = $stdout
+    os.write %(Asciidoctor PDF #{Asciidoctor::PDF::VERSION} using )
+    super
+  end
+end)
 
-# FIXME: provide an API in Asciidoctor for sub-components to print version information
-unless ARGV != ['-v'] && (ARGV & ['-V', '--version']).empty?
-  $stdout.write %(Asciidoctor PDF #{Asciidoctor::PDF::VERSION} using )
-  options.print_version
-  exit 0
+args = ARGV.dup
+
+if (theme_idx = args.index {|it| it == '--theme' || (it.start_with? '--theme=') })
+  if (theme_arg = args[theme_idx]).length > 7
+    args[theme_idx..theme_idx] = ['-a', %(pdf#{theme_arg.slice 1, theme_arg.length})]
+  elsif (val = args[theme_idx + 1]) && !(val.start_with? '-')
+    args[theme_idx] = '-a'
+    args[theme_idx + 1] = %(pdf-theme=#{val})
+  end
+end
+
+if (Gem::Version.new Asciidoctor::VERSION) < (Gem::Version.new '2.1.0') && (args.include? '--sourcemap')
+  args.delete '--sourcemap'
+  Asciidoctor::Extensions.register do
+    preprocessor do
+      process {|doc| (doc.sourcemap = true) && nil }
+    end
+  end
 end
 
 # FIXME: This is a really bizarre API. Please make me simpler.
-case (result = options.parse! ARGV)
+case (result = options.parse! args)
 when Integer
   exit result
 else

data/bin/asciidoctor-pdf-optimize

@@ -1,8 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-optimizer = File.absolute_path '../lib/asciidoctor/pdf/optimizer.rb', __dir__
-if File.exist? optimizer
+if File.file? (optimizer = File.join (File.dirname __dir__), 'lib/asciidoctor/pdf/optimizer.rb')
   require optimizer
 else
   require 'asciidoctor/pdf/optimizer'

data/data/themes/base-theme.yml

@@ -17,8 +17,8 @@ base_border_color: '000000'
 role_lead_font_size: 13.5
 role_line-through_text_decoration: line-through
 role_underline_text_decoration: underline
-role_big_font_size: 14
-role_small_font_size: 10
+role_big_font_size: 1.2em
+role_small_font_size: 0.8em
 role_subtitle_font_size: 0.8em
 button_content: '[%s]'
 button_font_family: Courier

data/data/themes/default-theme.yml

@@ -23,28 +23,14 @@ page:
   size: A4
 base:
   text_align: justify
-  # color as hex string (leading # is optional)
   font_color: 333333
-  # color as RGB array
-  #font_color: [51, 51, 51]
-  # color as CMYK array (approximated)
-  #font_color: [0, 0, 0, 0.92]
-  #font_color: [0, 0, 0, 92%]
   font_family: Noto Serif
-  # choose one of these font_size/line_height_length combinations
-  #font_size: 14
-  #line_height_length: 20
-  #font_size: 11.25
-  #line_height_length: 18
-  #font_size: 11.2
-  #line_height_length: 16
   font_size: 10.5
-  #line_height_length: 15
-  # correct line height for Noto Serif metrics
+  # line_height_length is really just a vertical spacing variable; it's not actually the height of a line
   line_height_length: 12
-  #font_size: 11.25
-  #line_height_length: 18
-  line_height: $base_line_height_length / $base_font_size
+  # The Noto font family has a built-in line height of 1.36
+  # With this line_height, a line of text will occupy a height of 15.78pt
+  line_height: $base_line_height_length / 10.5
   font_size_large: round($base_font_size * 1.25)
   font_size_small: round($base_font_size * 0.85)
   font_size_min: $base_font_size * 0.75
@@ -60,16 +46,13 @@ role:
   underline:
     text_decoration: underline
   big:
-    font_size: $base_font_size_large
+    font_size: 1.2em
   small:
-    font_size: $base_font_size_small
+    font_size: 0.8em
   subtitle:
     font_color: 999999
     font_size: 0.8em
     font_style: normal_italic
-# FIXME vertical_rhythm is weird; we should think in terms of ems
-#vertical_rhythm: $base_line_height_length * 2 / 3
-# correct line height for Noto Serif metrics (comes with built-in line height)
 vertical_rhythm: $base_line_height_length
 horizontal_rhythm: $base_line_height_length
 link:
@@ -107,8 +90,7 @@ heading:
   h4_font_size: $base_font_size_large
   h5_font_size: $base_font_size
   h6_font_size: $base_font_size_small
-  #line_height: 1.4
-  # correct line height for Noto Serif metrics (comes with built-in line height)
+  # rely on built-in line height in Noto
   line_height: 1
   margin_top: $vertical_rhythm * 0.4
   margin_bottom: $vertical_rhythm * 0.9
@@ -156,11 +138,6 @@ admonition:
   column_rule_color: $base_border_color
   column_rule_width: $base_border_width
   padding: [$vertical_rhythm / 3.0, $horizontal_rhythm, $vertical_rhythm / 3.0, $horizontal_rhythm]
-  #icon:
-  #  tip:
-  #    name: far-lightbulb
-  #    stroke_color: 111111
-  #    size: 24
   label:
     text_transform: uppercase
     font_style: bold