User Guidelines - Localisation - Pootle

The ​Sahana Pootle Server is a tool to assist with translations. If you have any queries or need permission, please contact the MailingList.

Instructions in Spanish:

• Como colaborar en la traduccion de Sahana al español mini-howto v0.2.doc

Below is an example based on how the Taiwan team uses ​Sahana Pootle Server in the language translation process. In the following example, zh-tw.py is used, but the main idea should apply to other teams.

There are two main roles:

1. Translator who focuses on text translation. This role doesn't need technical ability.
2. Administrator who converts updated .po to .py, and makes it works in eden/languages directory. If you are an Administrator, be sure to see the useful UserGuidelinesLocalisation before using Pootle or other translation tools.

Translate Text

1. Select the project (typically "Sahana Eden") and the language you wish to translate into.

2. To translate a term, either:
   1. Search for a term eg. "Required Field".

2. Click on the Translate Tab and select Quick Translate or Translate All.

3. Put the translation in the field below the term. You can submit the translation, or assign it as a suggestion.

4. If there are other terms matching the translated text, eg. "Required Field", they will be shown afterward.

Apply a Translated Language to Sahana Eden

1. Select the project "Sahana Eden" and the language you wish to apply the translation for.

2. Go to "Translate" tab.

3. Download the language .po (eg. zh-tw.pyo)file by clicking on the "Download" link. You may have save the page that opens.

4. Run "po2web2py -i zh-tw.po -o zh-tw.py" to generate the needed language file.

5. Place the generated zh-tw.py in the eden/languages directory.

6. Edit deployment_settings.L10n.languages in models/000_config.py

Check Administrator Settings

Administrator can manage translation team members, including adding members and assigning their permissions.

Update the Language File in Pootle

Administrator Only

A common case is that you have a new zh-tw.py in languages directory, and want to upload it to pootle. This zh-tw.py file can turn into zh-tw.po running "web2py2po -i zh-tw.py -o zh-tw.po". See: User Guidelines Localisation

marr's note: in my experience, with the above generated zh-tw.po file, you might see all msgstr filled with strings automatically, and uploading such file to pootle will mislead the statistics.

1. Select the project "Sahana Eden" and the language you wish to apply the translation for.

2. Go to "Translate" tab.

3. Choose the .po file to upload. Say, you can "Overwrite the current file if it exists".

4. If choosing "Add all new translations as suggestions", or, there are suggestions for a term, you can decide "Accept" or "Reject" them.

Add a New Language to Pootle

Administrator Only

1. Admin (top right) -> Languages. Add Language (to Pootle).
2. Select Project ("Sahana Eden") -> Administrate. Add Language (to Project).
3. Select Project ("Sahana Eden") -> <New Language>. Upload *.po file. See: User Guidelines Localisation