DITA Open Toolkit

Download
Docs
- Development
- Current version
- Release 3.0
- Previous versions
- 2.5
- 2.4
- 2.3
- 2.2
- 2.1
- 2.0
- 1.8
- 1.7
- 1.6
- 1.5.4
- 1.5.3
- 1.5.2
Contribute
Collaboration
DITA-OT Day

DITA Open Toolkit 2.3
Release Notes
Getting Started
User Guide
Parameter Reference
Developer Reference

Error messages and troubleshooting

This section contains information about problems that you might encounter and how to resolve them.

Prerequisite software
The prerequisite software that the DITA-OT requires depends on the types of transformations that you want to use.
DITA-OT error messages
This topic lists each error message generated by the toolkit and provides additional information that might be helpful in understanding and resolving the error condition. If your toolkit installation includes custom plug-ins that define additional messages, you can add to this list by rebuilding the DITA-OT documentation.
Other error messages
In addition to error messages generated by the DITA Open Toolkit, you might also encounter error messages generated by Java or other tools.
Log files
When you run the DITA-OT, key information is logged on the screen. This information can also be written to a log file. If you encounter a problem, you can analyze this information to determine the source of the problem and then take action to resolve it.
Accessing help for the dita command
You can access a list of supported parameters for the dita command by issuing the -help parameter.
Checking the DITA-OT version
You can determine the version of the DITA Open Toolkit from a command prompt.
Enabling debug mode
When the debug mode is enabled, additional diagnostic information is written to the log file. This information, which includes environment variables and stack trace data, can help you determine the root cause of a problem.
Increasing Java memory allocation
If you are working with large documents with extensive metadata or key references, you will need to increase the memory allocation for the Java process. You can do this from the command-line prompt for a specific session, or you can increase the value of the ANT_OPTS environment variable.
Reducing processing time
Several configuration changes can significantly reduce DITA-OT processing time.

DITA Open Toolkit is released under the Apache License, Version 2.0.

Find topics by title

You’ve activated the topic finder by typing “t”. Start typing to filter the list of topics.

Use ↑ and ↓ to navigate the results. Press ENTER to view a topic, or ESC to close this dialog.

Keyboard shortcuts

You’ve activated the keyboard shortcuts help by typing “?”. Press ESC to close this dialog.

`t`	Open the topic finder to filter the list of topic titles
`s`	Use the search field to find text in topic content
`?`	Show this list of keyboard shortcuts