How to Debug the Publishing Process

When processing fails, the Java stack trace is not displayed by default but can be enabled for debugging.

When the Transformation is Started from Oxygen

To enable the stack trace for debugging purposes, follow these steps:

Open the Configure Transformation Scenario(s) dialog box.
Select your transformation scenario, then click Edit.
Go to the Advanced tab, then do one of the following:
- Uncheck the Prefer using the "dita" command option.
- Add --stacktrace in Additional Ant arguments.

When the Transformation is Started from the Command Line

To display the stack trace in the console, add the --stacktrace parameter. This option is effective only when the --verbose (or -v) or --debug (or -d) options are also set.

Windows
Linux/macOS

dita.bat -f pdf-css-html5 -i C:\path\to\map.ditamap -o C:\path\to\output\dir -v --stacktrace

dita -f pdf-css-html5 -i /path/to/map.ditamap -o /path/to/output/dir -v --stacktrace