site:
  title: Antora ARC42 Template
  start_page: arc42-template::index.adoc
content:
  sources:
  - url: ./
    start_path: src/docs
    branches: [HEAD]
ui:
  bundle:
    url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
    snapshot: true
asciidoc:
  attributes:
    sectanchors: true
output:
  dir: build/antora
11 September 2023, Ralf D. Müller
docToolchain release v3.0.1!
We just turned the release-candidate into release v3.0.1
About This Release
Wow! The docToolchain community managed to prepare the biggest release in the history of docToolchain! :-)
This release was made possible through the hard work of the following wonderful contributors (in no special order):
@camminati @RoettingerJ @PacoVK @bit-jkraushaar @Frank-dev20 @windows97 @mh182 @rdmueller @dependabot @sparsick @johthor @srotman @PeterStange @klatka
(list was automatically generated by github)
- 
14 Contributors
 - 
23+ fixes
 - 
several additions
 - 
lots of dependency updates
 
Notes
- 
to use the new wrapper, you currently have to fetch it from
https://raw.githubusercontent.com/docToolchain/docToolchain/ng/dtcworhttps://raw.githubusercontent.com/docToolchain/docToolchain/ng/dtcw.ps1instead of the location mentioned in the tutorial - 
./dtcw local install doctoolchainand./dtcw local install javaare now the commands to do an initial local setup - 
generatePDF now needs additional styles, details will follow
 - 
to test the Antora template
- 
install antora: https://docs.antora.org/antora/latest/install/install-antora/
 - 
download the arc42 template as antora style
./dtcw downloadTemplate - 
create a
playbook.yamlwithin the root of your project - 
make sure that your project is a valid git repository and contains at least one commit
 - 
execute
antora playbook.yml 
 - 
 
3.0.1 - 2023-09-11
fixes
- 
#1215: dtcw.ps1 says dtc not installed after exceuting an install
 - 
#1192: exportExcel: unnecessary Rowspans break rendering of table
 - 
fixed curl command in manual
 - 
#1200: JCenter kills doctoolchain, as Grolifant is not available on Maven Central
 - 
#395 asciidoctor-diagram: ERROR: Failed to generate image: PlantUML image generation failed
 - 
#455 Force execution to stop with failure on missing image reference
 - 
#829: Multiple run of dtcw with docker is failing because of a container name conflict
 - 
#1031: dtcw ignores installed Java RE when docker is installed - your java version 17 is too new
 - 
#1161: publishToConfluence looses the id when generating level 2 page anchors
 - 
various fixes in
dtcw,dtcw.ps1:- 
pick the right environment if none provided by the user
 - 
support of JAVA_HOME which was silently ignored.
 
 - 
 - 
Workaround for Confluence new Editor rollout
 - 
#1053: publishToConfluence: hash is displayed at end of some pages
 - 
configure if build should fail on missing images
- 
introduces configuration property
failOnMissingImages 
 - 
 - 
introduce
generateContenttask - AI for docToolchain - 
added req42 framework to downloadTemplate task
 - 
added 'FR' as language for arc42
 - 
Antora support (beta), setup a docToolchain project and integrate it as module seamlessly into your existing Antora playbook. See
downloadTemplatetask for more details. - 
added short tutorial about changing the theme of a microsite
 
changed
- 
add support for Java 17, drop support for Java 8
 - 
upgrade Gradle to 8.1.1
 - 
upgrade dependencies
- 
'com.athaydes:spock-reports:2.3.2-groovy-3.0'
 - 
'com.github.ben-manes.versions:0.46.0'
 - 
'com.structurizr:structurizr-dsl:1.30.1'
 - 
'com.structurizr:structurizr-export:1.14.0'
 - 
'com.structurizr:structurizr-graphviz:2.0.0'
 - 
'de.undercouch.download:5.4.0'
 - 
'io.pebbletemplates:pebble:3.2.0'
 - 
'net.bytebuddy:byte-buddy:1.14.4'
 - 
'org.asciidoctor:asciidoctor-gradle-jvm:4.0.0-alpha.1' (remove obsolete cloning of
reveal.js) - 
'org.asciidoctor:asciidoctorj-diagram:2.2.7'
 - 
'org.apache.httpcomponents:httpmime:4.5.14'
 - 
'org.apache.poi:poi-ooxml:5.2.3'
 - 
'org.codehaus.groovy:groovy-xml:3.0.13'
 - 
'org.jsoup:jsoup:1.16.1'
 - 
'org.junit.jupiter:junit-jupiter-api:5.9.3'
 - 
'org.openapitools:openapi-generator-gradle-plugin:6.6.0'
 - 
'org.openapi.generator:6.6.0'
 - 
'org.spockframework:spock-core:2.3-groovy-3.0'
 
 - 
 - 
dtcwanddtcw.ps1:- 
improve output with hints to guide the user
 - 
add
--versionoption - 
deprecate
getJavawithinstall java - 
add environment variable
DTC_CONFIG_FILEto specify a configuration file other than thandocToolchainConfig.groovyin the project root folder 
 - 
 - 
collectIncludes- 
changed regexp to start with
^[A-Za-z]as file name to allow lowercase filenames as well. - 
certain directories are excluded from traversal. Define
excludeDirectoriesin order to skip additional directories. 
 - 
 - 
doc: replace old URL
doctoolchain.github.iooccurrences with the newdoctoolchain.org - 
publishToConfluence- 
support embedded images
 
 - 
 
Discussion
To discuss the new features, a new discussion thread has been created.
| a big "THANK YOU" to all Sponsors and Contributors who helped to support docToolchain! | 
| 
 You like docToolchain?  |