DITA Open Toolkit

lib/configuration.properties file

The lib/configuration.properties file controls certain common properties, as well as some properties that control PDF processing.

Figure 1. Properties set in the lib/configuration.properties file
default.language
Specifies the language that is used if the input file does not have the @xml:lang attribute set on the root element. By default, this is set to en. The allowed values are those that are defined in IETF BCP 47, Tags for Identifying Languages.
generate-debug-attributes
Specifies whether the @xtrf and @xtrc debugging attributes are generated in the temporary files. The following values are allowed:
  • true (default) — Enables generation of debugging attributes
  • false —Disables generation of debugging attributes
Note: Disabling debugging attributes reduces the size of temporary files and thus reduces memory consumption. However, the log messages no longer have the source information available and thus the ability to debug problems might deteriorate.
processing-mode
Specifies how the DITA-OT handles errors and error recovery. The following values are allowed:
  • strict — When an error is encountered, the DITA-OT stops processing.
  • lax (default) — When an error is encountered, the DITA-OT attempts to recover from it.
  • skip — When an error is encountered, the DITA continues processing but does not attempt error recovery.
org.dita.pdf2.i18n.enabled
(PDF transformation only) Enables I18N font processing. The following values are allowed:
  • true (default) — Enables I18N processing
  • false — Disables I18N processing
org.dita.pdf2.use-out-temp
(PDF transformation only) Specifies whether the XSL-FO processing writes the intermediate files (for example, the topic.fo file) to the output directory. The following values are allowed:
  • true — Write intermediate files to the output directory
  • false (default) — Write intermediate files to the temporary directory
plugindirs
A semicolon-separated list of directory paths that the DITA-OT searches for plug-ins to integrate; any relative paths are resolved against the DITA-OT base directory. Any immediate subdirectory that contains a plugin.xml file is integrated
plugin.ignores
A semicolon-separated list of directory names to be ignored during plug-in integration; any relative paths are resolved against the DITA-OT base directory.