switch build process from Qt to gettext translations
[quassel.git] / i18n / README.Translations
1 In order to create or update a translatable file, run the following command
2 in the directory i18n/:
3
4 ./update.sh xx
5
6 where xx is the two-letter language code according to ISO 639 (which,
7 if needed, may be suffixed by a country code according to ISO 3166).
8 Quassel will automatically load these translation files based on the
9 system locale. Examples for valid codes: de, en_US
10
11 You can open translation files with poedit for example and add/edit translated strings.
12
13 The *.po files can and should be kept in sync with the source code by running
14 update.sh regularly (existing translations won't be removed).
15
16 Qt itself does not use the *.po files, but a compact binary format (*.qm). 
17 These files will automatically be generated at build time. By default, all
18 languages will be built. To select languages, add -DLINGUAS="<languages>"
19 to your cmake call, where <languages> is a space-separated list of language
20 codes as explained above.
21
22 NOTE: You'll need lconvert installed with your Qt in order to generate
23       translation files. Some distributions don't package that tool;
24       in that case you won't get translations.
25