bn
/
se


			
				
					
						
						
							1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
							<!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 2018"><meta name="DC.rights.owner" content="(C) Copyright 2018"><meta name="DC.Type" content="reference"><meta name="description" content="The lib/configuration.properties file controls certain common properties, as well as some properties that control PDF processing."><meta name="DC.subject" content="configuration properties, default.cascade, org.dita.pdf2.i18n.enabled, otrelease, otversion, plugin.ignores, plugin.order, plugindirs, temp-file-name-scheme, files, lib/configuration.properties file, PDF processing, configuration properties"><meta name="keywords" content="configuration properties, default.cascade, org.dita.pdf2.i18n.enabled, otrelease, otversion, plugin.ignores, plugin.order, plugindirs, temp-file-name-scheme, files, lib/configuration.properties file, PDF processing, configuration properties"><meta name="DC.Relation" scheme="URI" content="../parameters/configuration-properties.html"><meta name="DC.Relation" scheme="URI" content="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/cascading-in-a-ditamap.html#cascading-in-a-ditamap"><meta name="DC.Relation" scheme="URI" content="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/example-how-cascade-att-functions.html"><meta name="DC.Relation" scheme="URI" content="http://www.elovirta.com/2016/02/18/font-configuration-in-pdf2.html"><meta name="DC.Format" content="HTML5"><meta name="DC.Identifier" content="configuration"><meta name="DC.Language" content="en"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>The configuration.properties file</title></head><body id="configuration"><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.0</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/alternative-input-formats.html">Authoring formats</a></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../parameters/index.html">Setting parameters</a><ul><li><a href="../parameters/dita-command-arguments.html">DITA command arguments</a></li><li><a href="../parameters/parameters_intro.html">DITA-OT parameters</a></li><li><a href="../parameters/configuration-properties.html">Configuration properties</a><ul><li><a href="../parameters/local-properties.html">local.properties</a></li><li><a href="../parameters/lib-plugin-properties.html">plugin.properties</a></li><li class="active"><a href="../parameters/lib-configuration-properties.html">configuration.properties</a></li><li><a href="../parameters/internal-ant-properties.html">Internal Ant properties</a></li></ul></li></ul></li><li><a href="../topics/extending-the-ot.html">Customizing DITA-OT</a></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></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">The <span class="ph filepath">configuration.properties</span> file</h1>
  
  
  
  <div class="body refbody"><p class="shortdesc">The <span class="ph filepath">lib/configuration.properties</span> file controls certain common properties, as well as
    some properties that control PDF processing.</p>
    <section class="section">
      <p class="p">The contents of the <span class="ph filepath">configuration.properties</span> file are added to the DITA-OT configuration
        in the <code class="ph codeph">dost-configuration.jar</code> file when the plug-in integration process runs. The following
        properties are typically set in this file:</p>
      <dl class="dl parml">
        
          <dt class="dt pt dlterm" id="configuration__otrelease-otversion"><span class="keyword parmname">otrelease</span></dt>
          <dt class="dt pt dlterm"><span class="keyword parmname">otversion</span></dt>
          <dd class="dd pd">The DITA-OT release number and maintenance version stored here are read when version information is
            requested on the commmand line via <span class="keyword cmdname">dita</span>
            <span class="keyword option">--version</span>.</dd>
        
        
          <dt class="dt pt dlterm" id="configuration__default-cascade"><span class="keyword parmname">default.cascade</span></dt>
          <dd class="dd pd">
            <p class="p">Specifies the processing default value for the DITA 1.3 <code class="keyword markupname xmlatt">@cascade</code> attribute, which
              determines how map-level metadata attributes are applied to the children of elements where the attributes
              are specified. DITA-OT uses the <span class="keyword option">merge</span> value by default for backwards compatibility with
              DITA 1.2 and earlier.</p>
            <div class="note warning note_warning" id="configuration__protected-config-props"><span class="note__title">Warning:</span> This property can only be set in
                <span class="ph filepath">configuration.properties</span> and should not be modified.</div></dd>
        
        
          <dt class="dt pt dlterm" id="configuration__temp-file-name-scheme"><span class="keyword parmname">temp-file-name-scheme</span></dt>
          
          <dd class="dd pd">
            <p class="p">This setting specifies the name of the Java class that defines how the source URL of a topic is mapped to
              the URL of the temporary file name. The current default method uses a 1:1 mapping, though future
              implementations may use alternative approaches such as hashes or full absolute paths as file names.</p>
            <div class="note warning note_warning"><span class="note__title">Warning:</span> This property can only be set in
                <span class="ph filepath">configuration.properties</span> and should not be modified.</div>
          </dd>
        
        
          <dt class="dt pt dlterm" id="configuration__cli-color"><span class="keyword parmname">cli.color</span></dt>
          <dd class="dd pd">
            <p class="p">Specifies whether the <span class="keyword cmdname">dita</span> command prints colored output on the command line console.
              When set to <span class="keyword option">true</span>, error messages in <span class="keyword cmdname">dita</span> command output will appear in
              red on terminals that support <a class="xref" href="https://en.wikipedia.org/wiki/ANSI_escape_code" target="_blank">ANSI escape codes</a>, such as on Linux or macOS. Set to <span class="keyword option">false</span> to
              disable the color. (Colored output is not supported on Windows consoles such as <span class="keyword cmdname">cmd.exe</span>
              or PowerShell).</p>
          </dd>
        
        
          <dt class="dt pt dlterm" id="configuration__plugindirs"><span class="keyword parmname">plugindirs</span></dt>
          <dd class="dd pd" id="configuration__plugindirs.desc">A semicolon-separated list of directory paths that the DITA-OT searches for plug-ins
            to install; any relative paths are resolved against the DITA-OT base directory. Any immediate subdirectory
            that contains a <span class="ph filepath">plugin.xml</span> file is installed.</dd>
        
        
          <dt class="dt pt dlterm" id="configuration__plugin.ignores"><span class="keyword parmname">plugin.ignores</span></dt>
          <dd class="dd pd" id="configuration__plugin.ignores.desc">A semicolon-separated list of directory names to be ignored during plug-in
            installation; any relative paths are resolved against the DITA-OT base directory.</dd>
        
        
          <dt class="dt pt dlterm" id="configuration__plugin-order"><span class="keyword parmname">plugin.order</span></dt>
          <dd class="dd pd">Defines the order in which plug-ins are processed. In XML catalog files, the order of imports is
            significant. If multiple plug-ins define the same thing (differently), the first catalog entry “wins”.
            DITA-OT uses this property to define the order in which catalog entries are written. This mechanism is
            currently used to ensure that DITA 1.3 grammar files take precedence over their DITA 1.2 equivalents.</dd>
        
        
            <dt class="dt pt dlterm"><span class="keyword parmname">org.dita.pdf2.i18n.enabled</span></dt>
            <dd class="dd pd">
              <p class="p">Enables internationalization (I18N) font processing to provide per-character font selection for FO
                renderers that do not support the <code class="ph codeph">font-selection-strategy</code> property (such as Apache
                FOP).</p>
              <p class="p">When this feature is enabled, DITA-OT uses a font mapping process that takes the content language into
                consideration. The mapping process uses configuration files for each language to define characters that
                should be rendered with certain logical fonts, and font mappings that associate each logical font to
                physical font files.</p>
              <p class="p">The following values are allowed:</p>
              <ul class="ul">
                <li class="li"><span class="keyword option">true</span> (default) — Enables font mapping</li>
                <li class="li"><span class="keyword option">false</span> — Disables font mapping</li>
              </ul>
              <div class="note tip note_tip"><span class="note__title">Tip:</span> If you don’t use custom character mappings, turning off font mapping makes it easier to
                define custom fonts simply by changing font names in the XSL attributes files of your custom PDF
                plug-in. For details, see <a class="xref" href="http://www.elovirta.com/2016/02/18/font-configuration-in-pdf2.html" target="_blank">Font configuration in PDF2</a>.</div>
            </dd>
          
      </dl>
    </section>
  </div>
  <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../parameters/configuration-properties.html" title="The DITA-OT uses .properties files and internal properties that store configuration settings for the toolkit and its plug-ins. Configuration properties are available to both Ant and Java processes, but unlike argument properties, they cannot be set at run time.">Configuration properties</a></div></div><div class="linklist relinfo"><strong>Related information</strong><br><ul class="linklist"><li class="linklist"><a class="link" href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/cascading-in-a-ditamap.html#cascading-in-a-ditamap" target="_blank">DITA 1.3 specification: Cascading of metadata attributes in a DITA map</a></li><li class="linklist"><a class="link" href="http://docs.oasis-open.org/dita/dita/v1.3/errata01/os/complete/part1-base/archSpec/base/example-how-cascade-att-functions.html" target="_blank">Example: How the @cascade attribute functions</a></li><li class="linklist"><a class="link" href="http://www.elovirta.com/2016/02/18/font-configuration-in-pdf2.html" target="_blank">Font configuration in PDF2</a></li></ul></div></nav>
</article></main></body></html>