search

progit / progit2

Pro Git 2nd Edition
Other
5.77k stars 1.9k forks source link

Update asciidoctor-pdf requirement from 1.6.1 to 2.0.0 #1742

Closed dependabot[bot] closed 2 years ago

dependabot[bot] commented 2 years ago

Updates the requirements on asciidoctor-pdf to permit the latest version.

Release notes

Sourced from asciidoctor-pdf's releases.

v2.0.0

We began the journey towards the 2.0.0 release over two years ago with a goal of making this converter more accurate, easier to extend, and more thoroughly documented. It all started with #789. The result has turned out to be better than anything we could have hoped for. We never thought it would include basic support for image floats, and yet here we are. And despite all the changes, this release is backwards compatible with all existing themes and extended converters written for 1.6.x.

PDF, and printable documents in general, present what often feels like a bottomless pit of requirements. By providing a more robust framework, the hope is that users will be able to build on it to serve their own needs rather than having to wait and lobby for changes to the converter itself. The extended converter use cases page in the new docs highlights just how far this converter can be stretched to accommodate those needs. (If you look close, you can even find a recipe for applying a multi-column layout).

Getting the converter to work this way led to solutions for hundreds of open issues, 222 to be exact. With > 2,000 tests riding in on > 1,500 new commits means this converter is far more stable than it has ever been in the past. The converter is well-tested, better organized, and sufficiently documented. And while it still has limitations, that list has been cut down substantially.

This release marks a switch to semantic versioning and leaner releases in the future. Although this software is now very stable, the release also marks a shift in strategy to begin exploring other approaches to producing PDF documents, most likely by leveraging web technologies. We have pushed this PDF generation library well beyond its limits and intended use. To take this conversion further, new solutions are needed. We're leaving this repository in a state where it can continue to be maintained within the boundaries of what it currently provides. We wouldn't go so far as to call it maintenance mode, but maintenance will certainly become the focus.

Distribution

Changelog

For a more complete list of enhancements, improvements, and bug fixes that are included in this major milestone, see the What's New page in the documentation.

Improvements::

  • use more stable approach to recreating current bounds in scratch document
  • add foundation to support multi-column layout for the body of an article (using an extended converter only)

Release meta

Released on: 2022-05-18 Released by: @​mojavelinux Release beer: :christmas_tree: St. Bernardus Christmas Ale by St. Bernardus

Logs: resolved issues | full diff

Credits

A huge shout out to Sarah White (@​graphitefriction) for collecting the raw materials of docs scattered throughout the repository and elsewhere and organizing them into a documentation component in the Asciidoctor documentation site. Not only do those docs make Asciidoctor PDF more approachable for new users, they also make the task of supporting all users a lot easier.

A very special thanks to all the awesome supporters of the Asciidoctor OpenCollective campaign who provided critical funding for the development of this release as well as ongoing development of the project.

Changelog

Sourced from asciidoctor-pdf's changelog.

== 2.0.0 (2022-05-18) - @​mojavelinux

Improvements::

  • use more stable approach to recreating current bounds in scratch document
  • add foundation to support multi-column layout for the body of an article (using an extended converter only)

=== Details

{url-repo}/releases/tag/v2.0.0[git tag] | {url-repo}/compare/v2.0.0.rc.1...v2.0.0[full diff]

== 2.0.0.rc.1 (2022-05-17) - @​mojavelinux

Enhancements::

  • allow theme to position caption for code and example blocks below block using caption-end key (#1730)
  • allow hyphenation to be turned on and configured using the base-hyphens key in the theme (#2161)
  • replace docdir attribute reference in value of pdf-themesdir and pdf-fontsdir attributes (if not already replaced) (#412)
  • split out start_title_page method from ink_title_page to make customization of the title page simpler using an extended converter
  • introduce start_toc_page method to handle positioning cursor at first page of TOC

Improvements::

  • reclassify and mark which methods in the converter are private
  • organize methods in converter
  • add DOM traversal methods to simplify the logic in the converter
  • remove requirement to add dummy text to title page to preserve it

Bug Fixes::

  • apply top line height padding to first line of text when text runs to top of next page (#2173)
  • don't add entry to outline for notitle section if no content follows it
  • don't add entry to TOC for notitle section if no content follows it
  • look for block align roles on image instead of text align roles (#2176)
  • use correct left value when creating bounding box
  • don't apply border on block images to logo image on title page

=== Details

{url-repo}/releases/tag/v2.0.0.rc.1[git tag] | {url-repo}/compare/v2.0.0.beta.2...v2.0.0.rc.1[full diff]

== 2.0.0.beta.2 (2022-05-14) - @​mojavelinux

Enhancements::

  • add support for float attribute on image; wrap ensuing paragraphs around image with float attribute (#353)
  • add supports_float_wrapping? method for extended converter to override to enlist other blocks in float wrapping; add example to docs (#353)
  • add image-float-gap key to theme to control space around image float (#353)
  • add support for text-transform property on first line of abstract in theme (#2141)
  • rename resolve_alignment_from_role to resolve_text_align_from_role to reflect proper terminology and purpose; alias old method name

... (truncated)

Commits
  • 4b9e2dd release 2.0.0 [no ci]
  • dac1f3d use CSS hex notation for colors in chronicles themes [no ci]
  • 9e843a1 add foundation to support multi-column layout; add example to docs (PR #2190)
  • 667e66a document the PDF compliance keywords that can be passed to the optimize attri...
  • 62a15ad use more stable approach to recreating current bounds in scratch document (PR...
  • dc59c96 release 2.0.0.rc.1 [no ci]
  • 796efbc resolves #1730 allow theme to position caption for code and example blocks be...
  • 82e8998 update instructions to convert basic example, retake screenshot, squoosh it, ...
  • 1b45bc4 prepare README for Asciidoctor PDF 2.0.0 release (PR #2188)
  • 907c9c7 resolves #412 replace docdir attribute reference in value of pdf-themesdir an...
  • Additional commits viewable in compare view


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)
dependabot[bot] commented 2 years ago

Superseded by #1744.