v3.2.0

This patch release contains a new feature for both the Maven plugin and site modules.

Improvements (for all modules)::

• Add failFast option to logHandler to allow displaying all errors in build (#1032)

Build / Infrastructure::

• Set minimal supported Maven version to 3.8.8 #1029

As always, thanks to all contributors! Especially those taking time to provide report issues and feedback 👍

Release Meta

Released on: 2025-03-22
Released by: @abelsromero
Soundtrack: -

v3.1.1

This patch release contains fixes and internal changes (refactors) that do not affect features.

As always, thanks to all contributors! Especially those taking time to provide report issues and feedback 👍

Improvements (for all modules)::

• Use Maven Eclipse Sisu to inject components (allowed refactors to increase code re-use) #945
• Centralize Maven4 configurations in a profile in the parent #945

Bug Fixes (Site Modules)::

• Fix resolution of baseDir for Doxia modules (with locales) #968

Improvements (Site Modules)::

• Unify loggers initialization to be static #971

Build / Infrastructure::

• Bump Maven Wrapper to v3.9.9 #978

Release Meta

Released on: 2024-11-14
Released by: @abelsromero
Soundtrack: Iron Maiden- Tears of a Clown (The Book of Souls)

v3.1.0

This minor release contains many new features and fixes.

This release has seen a lot of work put into the Maven Site integration, most notably the implementation of new features for the Parser Doxia Module.
With these changes, the module graduates from Experimental to Beta, making it ready for general use.
We encourage everyone to use it and report any issues or possible improvements.

As always, thanks to all contributors! Especially those taking time to provide report issues and feedback 👍

Improvements (for all modules)

• Added support for AsciidoctorJ v3.0.0 #651
• Add compatibility with maven-site-plugin v3.20.0 and Doxia v2.0.0 #933

Improvements (for Parser Doxia Module)

• Add support for code blocks titles #935
• Refactor AST traversal method #944
• Empty titles in document or empty literals no longer generate <h1> or <pre> #944
• Sections are now wrapped in <div> #944
• Add support for Inline and Example blocks #938
• Add support for Captioned titles in appendixes, tables, listing, figure, and examples #749
• Add INFO message to site modules showing the filename in case of issues #323

Bug Fixes (for Parser Doxia Module)

• Fix open IMG tags #783
• Fix empty table generating <table> element #938

Bug Fixes (for Converter Doxia Module)

• Fix Converter Doxia Module naming in POM #934

Documentation

• Fix absolute path in usage example and AsciiDoc references in docs (https://github.com/MarkusTiede[@MarkusTiede])(#592)

Release Meta

Released on: 2024-10-30
Released by: @abelsromero
Soundtrack: Porcupine Tree - How is your life today? (Lightbulb Sun)

v3.0.0

This major release ("It's about time") contains new features, fixes, and BREAKING CHANGES.
⚠️ Make sure to check the Maven Plugin and Site Modules migration guides to help with the upgrade (it should be available soon after the release).

The most notable changes for users are:

• Set Java 11 as baseline.
• Refactoring of code base into independent modules 👨‍💻 :
  • The new asciidoctor-maven-plugin contains the well-known maven plugin without maven-site integration dependencies. This will safe some time and bandwidth when using it ⏳ .
  • The maven-site integration Doxia module has been renamed to asciidoctor-converter-doxia-module. Those using the current one may want to use this for minimal impact.
  • A new maven-site integration Doxia module 🎉 has been introduced, asciidoctor-parser-doxia-module. This modules is made to be compatible with the popular Fluido skin and aims to make it easy to write your site docs in AsciiDoc as a drop-in replacement for any other format. No need for custom CSS or other customizations, albeit not all Asciidoctor features are supported yet. Please, report if you want anything added in the following releases.

As a consequence of the refactoring, the parent project is now called asciidoctor-maven-tools this will reflect in this repository tags, but it's of no consequence for users.

Another line of work in this release has been the automation of several maintenance tasks 🔧 to improve the overall shape of the project and facilitate faster and more regular releases 🚀

• Introduction of Dependabot to maintain dependencies.
• Several CI improvements and automation of releases via GH Actions. If you see this, this means it worked 😄

As always, thanks to all contributors! Especially those taking time to provide report issues and feedback 👍

Improvement

• Split plugin and site integration in sub-modules: asciidoctor-maven-plugin and asciidoctor-doxia-module #595
• Add 'asciidoc' as a valid file extension in AsciidoctorDoxiaParserModule (#595)
• Fix throwing an exception when registering a non Extension (#596)
• Reimplement resource copy using 'plexus.util.DirectorScanner' instead of 'maven-filtering' to reduce dependencies and build time #597
• Replace deprecated 'headerFooter' by 'standalone' in configuration (#649)
• Remove internal use of 'destinationDir' AsciidoctorJ method (#650)
• Upgrade Asciidoctorj to v2.5.11 (#688) and jRuby to v9.4.5.0 (#665)
• Improve the warning message when the destination file is going to be replaced (#728)
• Added .editorconfig file to facilitate code formatting (#760)

Bug Fixes

• Fix default value for eruby which caused a fail when using erb templates (#610)
• Fix maven properties not being injected as attributes during site conversion (#656)
• Remove Java 'requires open access' module warning in modern Java versions with JRuby v9.4.5.0 (#553)
• Fix breadcrumbs not showing the document title in maven-site pages (#763)

Documentation

• Fix absolute path in usage example and AsciiDoc references in docs (https://github.com/MarkusTiede[@MarkusTiede])(#592)

Release Meta

Released on: 2024-02-14
Released by: @abelsromero
Soundtrack: Devin Townsend - Disco Inferno (Order of Magnitude)

v2.2.6

Patch release with minor fixes.
No substantial code changes or new features have been introduced.

As always, thanks to all contributors! Specially those taking time providing report issues and feedback 👍

Improvement

• Push Asiidoctor header metadata (author(s), conversion time and title) to maven-site pages meta tag (#769)

Bug Fixes

• Fix breadcrumbs not showing the document title in maven-site pages (#763). Thanks @kriegaex.

Release Meta

Released on: 2024-02-09
Released by: @abelsromero
Soundtrack: Steven Wilson - Impossible Tightrope

v2.2.5

Patch release with minor fixes.
No substantial code changes or new features have been introduced.

As always, thanks to all contributors! Specially those taking time providing report issues and feedback 👍

Fixes

• Remove Java 'requires open access' module warning in modern Java versions with JRuby v9.4.5.0 (#553). Thanks @khmarbaise for notifiying of the fix.
• Check for both destinationDir and toDir to avoid invalid "Duplicated destination found" messages, and improve warning message (#728). Thanks @kriegaex for reporting.

Build / Infrastructure

• Use latest Maven v3.9.6 in CI and wrapper (#659)
• Bump AsciidoctorJ to v2.5.11 and jRuby to v9.4.5.0
• Integrated Dependabot to ease maintenance

Release Meta

Released on: 2024-01-11
Released by: @abelsromero
Soundtrack: Joe Hisaishi - Studio Ghibli Concert (2008)

v2.2.4

V2.2.4 is a fix release for Maven warnings introduced in v3.9.2, see "Plugins validation warnings" in Maven's release notes.
No substantial code changes or new features have been introduced.

As always, thanks to all contributors! Specially those taking time providing report issues and feedback 👍

Build / Infrastructure

• #632 Add Maven matrix testing, and define Maven compatibility policy
• #639 Bump Asciidoctorj to v2.5.8 and jRuby to v9.3.10.0
• #623 Maven 3.9.2 displays warnings with version 2.2.3
• #641 Add maven-site-plugin v3.10.0 integration test
• #644 Fix maven-source-plugin configuration for release (hot-fix during release, not documented in CHANGELONG)

Release Meta

Released on: 2023-05-28
Released by: @abelsromero
Soundtrack: Of The New Day (Porcupine Tree)

v2.2.3

V2.2.3 is fix release for several CVEs related to netty-codec-http. Special thanks to @JanWesterkamp-iJUG for bringing the topic and the support provided.

Is important to note, that netty-codec-http is used ONLY for preview goals auto-refresh and http, and have no impact in normal conversion using process-asciidoc.

This release also includes some fixes ported from main branch listed below.
As always, thanks to all contributors! Specially those taking time providing report issues and feedback 👍

Fixes

• #610 Fixed default value for eruby which caused a failure when using erb templates. Thanks (@mokdeve) for reporting.

Documentation

• #592 Fix absolute path in usage example and AsciiDoc references in docs (@MarkusTiede)

Build / Infrastructure

• #620 Upgrade Asciidoctorj to v2.5.7 and jRuby to v9.3.8.0
• #625 Bump Doxia to v1.12.0 and test with maven-site-plugin v3.12.1
• #620 Bump netty-codec-http to v4.1.90.Final, fixes several CVEs
• #622 Delete unused TravisCI configuration
• #623 Bump Maven build plugins
• #624 Bump GH 'checkout' and 'setup-java' to v3

Release Meta

Released on: 2023-03-18
Released by: @abelsromero
Soundtrack: Dimensions (Devin Townsend)

v2.2.2

V2.2.2 ("Last mile") closes the v2 release train, to start work on breaking changes for next v3.

This release includes fixes and compatibilty with latest version of maven-site-plugin. Please, pay attention to details below if you find issues when upgrading.

As always, thanks to all contributors! Specially those taking time providing report issues and feedback 👍

Fixes

• #550 Exclude dot files and folders from conversion
• #563 Fix StringIndexOutOfBoundsException parsing log records when cursor file is above source directory
• #566 Fix compatibility with maven-site-plugin v3.10.0 (previous versions no longer supported) (https://github.com/michael-o[@michael-o])

Documentation

• #533 Add ID's for all parameters of process-asciidoc, auto-refresh and http mojo, to be able to generate direct urls (https://github.com/uniqueck[@uniqueck])
• #558 Clarify where to put the plugin section in pom.xml (#558)
• #569 Add compatibility matrix

Build / Infrastructure

• #573 Migrate Maven Wrapper to Apache's offical one
• #572 Upgrade Asciidoctorj to v2.5.3 and jRuby to v9.2.20.1
• #557 Support Java 17
• #561 Bump netty-codec-http to v4.1.71.Final

Release Meta

Released on: 2022-01-30
Released by: @abelsromero
Soundtrack: Seventh Wave (Devin Townsend)

v2.2.1

V2.2.1 contains a fix that could impact Jenkins users (#545) when Jenkins creates a working directory in with "_" prefix.

Thanks @liampuk for reporting!

Improvements

• #546 Fix excluding sources when enclosing parent path starts with _

Release Meta

Released on: 2021-07-24
Released by: @abelsromero
Soundtrack: Chrysalis (Opeth)