generateSite

The generateSite task creates a full documentation website. It uses docToolchain’s built-in site generator to produce a microsite with a landing page, navigation, local search, and edit links.

./dtcw4 local generateSite
On Windows, use WSL2 — dtcw4 is a Bash script.

generateSite expects a landing page. Configure it in docToolchainConfig.groovy and provide the matching file (the project template already ships both):

microsite.with {
    landingPage = 'landingpage.gsp'   // file in src/site/doc/
}

The output is written to build/microsite/output/. Open build/microsite/output/index.html in your browser to view the results.

Some JavaScript-based features (like search) require serving the site via HTTP. Use any local web server, e.g. python3 -m http.server -d build/microsite/output.
generateSite
Figure 1. generated output of generateSite task