Localizing the User Interface
Oxygen XML Developer comes with the following built-in languages: English, French, German, Japanese, Dutch, and Chinese. To change the interface language, go to preferences page, then choose the appropriate language from the Language drop-down menu.
You can also localize the interface in another language by creating an interface localization file.
How to Create an Interface Localization File
You can change the language of the Oxygen XML Developer user interface by
creating an interface localization file:
- Identify the code for the new language you want to translate the interface. It is composed from a language code (two or three lowercase letters that conform to the ISO 639 standard), followed by an underscore character, and a region code (two or three uppercase letters that conform to the ISO 3166 standard).
- Write an email to the Oxygen XML Developer support team and ask them to send you the translation.xml sample file.
- Open the translation.xml file in Oxygen XML Developer.
The file contains all the interface messages that can be translated and is updated at
every new release with the latest additions. Here is a small sample of its
content:
<translation> <languageList> <language description="English" lang="en_US"/> </languageList> <key value="New"> <comment>The File/New action. Creates a new document.</comment> <val lang="en_US">New</val> </key> <key value="New_folder"> <comment>Creates a folder in the Project View.</comment> <val lang="en_US">New Folder</val> </key> ..... </translation>
- Update the
<language>
element to reflect the new language. For example, set the@description
attribute toSpanish
and the@lang
attribute toes_ES
. - For each
<key>
element, translate the<comment>
(optional) and<val>
elements. For example, set the@lang
attribute toes_ES
.Note: After you are finished, the file should look like this:<translation> <languageList> <language description="Español" lang="es_ES"/> </languageList> <key value="New"> <comment>El Archivo / Nueva acción. Crea un nuevo documento.</comment> <val lang="es_ES">Nuevo</val> </key> <key value="New_folder"> <comment>Crea una carpeta en la vista del proyecto.</comment> <val lang="es_ES">Nueva carpeta</val> </key> ..... </translation>
- Open the Preferences dialog box , go to Global, and select the Other language option. Browse for the translation.xml file.
- Restart the application.
Adding New Languages to the Interface
Oxygen XML Developer provides a plugin extension is available in the Oxygen SDK that provides the ability to contribute a new translation language to the interface. By using this plugin extension, you can bundle the new language translation and that new language will be available in the Languages drop-down menu in the preferences page.