configuration-properties.dita 1.8 KB

12345678910111213141516171819202122232425262728
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
  3. <!-- This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license. -->
  4. <reference id="configuring-the-dita-ot">
  5. <title>Configuration properties</title>
  6. <shortdesc>The DITA-OT uses <filepath>.properties</filepath> files and internal properties that store configuration
  7. settings for the toolkit and its plug-ins. Configuration properties are available to both Ant and Java processes,
  8. but unlike argument properties, they cannot be set at run time.</shortdesc>
  9. <refbody>
  10. <section>
  11. <p>When DITA-OT starts the Ant process, it looks for property values in the following order and locations:</p>
  12. <ol>
  13. <li>Any property passed to Ant from the command line with <parmname>-Dproperty</parmname> or
  14. <parmname>--property</parmname>=<option>value</option></li>
  15. <li>A custom property file passed with <parmname>--propertyfile</parmname></li>
  16. <li>A <filepath>local.properties</filepath> file in the root directory of the DITA-OT installation</li>
  17. <li>The <filepath>lib/org.dita.dost.platform/plugin.properties</filepath> file</li>
  18. <li>The <filepath>configuration.properties</filepath> file</li>
  19. </ol>
  20. <p>If a given property is set in multiple places, the first value “wins” and subsequent entries for the same
  21. property are ignored.</p>
  22. <p>You can use this mechanism to override DITA-OT default settings for your environment by passing parameters to
  23. the <cmdname>dita</cmdname> command with <parmname>--property</parmname>=<option>value</option>, or using
  24. entries in <filepath>.properties</filepath> files.</p>
  25. </section>
  26. </refbody>
  27. </reference>