4. Confluence Docs 3.0 : Creating A New Confluence Translation This page last changed on Aug 16, 2006 by david.soul@atlassian.com. If you would like to translate Confluence into your local language, follow the instructions below on creating a language pack plugin from an example. The Confluence community is sharing their in-progress and complete translations. You should check that a shared translation to your target language has not already been started here. ## Preparation Start by checking out the technical overview of a Language Pack Plugin. Once you are familiar with the structure and content of a plugin, you can move on to creating your own: Check that you have the latest version of Confluence here. If not, you are recommended to install the latest version for translation, though you can use any version newer than 2.2. Refer to the guide on Upgrading Confluence for instructions. If you do not already have Apache Ant installed, download the latest version and setup your environmental variables according to the manual If you are using Confluence 2.2.0 only, you will need to unzip the language plugin base files from languages.zip into a subdirectory of `<CONFLUENCE-INSTALL-DIRECTORY>` called `languages` ## Modifying The Example Language Pack Settings This example will work from an example plugin en_AU.zip. Unzip the example en_AU language pack en_AU.zip into a subdirectory of `<CONFLUENCE-INSTALL-DIRECTORY>/languages` called `en_AU.` Note that is the file is just a renamed copy of default English properties file We will now update the properties file in the example to the latest version. Open your Confluence install directory and copy the `confluence\WEB-INF\classes\com\atlassian\confluence\core\ConfluenceActionSupport.properties` file to the example plugin directory `src\etc\com\atlassian\confluence\core`. Remove the old `ConfluenceActionSupport_en_AU.properties` file, and rename `ConfluenceActionSupport.properties` to `ConfluenceActionSupport_en_AU.properties`. Locate the plugin descriptor file, ConfluenceActionSupport properies file and flag image
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/en_AU/src/etc/atlassian-plugin.xml
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/en_AU/src/etc/com/atlassian/confluence/core/ConfluenceActionSupport_en_AU.properties
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/en_AU/src/etc/templates/languages/en_AU/en_AU.png
8. Detemine your language plugin key <KEY> using your country and locale according to the Language Pack Plugins guide Atlassian has licensed a set of flags for use with translations. Delete en_AU.png and download the appropriate flag from Language Pack Flags, renaming it to the correct key Update `atlassian-plugin.xml` to contain the relevant <KEY> and other references, including image type. Refer to the first section from the above Language Pack Plugins for help on deciding what to modify Rename the directory structure and filenames that contain en-AU to your own <KEY>. The directory should now appear as
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/<KEY>/src/etc/atlassian-plugin.xml
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/<KEY>/src/etc/com/atlassian/confluence/core/ConfluenceActionSupport<KEY>.properties
       <CONFLUENCE-INSTALL-DIRECTORY>/languages/<KEY>/src/etc/templates/languages/<KEY>/<KEY>.png
9. You are now ready to build the plugin with the default English text to check that your setup is are correct. These next few steps deploy the default English version of the pack under your own language From the command line, go to `<CONFLUENCE-INSTALL-DIRECTORY>/languages` and execute
       ant -Dlanguage=<KEY> build
4. Copy `<CONFLUENCE-INSTALL-DIRECTORY>/plugins/<KEY>/dist/languages-<KEY>.jar` to `<CONFLUENCE-INSTALL-DIRECTORY>/confluence/WEB-INF/lib` Restart Confluence From your browser, login as an Administrator, then go to Administration -> Language and verify that you are able to select the translation ## Updating The Language Pack To collaborate on the translation process, you may wish to upload your translation to the Community Translations page. Repeat these instructions to test each iteration of your translation attempt. Unzip excelbundle0.9.zip to your local drive. Browse to your Confluence install and go to the `\confluence\WEB-INF\classes\com\atlassian\confluence\core` directory. Copy the `ConfluenceActionSupport.properties` file there into the `translation_tool` directory and rename it to `ConfluenceActionSupport_en.properties`. If you want to start a fresh translation, skip this step. To work from an existing translation, copy it into the `translation_tool` directory and remove any country variant from the filename, eg `ConfluenceActionSupport_ru_RU.properties` becomes `ConfluenceActionSupport_ru.properties`. Call the translation tool to create the spreadsheet file. For example, to create a Russian translation, open a terminal window in the `translation_tool` directory and call
       java -jar excelbundle.jar -export translation_ru.xls -l en,ru -r "%cd%"
6. 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_tool` directory and call
       java -jar excelbundle.jar -import translation_ru.xls -l ru -r "%cd%"
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. ## Building The Language Pack Plugin To build the new language pack plugin, execute Ant in the `confluence\src\etc\languages` directory:
    ant -Dlanguage=<LANGUAGE> build
A JAR will be created in the `languages/<LANGUAGE>/dist/` folder. ## Installation On A Confluence Server To install the translation in another instance of Confluence. Copy `languages-<KEY>.jar` into the `<CONFLUENCE-INSTALL-DIRECTORY>/confluence/WEB-INF/lib` of your target installation Restart Confluence From your browser, login as an Administrator, then go to Administration -> Language and select the translation ## Submitting A Translation (Optional) If you would like to share your completed translation with other Confluence users, you can upload it here. By providing Atlassian permission to bundle complete translations with the Confluence install you will soon be able to select your local language from the Confluence translations list under System Administration, without needing to package it as a plugin. Attachments: languages.zip (application/zip) en_AU.zip (application/zip)

Document generated by Confluence on Nov 05, 2009 23:34