Confluence 2.6 has reached end of life
Check out the [latest version] of the documentation
Text in Confluence plugins can be internationalised to cater for a variety of locales or languages. To do this, you will need to create a translated copy of the properties file(s) for each plugin and bundle these inside your language pack plugin. Having a properties file in each plugin allows plugin authors to provide internationalised plugins without having to add their i18n keys to Confluence's core source.
Confluence comes bundled with a few plugins that are stored in a file called atlassian-bundled-plugins.zip. The basic process for translating a plugin is:
- Extract this zip to a directory
- Extract the plugin JAR
- Locate the properties file which contains i18n keys (examples are below)
- Copy this file to the same location in your plugin. For example, if it is in path/to/file.properties, it needs to be in the same place in your language pack JAR with a locale extension: path/to/file_jp_JP.properties
- Repeat this for all plugins that can be internationalised
Below are the bundled plugins that can be internationalised and the properties file you will need to translate:
Plugin Name |
Filename |
I18N Resources |
|---|---|---|
Usage Statistics Plugin |
usage-tracking-plugin-<version>.jar |
resources/stats/usage.properties |
Atlassian Plugin Repository |
atlassian-plugin-repository-confluence-plugin-<version>.jar |
com/atlassian/plugin/repository/i18n.properties |
Clickr Theme |
clickr-theme-plugin-<version>.jar |
clickr.properties |
Mail Page Plugin |
mail-page-plugin-<version>.jar |
resources/mailpage.properties |
Below are the system plugins (found in confluence/WEB-INF/lib/) that can be internationalised and the properties file you will need to translate:
Plugin Name |
Filename |
I18N Resources |
|---|---|---|
Information Plugin |
confluence-information-plugin-<version>.jar |
information.properties |
Layout Plugin |
confluence-layout-plugin-<version>.jar |
layout.properties |
Livesearch Plugin |
confluence-livesearch-plugin-<version>.jar |
livesearch.properties |
Dynamic Tasklist Plugin |
confluence-dynamictasklist-plugin-<version>.jar |
dynamictasklist.properties |
There is a request in JIRA TRANS-38 to implement IN8 support for the Clickr Theme http://jira.atlassian.com/browse/TRANS-38
