2.1 KiB

Raw Blame History

Translation contributions

Translators

For translators we have a Launchpad translations account where you can translate the .po files.

Marking text for translation

To mark text for translation in Python and ExtJS wrap the string with the function _() like this:

torrent.set_tracker_status(_("Announce OK"))

For GTK the text can also be marked translatable in the glade/*.ui files:

<property name="label" translatable="yes">Max Upload Speed:</property>

For more details see: Python Gettext

Translation process

These are the overall stages in gettext translation:

Portable Object Template -> Portable Object -> Machine Object

The deluge.pot is created using generate_pot.py.
Upload deluge/i18n/deluge.pot to Launchpad translations.
Give the translators time to translate the text.
Download the updated .po files from translation site.
Extract to deluge/i18n/ and strip the deluge- prefix:
```
 rename -f 's/^deluge-//' deluge-*.po
```
The binary MO files for each language are generated by setup.py using the msgfmt.py script.

To enable Web UI to use translations update gettext.js by running gen_gettext.py script.

Useful applications

podiff - Compare textual information in two PO files
gtranslator - GUI PO file editor
Poedit - GUI PO file editor

Testing translation

Testing that translations are working correctly can be performed by running Deluge as follows.

Create an MO for a single language in the correct sub-directory:

mkdir -p deluge/i18n/fr/LC_MESSAGES
python msgfmt.py -o deluge/i18n/fr/LC_MESSAGES/deluge.mo deluge/i18n/fr.po

Run Deluge using an alternative language:

LANGUAGE=fr deluge
LANGUAGE=ru_RU.UTF-8 deluge

Note: If you do not have a particular language installed on your system it will only translate based on the MO files for Deluge so some GTK text/button strings will remain in English.

2.1 KiB Raw Blame History