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.

Table 1. Properties set in the lib/configuration.properties file
Property Description
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 the Identification of 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.index.frame-markup (PDF transformation only) Specifies how the DITA-OT handles legacy FrameMaker syntax for <indexterm> elements. The following values are allowed:
  • true— Enables special processing of legacy FrameMaker syntax for <indexterm> elements. Standard DITA <indexterm> elements are processed also.
  • false (default) — Disables special processing of legacy FrameMaker syntax for <indexterm> elements.
Note: Setting the org.dita.pdf2.index.frame-markup parameter to yes only affects how index entries are generated in PDF output. For example, an <indexterm>files:topic</index> element will generate an index entry of "files:topic" in a CHM file.
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.
Parent topic: Reference