clear What's New page [no ci]

1 files changed, 7 insertions, 369 deletions

diff --git a/docs/modules/ROOT/pages/whats-new.adoc b/docs/modules/ROOT/pages/whats-new.adoc
index 5a2d3875..3dcec651 100644
--- a/docs/modules/ROOT/pages/whats-new.adoc
+++ b/docs/modules/ROOT/pages/whats-new.adoc
@@ -4,384 +4,21 @@
 :doctype: book
 :leveloffset: 1
 :page-toclevels: 2
-:url-milestone-2-0-0: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.0+is%3Aclosed
-:url-milestone-2-0-1: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.1
-:url-milestone-2-0-2: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.2
-:url-milestone-2-0-3: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.3
-:url-milestone-2-0-4: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.4
-:url-milestone-2-0-5: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.5
-:url-milestone-2-0-6: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.6
-:url-milestone-2-0-7: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.7
-:url-milestone-2-0-8: {url-project-issues}?q=is%3Aissue+milestone%3Av2.0.x+is%3Aclosed+label%3Av2.0.8
+: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 2.0.8
+= Asciidoctor PDF {page-component-version}.0
 
-_**Release date:** 2022.06.08 | *Release notes:* {url-project-repo}/releases/tag/v2.0.8[v2.0.8^] | *Issue label:* {url-milestone-2-0-8}[2.0.8^]_
+_**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^]_
 
-== Improvements
-
-* Encapsulate logic to adjust column box inside float and dry run.
-* Automatically set height on column box if not specified; update value automatically when reflowing margins.
-
-== Bug Fixes
-
-* Correctly compute value of to cursor on extent when column box starts below top of page.
-* Fix crash in `ColumnBox#move_past_bottom` when `:reflow_margins` option is not set.
-* Fix x position of SVG when advanced to next column of column box.
-* `at_page_top?` should consider top of column box to be top of page.
-* Prevent SVG image taller than column from being advanced to next column.
-* Don't push section that follows index section in article to new page if last page of index doesn't extend to bottom of page.
-
-= Asciidoctor PDF 2.0.7
-
-_**Release date:** 2022.06.03 | *Release notes:* {url-project-repo}/releases/tag/v2.0.7[v2.0.7^] | *Issue label:* {url-milestone-2-0-7}[2.0.7^]_
-
-== Improvements
-
-* Don't recommend prawn-gmagick if PNG or JPG is corrupt or incomplete.
-* Add helper method to determine when to recommend the prawn-gmagick gem.
-
-== Bug Fixes
-
-* Fix crash when doctitle or section title with automatic ID contains inline image without an explicit width.
-* Use prawn-gmagick, if available, to read raster image referenced by SVG.
-* Allow image path in SVG to refer to any location within Asciidoctor jail (no restriction if safe mode is unsafe).
-
-= Asciidoctor PDF 2.0.6
-
-_**Release date:** 2022.05.30 | *Release notes:* {url-project-repo}/releases/tag/v2.0.6[v2.0.6^] | *Issue label:* {url-milestone-2-0-6}[2.0.6^]_
-
-== Bug Fixes
-
-* Indent content of collapsible block and apply bottom margin to match style of HTML output.
-* Patch prawn-gmagick to reread bit depth of a PNG image if it extracts the wrong value.
-* Interpret width of SVG correctly when width is defined in file using px units.
-* Don't crash if inline role defines border width but not border color.
-
-= Asciidoctor PDF 2.0.5
-
-_**Release date:** 2022.05.26 | *Release notes:* {url-project-repo}/releases/tag/v2.0.5[v2.0.5^] | *Issue label:* {url-milestone-2-0-5}[2.0.5^]_
-
-== Bug Fixes
-
-* Don't filter TOC entries without an ID when computing the TOC extent.
-* Fix width of multi-word phrase with background and border offset.
-
-= Asciidoctor PDF 2.0.4
-
-_**Release date:** 2022.05.25 | *Release notes:* {url-project-repo}/releases/tag/v2.0.4[v2.0.4^] | *Issue label:* {url-milestone-2-0-4}[2.0.4^]_
-
-== Bug Fixes
-
-* Fix calculation of TOC extent when TOC entry has children but no ID.
-
-= Asciidoctor PDF 2.0.3
-
-_**Release date:** 2022.05.25 | *Release notes:* {url-project-repo}/releases/tag/v2.0.3[v2.0.3^] | *Issue label:* {url-milestone-2-0-3}[2.0.3^]_
-
-== Improvements
-
-* Compute the optimize settings in `init_pdf` and store as a Hash instead of after writing the PDF file.
-
-== Bug Fixes
-
-* Adjust TrimBox to fit inside of BleedBox when using optimizer and compliance is PDF/X.
-* Set height of resized image to available height to avoid float precision error when scaling down image to fit page.
-* Prevent content on title page from overrunning the bounds of a single page and warn; restriction applies to `ink_title_page`.
-
-= Asciidoctor PDF 2.0.2
-
-_**Release date:** 2022.05.22 | *Release notes:* {url-project-repo}/releases/tag/v2.0.2[v2.0.2^] | *Issue label:* {url-milestone-2-0-2}[2.0.2^]_
-
-== Bug Fixes
-
-* Use specified column widths to avoid bugs in column width calculation when using colspans.
-* Advance table to next page if rowspan in first row doesn't fit in space remaining on current page.
-
-= Asciidoctor PDF 2.0.1
-
-_**Release date:** 2022.05.21 | *Release notes:* {url-project-repo}/releases/tag/v2.0.1[v2.0.1^] | *Issue label:* {url-milestone-2-0-1}[2.0.1^]_
-
-== Bug Fixes
-
-* Scale inline image to fit within available height of page, accounting for the top padding of the line height and the bottom gutter.
-* Short-circuit formatted text routine and log error if fragments in first line can't fit on an empty page.
-* Break and wrap long contiguous text in source block when linenums is enabled.
-
-= Asciidoctor PDF 2.0.0
-
-_**Release date:** 2022.05.18 | *Release notes:* {url-project-repo}/releases/tag/v2.0.0[v2.0.0^] | *Issue label:* {url-milestone-2-0-0}[{page-component-version}.0^]_
-
-Asciidoctor PDF {page-component-version} introduces a host of new features and enhancements--like unbreakable blocks, theme keys for callout lists, automatic orphan prevention for block captions, and improved block margin logic--just to name a few!
+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.0.0[release notes^].
+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^].
 
