This is a minor release in the Asciidoctor PDF 2 release line. This release builds on numerous enhancements that were introduced in Asciidoctor PDF 2.
It's now possible to specify a background image per layout by using the {page-layout} attribute reference in the path. You can configure the page margins for rotated pages separately using the page-margin-rotated theme key or pdf-page-margin-rotated document attribute. Inside the theme, you can reference the resolved value of the imagesdir attribute from the document using the {docimagesdir} attribute reference. Instead of having to add the breakable option to all headings to get orphan detection, you can enable it globally in the theme by setting the heading-min-height-after key to the value auto. The theme now accepts a relative font size (e.g., 0.75em) almost anywhere a font size can be set. The font properties of the mark for ordered lists can now be controlled using the olist-marker category. The asciidoctor-pdf CLI now accepts two new options. You can pass --sourcemap to enable the :sourcemap option on the processor for tracking warnings down to the line number. You can use the --theme option as an alternative to -a pdf-theme= to save some typing.
During the development of this release, numerous bugs were founds and fixed. And the documentation conntinues to be improved.
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
Release meta
Released on: 2022-07-22
Released by: @mojavelinux
Release beer: Superfood Swell by Athletic Brewing Company
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
Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.
Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
Updates the requirements on asciidoctor-pdf to permit the latest version.
Release notes
Sourced from asciidoctor-pdf's releases.
... (truncated)
Changelog
Sourced from asciidoctor-pdf's changelog.
... (truncated)
Commits
dc0407f
release 2.2.0 [no ci]645e91c
upgrade RuboCop and configure new rules [no ci]bf70107
sync What's New with new enhancements docs (PR #2290)fbc8570
resolves #2288 prevent orphan detection for heading from modifying document s...556299c
further document the page-count attribute and fix example on page numbers page8a87f0c
add a description to the page-count attribute and use it in an example92b854b
allow theme to control font style of marker (per marker or all markers) for u...9e300c5
resolves #2279 allow theme to control font properties of marker for ordered l...79bf9f4
resolves #2269 allow top keys in title-page theme category to accept a fixed ...4aa0645
add CHANGELOG section for 2.1.6 releaseDependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting
@dependabot rebase
.Dependabot commands and options
You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)