code-srv-test/dita-ot-3.6/doc/topics/troubleshooting-overview.html
2021-03-23 22:38:58 +00:00

11 lines
No EOL
5.1 KiB
HTML

<!DOCTYPE html
SYSTEM "about:legacy-compat">
<html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2020"><meta name="generator" content="DITA-OT"><meta name="description" content="This section contains information about problems that you might encounter and how to resolve them."><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Error messages and troubleshooting</title></head><body id="task_pd3_vdv_qg"><header role="banner"><div class="header">
<p>DITA Open Toolkit</p>
<hr>
</div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.6</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../topics/input-formats.html">Authoring formats</a></li><li><a href="../topics/output-formats.html">Output formats</a></li><li><a href="../parameters/index.html">Parameters</a></li><li><a href="../topics/html-customization.html">Customizing HTML</a></li><li><a href="../topics/pdf-customization.html">Customizing PDF</a></li><li><a href="../topics/adding-plugins.html">Adding plug-ins</a></li><li><a href="../topics/custom-plugins.html">Creating plug-ins</a></li><li class="active"><a href="../topics/troubleshooting-overview.html">Troubleshooting</a><ul><li><a href="../topics/logging.html">Logging</a></li><li><a href="../topics/enabling-debug-mode.html">Enabling debug mode</a></li><li><a href="../topics/error-messages.html">DITA-OT error messages</a></li><li><a href="../topics/other-errors.html">Other error messages</a></li><li><a href="../topics/dita-command-help.html">Command line help</a></li><li><a href="../topics/increasing-the-jvm.html">Increasing Java memory</a></li><li><a href="../topics/reducing-processing-time.html">Speeding up builds</a></li></ul></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
<h1 class="title topictitle1" id="ariaid-title1">Error messages and troubleshooting</h1>
<p class="shortdesc">This section contains information about problems that you might encounter and how to resolve
them.</p>
<nav role="navigation" class="related-links"><ul class="ullinks"><li class="link ulchildlink"><strong><a href="../topics/logging.html">Logging build information</a></strong><br>When you run 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.</li><li class="link ulchildlink"><strong><a href="../topics/enabling-debug-mode.html">Enabling debug mode</a></strong><br>Debug logging prints considerably more additional information. The debug log includes all information from the verbose log, plus details on Java classes, additional Ant properties and overrides, preprocessing filters, parameters, and stages, and the complete build sequence. The debug log can help you determine the root cause of a problem.</li><li class="link ulchildlink"><strong><a href="../topics/error-messages.html">DITA-OT error messages</a></strong><br>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.</li><li class="link ulchildlink"><strong><a href="../topics/other-errors.html">Other error messages</a></strong><br>In addition to error messages that DITA Open Toolkit generates, you might also encounter error messages generated by Java or other tools.</li><li class="link ulchildlink"><strong><a href="../topics/dita-command-help.html">Accessing help for the dita command</a></strong><br>You can access a list of subcommands and supported parameters for the <span class="keyword cmdname">dita</span> command by passing the <span class="keyword parmname">--help</span> option on the command line.</li><li class="link ulchildlink"><strong><a href="../topics/increasing-the-jvm.html">Increasing Java memory allocation</a></strong><br>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 <code class="ph codeph">ANT_OPTS</code> environment variable.</li><li class="link ulchildlink"><strong><a href="../topics/reducing-processing-time.html">Speeding up builds</a></strong><br>Several configuration changes can significantly reduce DITA-OT processing time.</li></ul></nav></article></main></body></html>