-[#roles]
-== Paragraph roles and indent
-
-In Asciidoctor PDF {page-component-version}, you can define custom roles in your theme and apply them to specific paragraphs in your document.
-See xref:theme:custom-role.adoc[] to learn how to create a custom role and xref:roles.adoc#custom[Use a custom role] for how to assign a custom role to a paragraph.
-
-In light of roles now being supported on paragraphs, the `lead` category in the theme has been dropped and replaced by a built-in role named `lead`.
-See xref:theme:role.adoc#built-in[Built-in roles] for details.
-
-To control the indent of inner paragraphs (instead of all paragraphs), you can set the new `prose-text-indent-inner` key in your theme.
-See xref:theme:prose.adoc[] for details.
-
-[#breakable]
-== Breakable by default
-
-In Asciidoctor PDF {page-component-version}, the following blocks are breakable by default, which includes automatic anchor and caption orphan prevention:
-
-* Admonitions
-* Block images
-* Code blocks (literal, listing, and source)
-* Examples
-* Open blocks
-* Quote blocks
-* Sidebars
-* Verses
-
-Tables and sections are breakable by default, but do not provide automatic anchor and caption orphan prevention.
-For tables, that means the anchor and caption can be left on the current page if the table is advanced to the next page.
-For sections, that means the section's title may be left on the current page if the first content block doesn't fit.
-However, you can turn on orphan prevention for tables and sections by adding the (seemingly redundant) xref:breakable-and-unbreakable.adoc#breakable[breakable option] as a hint.
-
-[#unbreakable]
-== Unbreakable option
-
-The `unbreakable` option can be applied to all delimited blocks (including admonitions and tables), but not sections.
-When the xref:breakable-and-unbreakable.adoc#unbreakable[unbreakable option] is applied to a block, the converter will advance the block and its caption and anchor to the next page if it detects that the block would break across pages and it can fit on a single page.
-
-[#notitle]
-== Notitle option
-
-The `untitled` option has been renamed to `notitle`.
-With the name change, it's also gained new capabilities.
-The `notitle` option hides a section title in the body of a document, but displays the title in the TOC and allows the anchor resulting from that title to still be referencable.
-It can also be used to add an entry to the TOC for a preamble, anonymous preface, and imported PDF pages.
-See xref:notitle.adoc[] for examples and more details.
-
-[#blocks]
-== Blocks and block captions
-
-Blocks and block captions gained a lot of new theming capabilities in Asciidoctor PDF {page-component-version}.
-Here are a few of the highlights:
-
-Padding::
-The theme can now control the padding on a block using a 2-value array for ends and sides or 3-value array with implied left side value.
-Border width::
-The border width of delimited blocks, admonitions, and block images can be customized per edge with the xref:theme:blocks.adoc#border-width[border-width key].
-Border style::
-The border style of delimited blocks, admonitions, and block images can be changed with the xref:theme:blocks.adoc#border-style[border-style key].
-Border styles include dashed, dotted, double, and solid.
-Line height::
-Wherever font properties are accepted in the theme, you can now control the line height of blocks using the `line-height` key.
-Anchor positioning::
-The anchor location for blocks can be positioned relative to the content using the `block-anchor-top` theme key.
-Caption text alignment::
-The text alignment of captions can now be controlled independent of the block alignment using the global xref:theme:caption.adoc[caption-text-align theme key] or per block category with `<category>-caption-text-align`.
-The xref:theme:block-images.adoc#caption-text-align[image-caption-text-align] and xref:theme:tables.adoc#caption-text-align[table-caption-text-align] theme keys accept the value `inherit` in addition to the standard text alignment values.
-The value `inherit` resolves to the alignment of the block image or table.
-Global caption text decoration::
-The text decoration style, color, and width can be applied to captions globally with the `caption-text-decoration-style`, `caption-text-decoration-color`, and `caption-text-decoration-width` theme keys.
-See xref:theme:caption.adoc[] for more information.
-Caption background color::
-You can now specify a background color for captions globally using the `caption-background-color` theme key or per block category (`<category>-caption-background-color`).
-See xref:theme:caption.adoc[] for more information.
-Caption max-width::
-A caption's `max-width` value can be set to a percentage of the content by passing the percentage as an argument to `fit-content` function.
-First line of abstract::
-The theme can control the font color of first line of abstract using `abstract-first-line-font-color` key.
-
-In addition to the new theme keys, <<breakable,breakable behavior>>, and <<unbreakable,unbreakable>> option for blocks, Asciidoctor PDF now uses smarter bottom margin logic that prevents extra space from being added below blocks, particularly when blocks are nested or used inside an AsciiDoc table cell.
-
-.*_Notable fixes for blocks_*
-* Syntax highlighting isn't applied to a source block if the `specialchars` substitution is disabled.
-* Borders, shading, and padding aren't applied to collapsible blocks.
-* The `callouts` substitution can be removed on code blocks.
-
-== Tables
-
-Border widths and styles::
-The table border width can be customized per edge with the xref:theme:blocks.adoc#border-width[border-width key].
-The border style can be xref:theme:tables.adoc#border-style[specified per edge by assigning an array of styles] to the `border-style` key.
-Border styles include dashed, dotted, and solid.
-
-Grid widths and styles::
-The width of table grid lines can be specified for rows and columns with the xref:theme:tables.adoc#grid-width[grid-width key].
-The style of the grid lines can be specified for rows and columns with the xref:theme:tables.adoc#grid-style[grid-style key].
-Grid styles include dashed, dotted, and solid.
-Thank you to *@hextremist* for adding the ability to style the horizontal and vertical lines of the table grid independently.
-
-Maximum caption width::
-The maximum caption width for tables can be set to a percentage of the content by passing an argument to the `fit-content` function.
-
-Caption end::
-The `table-caption-side` theme key has been xref:theme:tables.adoc#end[renamed to table-caption-end].
-
-.*_Notable fixes for tables_*
-* Vertical center alignment is correctly applied to regular table cells.
-* The border bottom is correctly applied to a table row when frame and grid are none.
-* The font size of a literal table cells and nested blocks in AsciiDoc table cells is now scaled.
-* AsciiDoc table cells inherit the font properties from the table.
-* The content of an AsciiDoc table cell is prevented from overrunning the footer or subsequent pages.
-* The top and bottom padding is taken into account when computing the height of an AsciiDoc table cell.
-* An error message is logged if a table cell is truncated.
-* Instead of raising an error, the converter logs an error and skips the table if the content cannot fit within the designated width of a cell.
-
-== Callout lists and numbers
-
-The theming language now has a xref:theme:callout.adoc[callout-list category].
-The new theme keys let you customize the font properties, text alignment, and item spacing of callout lists.
-The `callout-list` category includes the `margin-top-after-code` key that can control the top margin of callout lists that immediately follow a code block.
-
-.*_Notable fixes for callouts_*
-* Callout numbers in a callout list stay with primary text when an item is advanced to the next page.
-* A sequence of two or more callouts separated by spaces in a code block are processed correctly.
-* The font family assigned to `conums` in the theme is applied to the callout numbers displayed in code blocks.
-
-== Images
-
-Caption end:: You can now configure whether the caption for a block image is placed above or below the image using the `caption-end` theme key.
-See xref:theme:block-image.adoc#caption[Block Image Category Keys] for the list of available `image-caption` theme keys and their value types.
-Text alignment roles:: The text alignment roles, such as `text-center`, are now supported on block images.
-Roles for inline images:: Roles and inherited roles are now supported on inline images.
-
-.*_Notable fixes for images_*
-* Warnings from background SVGs are now passed through to the logger.
-* SVGs are correctly scaled down when `fit=scale-down`.
-
-== Icons
-
-Image-based icons:: Asciidoctor PDF {page-component-version} now supports image-based icons.
-They're resolved from `iconsdir` and should have the `icontype` file extension.
-Add a link to an icon:: The `link` attribute can now be set on the icon macro.
-Admonition icon image:: An admonition icon image can now be remote, if `allow-uri-read` is set, or a data URI.
-The textual label on an admonition is displayed if the icon image fails to embed.
-
-== Links
-
-Background color and border offset:: You can now control the background color and border offset (only for background) of links from the theme.
-Link macro:: The `id` attribute can now be set on the link macro.
-
-== Inline formatting
-
-Typographical quotation marks:: You can now define single and double quotation marks, such as › and », using the `quotes` key in the theme.
-See xref:theme:quotes.adoc[] for details.
-Thank you to *@klonfish* for adding this feature to the theming language.
-Hexadecimal characters:: Character references that contain both uppercase and lowercase hexadecimal characters are now supported.
-Thank you to *@etihwnad* for adding this capability.
-
-.*_Notable inline formatting fixes_*
-* A closing quote preceded by a trailing ellipsis is kept together with the text enclosed in typographic quotes.
-* The font size for superscript and subscript is computed correctly when the parent element uses `em` and `%` units.
-* Hyphenation exceptions are respected when a word is adjacent to a non-word character.
-* The `pre-wrap` role on honored on a phrase.
-
-== Fonts, font styles, and text transforms
-
-Small caps:: The `text-transform` theme key now accepts the `smallcaps` value.
-When `smallcaps` is specified, the lowercase letters are replaced with the small capital letter variants.
-normal_italic:: The xref:theme:text.adoc#font-style[new normal_italic value] for the `font-style` key resets the font style to normal, then applies the italic variant of a font family.
-Noto Sans:: xref:theme:font-support.adoc#bundled[Noto Sans is now bundled] with Asciidoctor PDF.
-It is used as a fallback font in the `sans-with-fallback-font` theme and can be declared in a custom theme.
-Ceiling and floor characters:: The left and right ceiling and floor characters (⌈, ⌉, ⌊, and ⌋)were added to the M+ fallback font.
-Thank you to *@oddhack* for adding these characters to the font subset.
-Checkmark, numero, and y with diaeresis glyphs:: The heavy checkmark glyph (✔) was added to the fallback font; the checkmark and heavy checkmark (✓ and ✔) were added to the monospaced font; the № and ÿ glyphs were added to the default and fallback fonts.
-
-== Covers and title page
-
-Front and back cover images::
-The front and back cover images can now be xref:theme:covers.adoc[defined in the theme] and the target can be a data URI.
-Deactivate title page::
-The xref:theme:title-pages.adoc#deactivate[title page can now be deactivated from the theme] by assigning `false` to the `title-page` category key.
-
-== TOC and PDF outline
-
-PDF outline title and levels:: You can now deactivate the PDF outline by unsetting the `outline` document attribute (`:!outline:`) as well as customize its title with `outline-title` and the section level depth and expansion with `outlinelevels`.
-See xref:pdf-outline.adoc[] for details.
-Deactivate running content on TOC pages:: The header or footer can be deactivated on TOC pages by assigning the `noheader` or `nofooter` options on the toc macro.
-TOC dot leader:: The theme can control the font size of the dot leader in the TOC.
-TOC location:: The TOC can now be placed following the preamble by assigning the `preamble` value to the `:toc:` document attribute.
-Also, the TOC is only displayed at the first location of a toc macro.
-Extended converter:: An extended converter can now override the `get_entries_for_toc` method to insert or filter TOC entries.
-
-.*_Notable fixes for the TOC_*
-* An image now renders at the end of a section title in the corresponding TOC entry.
-
-[#footnotes-2-0]
-== Footnotes
-
-Reset numbering:: Footnote numbering is now reset in each chapter.
-Footnote reference label:: The xreftext of a chapter is now added to the label of a footnote reference that refers to a previous chapter.
-Unresolved footnote color:: The theme can configure the font color of an unresolved footnote using the `unresolved` role.
-
-.*_Notable fixes for footnotes_*
-* A missing footnote reference is shown in superscript.
-* Footnotes defined in an AsciiDoc table cell are now rendered with the footnotes at the end of an article or chapter.
-
-[#index-2-0]
-== Index
-
-Index columns:: The theme can now configure the number of index columns using the `index-columns` key.
-Style of page numbers:: The new `index-pagenum-sequence-style` document attribute controls the style of sequential page numbers in the index when `media=screen`.
-
-.*_Notable fixes for the index_*
-* The index section isn't rendered if there are no index entries.
-* A blank line is no longer inserted in the index when a term is forced to break.
-* Prepress page margins  are honored on subsequent pages in the index.
-* Space in front of a hidden index term is now collapsed.
-
-== Running content and page numbering
-
-Base theme:: The basic running footer is now enabled when you use the base theme or extend the base theme.
-(Previously, the basic running footer was only enabled if you used or extended the default theme.)
-
-Select the page where running content starts:: Specify the page on which the running content starts being displayed by xref:theme:add-running-content.adoc#start-at[assigning an integer to the start-at theme key] on the `running-content` category.
-Running content can also start after the TOC, wherever the TOC is placed, by assigning the keyword `after-toc` to the `start-at` key.
-
-Configure where integer page numbering starts:: Specify the page on which the integer (1-based) page numbering begins using the xref:theme:page-numbers.adoc#start-at[start-at key on the page-numbering category].
-Integer page numbering can start at the front cover by assigning the keyword `cover` to the `start-at` key.
-Or, you can have the page numbering start after the TOC, wherever the TOC is placed, by assigning `after-toc` to the `start-at` key.
-Alternatively, the theme can specify an offset from the first body page where the page numbering should begin when an integer is assigned to `start-at`.
-
-Margin and content margin:: The margin and content margin of the running content per periphery (header or footer) and per side (recto or verso) can now be configured from the theme.
-The margins in running content can be specified using a 2-value array for ends and sides or 3-value array with implied left side value.
-
-Part and chapter numbers:: If the `partnums` attribute is set, the `part-numeral` attribute is automatically set in the running content.
-If the `sectnums` attribute is set, the `chapter-numeral` attribute is automatically set in the running content.
-
-Select a background per layout:: The `page-layout` attribute is now set in the running content.
-You can use this attribute to select a background per layout.
-
-.*_Notable fixes for running content and page numbering_*
-* The `pdf-folio-placement` setting is honored even when `media=prepress`.
-* Prepress page margins honor the value of `pdf-folio-placement`.
-
-== Themes
-
-Print-optimised themes:: Asciidoctor PDF {page-component-version} has two new print-optimized themes, named `default-for-print` and `default-for-print-with-fallback-font`.
-Extend base theme:: A custom theme does not inherit from the base theme by default; it must be specified explicitly using `extends: base`.
-Extends hierarchy:: Asciidoctor PDF only extends a theme in the `extends` hierarchy once unless the theme is modified with `!important`.
-Power operator:: The theming language now supports the power operator.
-It has the same precedence as multiply and divide.
-Rouge theme:: A Rouge theme can now be specified as a theme class or instance (API only).
-Base theme changes:: The top and bottom padding on quote and verse blocks has been reduced in the base theme.
-The `base-border-color` is now set and used as the default border color.
-The border colors have been removed in the base theme so all border colors can be controlled using the `base-border-color` key when extending the theme.
-Default theme changes:: The top and bottom padding on quote blocks is now uniform in the default theme.
-
-== Dependencies and scripts
-
-The following dependencies and scripts were added to Asciidoctor PDF {page-component-version}.
-
-* The `asciidoctor/pdf/nogmagick` script was added to unregister the Gmagick handler for PNG images.
-
+////
 == Deprecated
 
 The following features are deprecated with the release of Asciidoctor PDF {page-component-version} and will be removed in the next major release.
@@ -412,3 +49,4 @@ The following dependencies and deprecated features have been removed with the re
 * 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.
+////