:page_with_curl: Asciidoctor PDF: A native PDF converter for AsciiDoc based on Asciidoctor and Prawn, written entirely in Ruby.
This is a patch release in the 2.3.x release line that fixes numerous bugs and regressions that were lingering since the 2.0.0 release.
All footnotes inside AsciiDoc table cells are collected and included in the footnotes list at the bottom of the chapter or article. If a section follows an empty index, that section is no longer dropped. The bottom margin on a table with the breakable
or unbreakable
option, as well as theme setting for the caption on a table with the same properties, are preserved. The start-at
theme value after-toc
for page numbering and running content correctly references the first recto page following the TOC when media=prepress
. A new theme key callout-list-marker-font-color
has been introduced to independently control the color of the conum marker in a callout list (primarily intended to resolve a contrast problem in dark themes).
callout-list-marker-font-color
theme key to control color of conum marker in callout list (#2402)breakable
or unbreakable
option (#2379)breakable
or unbreakable
option (#2379)after-toc
(#2398)Released on: 2023-03-31 Released by: @mojavelinux Release beer: Knight of the Trender by Grandma's House
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.3.x release line that fixes an incompatiblity with Asciidoctor 2.0.10 (for users of Ubuntu 20.04) and resolves attribute references in the target of an inline image in running content when the value is an image macro.
Released on: 2022-10-28 Released by: @mojavelinux Release beer: Pumking by Southern Tier Brewing Company
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.3.x release line that addresses a regression in Ghostscript that affected the built-in optimizer. The optimizer will now pass -dNEWPDF=false
to force Ghostscript to use the old PDF interpretter. This release also addresses a crash when the TOC is enabled and a section ends with a hard line break.
-dNEWPDF=false
to Ghostscript when optimizing PDF so it does not break internal links (#2355)Released on: 2022-10-20 Released by: @mojavelinux Release beer: Warlock by Southern Tier Brewing Co.
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.3.x release line that addresses an incomplete fix for an issue in 2.3.1. The fallback value for the base-font-size
is now set before processing the keys, and a fallback value for the base-font-family
key has been set.
base-font-size
theme key before processing keys (#2342)Released on: 2022-09-17 Released by: @mojavelinux Release beer: Personal Record by Athletic Brewing Co.
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.3.x release line that includes backports of bug fixes from the upcoming 3.0.x release line.
This release restores the fallback value for the base-font-size
theme key for cases when a custom theme does not extend another theme. The converter no longer crashes when the smallcaps text transform is applied to a phrase using a role. The part and chapter signifiers are not added if their respective attributes are unset. The heading border is drawn if the heading is advanced to the next page. Text is justified correctly if the first line of the abstract ends with a hard break.
The 3.0.0 release is just around the corner.
base-font-size
when loading theme (#2343)chapter-signifier
is unset (#2328)part-signifier
is unset (#2328)heading-min-height-after
theme key is empty (#2326)heading-min-height-after
theme key is ignored if section is empty or discrete heading is last childReleased on: 2022-09-17 Released by: @mojavelinux Release beer: Personal Record by Athletic Brewing Co.
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
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.
footnotes-margin-top
theme key is 0 (#2291)always
option (e.g., [%always]
) (#2300)column
role is specified on page break macro (#2293)print
or prepress
(#2306)prose-margin-inner
and prose-text-indent-inner
) for inner paragraphs in abstractspread
role on tableReleased on: 2022-08-16 Released by: @mojavelinux Release beer: Late To The Kettle IPA by Athletic Brewing Co.
Logs: resolved issues | source diff | gem diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
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.
+{page-layout}+
attribute reference in path (#1739)page-margin-rotated
theme key or pdf-page-margin-rotated
document attribute (#1719)heading-min-height-after
to auto
in theme (#2268)docimagesdir
attribute when attribute substitutions are applied to value from theme (#2278)start-at
value is 0 (#2252)title-page
attribute is set and value of toc-break-after
theme key is auto
(#1768)--theme
option to CLI as shorthand for -a pdf-theme
(#2250)--sourcemap
option to CLI to enable :sourcemap
option on processor (#2265)olist-marker
category (#2279)Document#attr_unspecified?
method to simplify check for an attribute which has not been set or unsetimagesdir
attribute to value of themesdir
when resolving images from themetop
keys in title-page
theme category to accept a fixed value (e.g., 1in
) (#2269)Released on: 2022-07-22 Released by: @mojavelinux Release beer: Superfood Swell by Athletic Brewing Company
Logs: resolved issues | full diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.1.x release line that includes a backport of a bug fix from the 2.2.x release line.
If the font size of a codespan (the codespan
key in the theme) is set to a relative value such as 0.9em, the converter will not crash whenn processing a monospace table cell. Asciidoctor 2.2.x will add even broader support for using relative font sizes in the theme.
codespan
key in theme is relative (#2281)Released on: 2022-07-19 Released by: @mojavelinux Release beer: Trichotomous by 4 Noses Brewing Company
Logs: resolved issues | full diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.1.x release line that includes backports of bug fixes from the 2.2.x release line.
If a block caption has both a background color and an outside margin, the background color will be placed at the location of the text rather than stacked above it. If the font size is set on tables in the theme, the font scaling will not compound in a nested table. Rather, the font size in the nested table will match the font size in the parent table.
Released on: 2022-07-10 Released by: @mojavelinux Release beer: DDH Juicy Bits by WeldWerks Brewing
Logs: resolved issues | full diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.
This is a patch release in the 2.1.x release line that includes backports from the 2.2.x release line. It fixes several issues that have been hiding in the shadows for a long time and enhances the warning message for truncated table cells.
If the alt text for a block image, video, or audio exceeds the width of the content area, the text will wrap to the next line instead of being advanced to the next page. This fix prevents a fixed width table cell from breaching the height of the page. In the event that a table cell does exceed the height of a page, and the sourcemap is enabled, the warning message will include the source location of the cell. The converter will no longer suggest enabling the allow-uri-read
attribute if an image target contains a colon, but is not a URL. If a custom role contains the text-transform
property, that transform will be applied the value of an attribute reference. Previously, the transform would be applied before attribute references are resolved.
Released on: 2022-06-25 Released by: @mojavelinux Release beer: We Are the Weirdos by Beer Zombies Brewing
Logs: resolved issues | full diff
A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign, who provide critical funding for the ongoing development of this project.