This is a minor release in the Asciidoctor PDF 2 release line. This release includes several enhancements and bug fixes.
Enhancements. If you set the media to print or prepress, and you don't specify a theme, Asciidoctor PDF will now use the built-in default-for-print theme by default. This change makes it easier for users to get print-optimized output by default and raises awareness about the existence and function of this theme. If you want to force a page break, you can now add [%always] above the page break macro. If you producing a multi-column layout (e.g., page-columns is > 1), the page break macro will create a new page by default. If you want to start a new column, add the column role to the page break macro. If you want to place footnotes (aka endnotes) directly below the last block of content, set the footnotes-margin-top key to 0 (or another fixed value) in your theme. If you use the big and small roles, the text will be scaled relative to the font size of the surrounding text, even when used in headings. The converter now recognizes the text alignment roles (e.g., .text-center) on all styled paragraphs and verse blocks.
Bug fixes. Some users prefer to add additional markup to code blocks to emphasize tokens. When the source highlighter is enabled, Asciidoctor PDF does not support this extra markup. However, rather than printing it verbatim, the converter will now strip it away to maintain the integrity of the code in the code block. If a footnote label falls at the end of a line, it will no longer be split or widowed. Instead, it will stay together and with the preceding adjacent text, pulling that the last word to the next line if necessary. If the prose-margin-inner and/or prose-text-indent-inner theme keys are set, these are now honored on inner paragraphs in the abstract. If the prose-text-indent key is set in the theme, it will only be applied to elements that have a left-oriented alignment (left or justify). The computed height of headings and captions for orphan prevention now takes into account all text formatting, making the behavior more accurate.
During this release cycle, numerous improvements were made to the documentation as well.
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
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.
Changelog
Sourced from asciidoctor-pdf's changelog.
... (truncated)
Commits
67b9e2d
release 2.3.0 [no ci]5b4f79c
fix typos [no ci]332c4c9
update what's new page for 2.3.0 release93d72bf
verify that PNG image is decoded again in scratch documentdc28742
use lookup tables to verify text alignment names5581550
document relationship of text alignment roles to text-align keys in theme8605cef
revise CHANGELOG entries for upcoming releaseedcaa2d
resolves #2086 strip formatting markup added to source block by custom subs w...7c6635d
rename prev_subs to saved_subs to make intent more clearcbf1554
resolves #2297 keep footnote label with preceding text (PR #2310)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)