local-properties.dita 2.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  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="local.properties">
  5. <title>The <filepath>local.properties</filepath> file</title>
  6. <titlealts>
  7. <navtitle><filepath>local.properties</filepath></navtitle>
  8. </titlealts>
  9. <shortdesc>A <filepath>local.properties</filepath> file in the root directory of the DITA-OT installation can be used
  10. to override the default values of various DITA-OT parameters.</shortdesc>
  11. <prolog>
  12. <metadata>
  13. <keywords>
  14. <indexterm>files<indexterm>local.properties</indexterm></indexterm>
  15. <indexterm>local.properties file</indexterm>
  16. </keywords>
  17. </metadata>
  18. </prolog>
  19. <refbody>
  20. <example>
  21. <p>For example, if you always use the same rendering engine to produce PDF output for all of your projects, you
  22. could create a <filepath>local.properties</filepath> file in the root directory of your DITA-OT installation to
  23. set the <parmname>pdf.formatter</parmname> parameter and additional options for the XSL processor:</p>
  24. <codeblock># Use RenderX XEP Engine for PDF output
  25. pdf.formatter = xep
  26. # Specify the user configuration file for RenderX
  27. custom.xep.config = /path/to/custom.config
  28. </codeblock>
  29. <p>Backslash “\” characters in .properties files must be escaped with a second backslash as “\\”. If you use
  30. Antenna House Formatter on a Windows system, for example, you would set the path to the command using a
  31. properties file entry like this:</p>
  32. <codeblock># Use Antenna House Formatter for PDF output
  33. pdf.formatter = ah
  34. # Specify the path to the Antenna House Formatter command
  35. axf.cmd=C:\\Program Files\\Antenna House\\AHFormatterV62</codeblock>
  36. </example>
  37. <section>
  38. <note>This file can only be used to set Ant property values that can be passed as argument parameters to the
  39. command line. The DITA-OT Java code does not read this file.</note>
  40. </section>
  41. </refbody>
  42. </reference>