README.I18N

   1 Quick Guide for new translations
   2 --------------------------------
   3
   4 If you want to translate Geany into another language, please go to the
   5 language statistics page (see below) to see whether your desired
   6 language already exists. If it already exists, please read the
   7 "Notes for updating translations" section. Otherwise, get the SVN
   8 version of Geany, change to the po directory and start the new
   9 translation with:
  10
  11 $ msginit -l ll_CC -o ll.po -i geany.pot
  12
  13 Fill in ll with the language code and CC with the country code.
  14 For example, to translate Geany into Italian you would type:
  15
  16 $ msginit -l it_IT -o it.po -i geany.pot
  17
  18 This will create a file it.po. This file can be opened with a
  19 text editor (like Geany ;-)) or you can also use a graphical
  20 interface. I can suggest PoEdit (http://www.poedit.net/), but
  21 there are several other GUIs.
  22
  23 Make sure you add your language to the file po/LINGUAS.
  24 Just open the file with a text editor and add your code.
  25
  26 When you have finished editing the file, check the file with:
  27
  28 $ msgfmt -c --check-accelerators=_ it.po
  29
  30 Please take care of menu accelerators(strings containing a "_").
  31 The "_" character should also be in your translation. Additionally,
  32 it would be nice if these accelerators are not twice for two strings
  33 inside a dialog or sub menu.
  34
  35 You can also use intl_stats.sh, e.g. by running the following command
  36 in the top source directory of Geany:
  37
  38 $ po/intl_stats.sh -a it
  39
  40 This will print some information about the Italian translation
  41 and checks for menu accelerators.
  42
  43 Then send the file to Frank Lanitz and he will add the translation.
  44
  45 It is a good idea to write to Frank before you start or while translating,
  46 because he can give you some hints on translating and ensure that the
  47 translation is not already in progress.
  48
  49
  50 Notes for updating translations
  51 -------------------------------
  52
  53 If you want to update an existing translation, please contact Frank
  54 Lanitz. He is supervising all translation issues and will contact the
  55 maintainer of the translation you want to update to avoid any
  56 conflicts.
  57
  58 Some translation statistics can be found at:
  59 http://i18n.geany.org/
  60
  61
  62 I18n mailing list
  63 -----------------
  64
  65 There is also a mailing list dedicated to translation issues. Please
  66 visit http://www.geany.org/Support/MailingList for more information.
  67
  68
  69 Contact: Frank Lanitz <frank(at)frank(dot)uvena(dot)de>