Localizing the User Interface

You can change the language of the Oxygen XML Author user interface by creating an interface localization file. The example in this procedure is based on the Spanish language, and a standard Oxygen XML Author Windows distribution.

1. 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).
2. Write an email to the Oxygen XML Author support team and ask them to send you the translation.xml sample file.
3. Open translation.xml in Oxygen XML Author. 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 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>    

4. Update the language element to reflect the new language. Set the description attribute to Spanish and the lang attribute to es_ES.
5. For each key element translate the comment (optional) and val elements. Set the lang attribute to es_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>

6. Open the Preferences dialog box (Options ⇒ Preferences), go to Global, and enable the Other language option. Browse for the translation.xml file.
7. Restart the application.