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.