The <filepath>configuration.properties</filepath> file configuration.properties The lib/configuration.properties file controls certain common properties, as well as some properties that control PDF processing. 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

The contents of the configuration.properties file are added to the DITA-OT configuration in the dost-configuration.jar file when the plug-in integration process runs. The following properties are typically set in this file:

otrelease otversion The DITA-OT release number and maintenance version stored here are read when version information is requested on the commmand line via dita . default.cascade

Specifies the processing default value for the DITA 1.3 cascade attribute, which determines how map-level metadata attributes are applied to the children of elements where the attributes are specified. DITA-OT uses the value by default for backwards compatibility with DITA 1.2 and earlier.

This property can only be set in configuration.properties and should not be modified. temp-file-name-scheme

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.

 cli.color

Specifies whether the dita command prints colored output on the command line console. When set to , error messages in dita command output will appear in red on terminals that support ANSI escape codes, such as on Linux or macOS. Set to to disable the color. (Colored output is not supported on Windows consoles such as cmd.exe or PowerShell).

 plugindirs 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 plugin.xml file is installed. plugin.ignores 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. plugin.order 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.