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.0
Release Notes
Getting Started
User Guide
Developer Reference

Error messages and troubleshooting

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

DITA-OT error messages
The error messages generated by the DITA Open Toolkit contain a message ID, severity information, and message text. 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.
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 from the command-line tool
You can access a list of supported parameters for the command-line tool by issuing the -help parameter.
Determining the version of the DITA Open Toolkit
You can use the command-line tool to determine the version of the DITA OT.
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 environmental variable.

Parent topic: DITA Open Toolkit User Guide

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