Fix operator for unmaintained translations conditions
[clawsker.git] / po / README
1
2 Translating Clawsker - A Claws Mail Tweaker
3 -------------------------------------------
4
5 If you want to contribute a translation or update send it directly to
6 me: ricardo@mones.org
7
8 If you have questions or just want to get in touch with other
9 translators of the project you can subscribe to the Claws Mail
10 translators' mailing list:
11
12 http://lists.claws-mail.org/cgi-bin/mailman/listinfo/translators
13
14 Calls for translation updates before a new release are also sent to
15 this list.
16
17 New translations
18 ~~~~~~~~~~~~~~~~
19
20 To create a new translation just change to 'po' directory, copy the
21 'clawsker.pot' file into 'xx.po' or 'xx_YY.po', and fill the empty
22 strings and placeholder values (strings in CAPS). See how is done
23 in other translations for example.
24
25 The pot file can be obtained from a git clone or a release tarball.
26 The pot file in git it's only updated when a new release is near,
27 therefore, you may need to update it manually to get all the
28 translatable strings. Use 'make update-pot' for updating it before
29 copying to your language po file.
30
31 The 'xx' is your language code (e.g.: 'en' for English, 'fr' for
32 French, etc.) and, optionally, 'YY' defines your country variant
33 (e.g.: 'de_CH' for German variant in Switzerland).
34
35 Country should be used only if your translation is really specific to
36 that location, otherwise, and specially for new languages, try use the
37 generic language (you can always submit a specific one later).
38
39 Updating existing translation
40 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41
42 To update an existing translation just type 'make xx.pox' or 'make
43 xx_YY.pox' to merge changes in pot file.
44
45 Update the new .pox file created and copy the .pox file into
46 the .po file.
47
48 If you intend to update a translation made by other and it has been
49 recently updated it's probably a good idea to contact first with last
50 translator.
51
52 Testing a translation
53 ~~~~~~~~~~~~~~~~~~~~~
54
55 Once finished the new translation or the update you should test your
56 translation.
57
58 New translations need adding your 'xx' or 'xx_YY' code to the LINGUAS
59 variable in Makefile. Existing translation already have it.
60
61 Then type 'make'. A new .mo file with the same name of your .po file
62 should be created if everything is right.
63
64 Translations not maintained
65 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
66
67 If a translation is not updated for several releases or the number of
68 translated strings drops below certain level it will be moved to the
69 directory 'po/unmaint'. Check there before making a new translation.
70
71 These translations will be also included in release tarballs but won't
72 be built or installed.