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 http://lists.claws-mail.org/cgi-bin/mailman/listinfo/translators
  12
  13 New translations
  14 ~~~~~~~~~~~~~~~~
  15
  16 To create a new translation just change to 'po' directory, copy the
  17 'clawsker.pot' file into 'xx.po' or 'xx_YY.po', and fill the empty
  18 strings and placeholder values (strings in CAPS). See how is done
  19 in other translations for example.
  20
  21 The pot file can be obtained from a git clone or a release tarball.
  22
  23 The 'xx' is your language code (e.g.: 'en' for English, 'fr' for
  24 French, etc.) and, optionally, 'YY' defines your country variant
  25 (e.g.: 'de_CH' for German variant in Switzerland).
  26
  27 Country should be used only if your translation is really specific to
  28 that location, otherwise, and specially for new languages, try use the
  29 generic language (you can always submit a specific one later).
  30
  31 Updating existing translation
  32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33
  34 To update an existing translation just type 'make xx.pox' or 'make
  35 xx_YY.pox' to merge changes in pot file.
  36
  37 Update the new .pox file created and copy the .pox file into
  38 the .po file.
  39
  40 If you intend to update a translation made by other and it has been
  41 recently updated it's probably a good idea to contact first with last
  42 translator.
  43
  44 Testing a translation
  45 ~~~~~~~~~~~~~~~~~~~~~
  46
  47 Once finished the new translation or the update you should test your
  48 translation.
  49
  50 New translations need adding your 'xx' or 'xx_YY' code to the LINGUAS
  51 variable in Makefile. Existing translation already have it.
  52
  53 Then type 'make'. A new .mo file with the same name of your .po file
  54 should be created if everything is right.
  55
  56 Translations not maintained
  57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58
  59 If a translation is not updated in several releases and the number of
  60 translated strings drops below certain level it will be moved to the
  61 directory 'po/unmaint'. Check there before making a new translation.
  62
  63 These translations will be also included in release tarballs but won't
  64 be built or installed.