Tasks

A task is a standalone Groovy script that performs a specific documentation action — generating output, exporting content, or publishing to external systems.

In v4, tasks are invoked directly via the JVM — no Gradle, no build tool overhead. Each task is a self-contained .groovy file in the scripts/ directory.

Running a Task

./dtcw4 local <taskName>

Listing Available Tasks

./dtcw4 tasks

Task Categories

generateX

These tasks render your AsciiDoc sources to a target format (HTML, PDF, microsite).

exportX

These tasks export content from other formats (Excel, PowerPoint) into AsciiDoc snippets or images that you can include in your documentation. Export results are typically stored under version control because the source tools may not be available on every machine.

publishToX

These tasks publish your documentation to external systems (currently Confluence).

installX

These tasks install a companion tool from the docToolchain ecosystem and — when the project has an AGENTS.md or CLAUDE.md — add a short, conditional hint so LLM agents know when to reach for it.

Available Tasks

Task Description

generateHTML

Generate HTML5 from AsciiDoc

generatePDF

Generate PDF from AsciiDoc

generateSite

Generate a microsite with navigation, search, and blog

downloadTemplate

Download arc42 or req42 documentation templates

exportExcel

Export Excel spreadsheets to AsciiDoc tables and CSV

exportPPT

Export PowerPoint slides as images with speaker notes

publishToConfluence

Publish HTML documentation to Confluence

copyThemes

Copy a built-in theme (jBakeTheme or pdfTheme) into your project for customization

copyLandingPage

Copy an editable landing page into your project as a start page for the microsite

lintAsciiDoc

Lint your AsciiDoc sources with the docToolchain AsciiDoc Linter

generateCICD

Scaffold a dtcw4-based CI/CD pipeline (GitHub Actions or GitLab CI)

installBausteinsicht

Install the Bausteinsicht architecture-as-code tool and hint agents to use it

installDacli

Install the daCLI docs-as-code CLI / MCP server and hint agents to use it