Edit online

This section applies to the DITA Map PDF - based on HTML5 & CSS transformation type.

In this type of transformation, the intermediary merged DITA map is transformed to HTML5 using the DITA-OT built-in support, so the customization of the internationalization (the labels for chapters, parts, figures, tables, notes, etc.) can be achieved by following the DITA-OT recommendations: Customizing Generated Text.

It is recommended that you do this customization on a DITA-OT distribution deployed outside of the Oxygen installation. Otherwise, you will lose the customization when upgrading Oxygen. You can contact the Oxygen support team to ask for the Oxygen Publishing Engine package.

Edit online

There are supported over 20 languages. For the full list of supported languages (and their codes), see the list: https://www.dita-ot.org/3.2/topics/globalization-languages.html.

Edit online

There are two ways to switch the labels to a specific language:

  • Alter the DITA maps and/or topics to have the @xml:lang attribute set to the root element, to one of a supported value (i.e. "fr", "de", "zh", "ru").
  • If changing the files is not an option, you can alter the value of the transformation parameter default.language to the desired language code.

Edit online

If the list of supported languages does include the language you need, you can create a custom dictionary for this transformation.

The DITA-OT documentation offers a good insight on how to do it: https://www.dita-ot.org/3.2/topics/plugin-addgeneratedtext.html

In addition to that, you need to alter your CSS. Some of the labels come from CSS files located in:


You should use one of the files as a template and copy its rules to your customization CSS and translate the labels. Make sure you change also the :lang selector to match your language code.