Adding a new language

Adding a new language

There are two processes to add a new language, depending on if you want to submit an initial translation file (ApplicationResources) or if you want to start from scratch directly on l10n.xwiki.org.

Submit an ApplicationResources file (this only works for XE right now)

For this you need to:

1. Download the ApplicationResources file in english language. It's here for XE: http://svn.xwiki.org/svnroot/xwiki/platform/core/trunk/xwiki-core/src/main/resources/ApplicationResources.properties
2. Translate it. Beware that you need to use special encoding for non ASCII chars. You might want to lookup on the internet for tools to help you out for this, see Native2Ascii for example.
3. Create a JIRA issue on http://jira.xwiki.org and ask our team to commiters to commit it.

Once it's commited there the xwiki.org team will very probably do the following steps:

1. Edit the main page of the application. For XE use: /xwiki/bin/inline/XE/WebHome.
2. Add to the list of translation the language code at the end of the list of available languages ( ,fr for French).
   The language code is the standard format use in JAVA which mean <language code>_<CONTRY CODE>.
3. Save.
4. Visit the resource page that you want to translate (/xwiki/bin/view/XE/XWikiCoreResources for the main resource file for XE).
5. Your language should be listed at the bottom. In the "Admin Actions" column click "Import".
6. It should take a while and import the existing keys from the commited ApplicationResources file.
7. Now it should also list the number of keys to translate. It should not be a lot since you translated all the initial file :)
8. You can start translating the missing ones by clicking on "View empty".
9. [nice to have] Add the corresponding flag on Flags
10. [nice to have] Add the corresponding pretty name on LocaleTranslations

Start from scratch on l10n.xwiki.org

For this you need to:

1. Edit the main page of the application. For XE use: /xwiki/bin/inline/XE/WebHome.
2. Add to the list of translation the language code at the end of the list of available languages ( ,fr for French). 
3. Save.
4. Visit the resource page that you want to translate (/xwiki/bin/view/XE/XWikiCoreResources for the main resource file for XE).
5. Your language should be listed at the bottom. In the "Admin Actions" column click "Prepare".
6. It should take a while and now list the number of keys to translate. It's going to be a lot since you are starting from scratch. 
7. You can start translating by clicking on "View empty".