blob: 3dcec6519d3d679a86f831542396f45c825abe5b (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
= What's New in Asciidoctor PDF {page-component-version}
:description: The new features and fixes available in Asciidoctor PDF {page-component-version}.
:navtitle: What's New
:doctype: book
:leveloffset: 1
:page-toclevels: 2
:url-milestone-2-1-0: {url-project-issues}?q=is%3Aissue+milestone%3Av2.1.0+is%3Aclosed
This page presents the changes made in each of the patch releases in the Asciidoctor PDF {page-component-version} release line.
The releases are ordered from newest to oldest.
= Asciidoctor PDF {page-component-version}.0
_**Release date:** 2022.month.day | *Release notes:* {url-project-repo}/releases/tag/v2.1.0[v{page-component-version}.0^] | *Issue label:* {url-milestone-2-1-0}[{page-component-version}.0^]_
Asciidoctor PDF {page-component-version} introduces new features and enhancements--like #new feature examples# --just to name a few!
Some of these features, improvements, and bug fixes are highlighted in the following sections.
For a summary of the release, see the {url-project-repo}/releases/tag/v2.1.0[release notes^].
For a complete list of all changes, see the {url-project-repo}/blob/main/CHANGELOG.adoc[CHANGELOG^].
////
== Deprecated
The following features are deprecated with the release of Asciidoctor PDF {page-component-version} and will be removed in the next major release.
* The `blockquote` category prefix is deprecated in the theme; use the `quote` prefix instead.
See xref:theme:quote.adoc[].
* The `key` category prefix is deprecated in the theme; use the `kbd` prefix instead.
See xref:theme:keyboard.adoc[].
* The `literal` category prefix is deprecated in the theme; use the `codespan` prefix instead.
See xref:theme:codespan.adoc[].
* The `outline-list` category prefix is deprecated in the theme; use the `list` prefix instead.
See xref:theme:list.adoc[].
* The `Optimizer#generate_file` method is deprecated; use `Optimizer#optimize_file` instead.
== Removed
The following dependencies and deprecated features have been removed with the release of Asciidoctor PDF {page-component-version}.
* Support for Ruby < 2.7 and JRuby < 9.2 has been removed.
* The `untitled` option has been removed; use the `notitle` option instead.
* Support for the deprecated `pdf-style` and `pdf-stylesdir` attributes has been removed.
* The deprecated Pdf module alias in the API has been removed in favor of PDF.
* The deprecated "`ascii`" fonts have been removed; only the more complete "subset" fonts are now bundled with the gem.
* The previously undocumented `vertical-spacing` key has been removed from the built-in themes.
* The `top-margin` key on block and prose categories in theme has been removed; space between delimited blocks and lists is now controlled using bottom margins only.
* The `lead` category keys in theme have been replaced with the built-in role named `lead`.
* `safe_yaml gem` has been removed; `YAML.safe_load` from the Ruby stdlib is used instead.
* Support for the `<color>` tag in passthrough content has been removed; use `<font color="...">` instead (may affect themes).
* The [.path]_asciidoctor-pdf/converter_ and [.path]_asciidoctor-pdf/version_ shim scripts have been removed; use [.path]_asciidoctor/pdf/converter_ and [.path]_asciidoctor/pdf/version_ instead.
* The unneeded `_mb` functions (e.g., `uppercase_mb`) have been removed; multibyte support for `upcase`, `downcase`, and `capitalize` is now provided by corelib.
////
|
