Updating A Confluence Translation
This guide is for translating Confluence into non-English languages using a Spreadsheet, and covers:
- Improving or finishing a translation for an existing Language Plugin
- Updating an existing translation for a new version of Confluence
If you do not have a Language Plugin to deploy the updated
ConfluenceActionSupport_<KEY>.properties file (where <KEY> is the international language identifier), you should instead go to the Creating A New Confluence Translation.
To make small updates, it is quicker to translate the file directly. If your changes are more substantial, you may prefer to translate using Excel.
This approach uses any file editor. If your translation uses English characters, you can skip to the next section.
Preparing Non-Unicode Files For Direct Translation
If you do not have the Sun Java JDK installed, please download it now. Version 5.0 can be downloaded here.
Create a script or batch file that uses the native2ascii.exe program bundled in <JAVA-JDK-DIRECTORY>/bin to convert from the natively encoded file back to the Unicode file. For example, update the Russian properties file with a script or batch file that calls
ConfluenceActionSupport<KEY>.propertiesto a new file
ConfluenceActionSupport<KEY>-native.txt. Save the new file local non-Unicode character encoding.
Performing Direct Translation
These steps apply to both Unicode and non-Unicode translations:
- Open the properties file (or it's natively encoded equivalent) for editing, translate some or all of the properties file into your target language, and save the changes. If you are translating into a non-Unicode language, always edit
ConfluenceActionSupport<KEY>-native.txt, otherwise modify
- Edit the file content in a text editor, referring to Translating ConfluenceActionSupport Content for more information on how to modify the string values. Users who are unsatisfied with simply opening two copies of the file in their favourite editor may want to try this freeware properties editor, that allows side-by-side comparisons.
- For non-Unicode translations only, run the
native2asciiscript to update
- If you wish to test the update, copy the file back to its original location in the plugin. Then restart Confluence.
Translating Using A Spreadsheet
- Unzip excelbundle0.9.zip to your local drive.
- Browse to your Confluence install and go to the
\confluence\WEB-INF\classes\com\atlassian\confluence\coredirectory. Copy the
ConfluenceActionSupport.propertiesfile there into the
translation_tooldirectory and rename it to
- If you want to start a fresh translation, skip this step. To work from an existing translation, copy it into the
translation_tooldirectory and remove any country variant from the filename, eg
Call the translation tool to create the spreadsheet file. For example, to create a Russian translation, open a terminal window in the
translation_tooldirectory and call
- Edit the file content, referring to Translating ConfluenceActionSupport Content for more information on how to modify the string values.
Call the translation tool to export the updates back into the localised properties file. For the example Russian translation, open a terminal window, go to the
translation_tooldirectory and call
- Once you have completed editing, you must copy and rename the localised translation back to the language plugin directory. For frequent updates, you may wish to create a script to do this.
- To view the updates after copying across the new properties file, select the language plugin for your translation, then restart Confluence and refresh your browser.