This section is used for identifying problems when installing and executing the DITA Open Toolkit.
In some cases, you might receive a message stating the build has failed due to an "Out of Memory" error. Please follow the steps below to fix this problem:
For Windows, type set ANT_OPTS=%ANT_OPTS% -Xmx256M in the command prompt, you can also choose to add a new opition -Xmx256M to the ANT_OPTS environment variable.
For Linux, type export ANT_OPTS=${ANT_OPTS} -Xmx256M in the command prompt.
In some cases, when you run the JavaHelp transformation, you might receive the exception above. This problem is caused by some HTML files unrelated with the current JavaHelp transformation were found under the output directory. Please follow the steps below to fix this problem:
In some situations, the toolkit may fails to load the message file due to some exceptions thrown.
To fix this problem, you need to check if there are files 'resource/messages.xml' and 'resource/messages.dtd' in the directory that you run the toolkit. If not, please copy them from the toolkit's root directory.
Spaces in file names will cause trouble during the processing because Ant use space as the delimiter when processing batch files in a list. Please prevent using spaces in the name of dita files.