Release v3.4.1

05 September 2024, Pascal Euhus

docToolchain release v3.4.1 (Bugfix-Release)

About This Release

This release fixes some bugs and introduces some minor changes.

This version contains a fix for the publishToConfluence task which failed due to a bug introduced in v3.4.0.

One of the change highlights is the switch to the latest version of the HTML Sanity Checker (HSC). After some refactoring, HSC is now also available as batch- and command line tool. This allows to use HSC in CI/CD pipelines or as a standalone tool without the prior requirement to use Gradle.

Furthermore, we did some housekeeping and removed some legacy code and unused configuration properties.

Notes

fixed

Missing alt attributes in site templates (found by HTML Sanity Checker 2.0.0-rc0, see below).
Jira links substitution is not working
publishToConfluence fails with "No such property: attachmentPrefix for class: org.docToolchain.tasks.Asciidoc2ConfluenceTask"
DTCW should preferably use DTC from the local installation and only rely on ${PATH} otherwise
Task :exportEA FAILED because of unknown property 'imageFormat'

added

Add an environment variable DTC_SHELL_DEBUG (which could be set to -x or -xv) to let dtcw run the DTC script in a more verbose way.

changed

Use Release 2.0.0-rc0 of HTML Sanity Checker
removed legacy jiraRoot config property

You like docToolchain?
What about helping to make it even better?
docToolchain is a community project, so be part of the community which drives the project.
You don’t have to code for doing so.
It would even help to brush up the docs, write tutorials or groom the backlog
(I guess many of the open issues are already fixed).