Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix site integration failing with maven-site-plugin v3.10.0 #566

Conversation

abelsromero
Copy link
Member

@abelsromero abelsromero commented Jan 11, 2022

What kind of change does this PR introduce? (check at least one)

  • Bugfix
  • Feature
  • Documentation
  • Refactor
  • Build improvement
  • Other (please describe)

What is the goal of this pull request?
Fixes #564

  • Make AsciidoctorDoxiaParser extend AbstractTextParser instad of XhtmlParser
  • Bump minimum Doxia version to v1.10

Are there any alternative ways to implement this?
The issue does not appear when overriding doxia-core v1.11.1 with v1.9.1, so it could be there's some other issue on doxia.
However, it is also true AsciidoctorDoxiaParser extended XhtmlParser which makes no sense and which is consistent with the error that points to invalid XML document (of course AsciiDoc is not XML compatible).

Are there any implications of this pull request? Anything a user must know?

  • Minimum supported version for doxia-core is v1.10 now (to be sure maven-site-plugin v3.10.0, since site-plugin 3.9.1 uses doxia 1.9.1).
  • We now implement parse() method that recieves the file reference necessary for Better error/warning log handling #323, but it does not work since an extra fix in doxia-site-renderer has not yet been release.

Is it related to an existing issue?

  • Yes
  • No

Finally, please add a corresponding entry to CHANGELOG.adoc

Copy link

@michael-o michael-o left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Incorporate my patch from here: #564 (comment)

@abelsromero abelsromero force-pushed the issue-564-fails-with-mavensite-3.10.0 branch 2 times, most recently from f2d04ae to ffbc0f7 Compare January 15, 2022 09:59
Copy link

@michael-o michael-o left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@abelsromero abelsromero force-pushed the issue-564-fails-with-mavensite-3.10.0 branch from ffbc0f7 to 664819b Compare January 15, 2022 10:31
This makes maven-site-plugin v3.10.0 the minimum compatible version

* Make AsciidoctorDoxiaParser extend AbstractTextParser instad of XhtmlParser
* Bump minimum Doxia version to v1.10
* Update maven-site-plugin it test

Fixes asciidoctor#564
@abelsromero abelsromero force-pushed the issue-564-fails-with-mavensite-3.10.0 branch from 664819b to d55dd49 Compare January 15, 2022 10:37
@abelsromero abelsromero merged commit 1e70af1 into asciidoctor:main Jan 15, 2022
@abelsromero abelsromero deleted the issue-564-fails-with-mavensite-3.10.0 branch August 25, 2022 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Asciidoc maven site integration fails to render with maven-site-plugin 3.10.0
2 participants