Localization of the User Interface Using an XML File

In order to add a new language for the user interface, follow this procedure. For simplicity sake, it is assumed that you are translating the user interface in Spanish, and you are using a standard Oxygen XML Developer Windows distribution.

1. Identify the ISO code for the new language you wish to translate the interface. In this example the language code is es_ES.
2. Write an email to Oxygen XML Developer support team and ask them to send you the translation.xml sample file.
3. Open translation.xml in Oxygen XML Developer. The file contains all messages available for internationalization and it 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 this step the file should look like:

   <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="en_US">Nuevo</val>
       </key>    
       <key value="New_folder">
           <comment>Crea una carpeta en la vista del proyecto.</comment>
           <val lang="en_US">Nueva carpeta</val>
       </key>
       .....
   </translation>

6. Go to Options/Preferences menu, Global options page. Enable the Other language option and browse for the translation.xml file.
7. Restart the application.