vy opened a new pull request, #2427: URL: https://github.com/apache/logging-log4j2/pull/2427
This PR migrates the `asciidoctor-maven-plugin`-based current website in `2.x` to Antora *with several other improvements*. ### Rationale Developers love AsciiDoc, but `asciidoctor-maven-plugin` falls short on addressing our needs to build a website from ~70 AsciiDoc files. In particular, the navigation (creating an overarching menu, breadcrumbs, etc.) is problematic; there is no easy way to tell the user at which level of the hierarchy they are standing at. Antora, the de facto offline site generator for AsciiDoc, address all these shortcomings and more. ### Deliverables This PR implements the following deliverables 1. Website is migrated to Antora 1. All Javadoc links are fixed 1. All inter-page links are fixed 1. Auto-generated release notes is re-worked to avoid cluttering the Git history. Now it only runs during the `pre-site` phase and outputs to `target/generated-site` instead. 1. Auto-generated `constants.adoc` is directed to `target/generated-site` too (similar to release notes explained above) 1. `log4j-docgen-asciidoctor-extension` is ported to JavaScript to work as a Asciidoctor.js extension (since that is what Antora uses) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: notifications-unsubscr...@logging.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org
