TRANSLATING

   1 How To Add a New Translation
   2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   3
   4 1. Clone the git://git.gnome.org/gimp-help-2 repository.
   5
   6 2. Open 'configure.ac' file in a text editor.
   7
   8 3. Got to this line:
   9
  10 ALL_LINGUAS="ca da de el en en_GB es fr it ja ko nl nn pt_BR ru zh_CN"
  11
  12 4. Add a two-letter or four-letter code for your language, e.g. 'ro' for
  13 Romanian or 'es_MX' for Spanish (Mexico). Save the file.
  14
  15 5. Run './autogen.sh' to generate a Makefile.
  16
  17 6. Run 'make po-LANG' to generate PO files for your language, where LANG
  18 is either the two-letter or four-letter code that you added.
  19
  20
  21 How To Translate
  22 ~~~~~~~~~~~~~~~~
  23
  24 Use any PO editor you prefer (poEdit, Gtranslator, Lokalize etc.) to open
  25 and translate PO files create at the previous step. Don't forget to fill
  26 in basic metadata like translator's name and email address.
  27
  28
  29 How To Test Translation
  30 ~~~~~~~~~~~~~~~~~~~~~~~
  31
  32 Run 'make html-LANG', where LANG is your two/four-letter language code,
  33 to generate HTML version of the user manual.
  34
  35
  36 How To Add Localized Screenshots
  37 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  38
  39 All images are stored in the top-level 'images' folder. Original
  40 screenshots in English are in the 'C' subfolder. Localized screenshots
  41 are in 'LANG' folders, where LANG is your two/four-letter language code.
  42
  43 It's important to preserve both paths and names when saving localized
  44 versions of the screenshots. Otherwise documentation won't build properly,
  45 if at all.
  46
  47
  48 How To Submit Translation
  49 ~~~~~~~~~~~~~~~~~~~~~~~~~
  50
  51 There are multiple ways to submit your translation depending on the access
  52 level you have for the Git repository.
  53
  54 If you cloned the Git repository anonymously, and you intend to either send
  55 the files to your GNOME i18n team or submit a patch to the bug tracker, do
  56 this:
  57
  58 1. Add all the files you created ('git add') and commit them ('git commit').
  59
  60 2. Run 'git pull --rebase' to sync your local copy to the main remote Git
  61 repository.
  62
  63 3. Run 'git format-patch origin/master' to generate Git-formatted patch
  64 (or patches).
  65
  66 4. Submit newly created files.
  67
  68 If you cloned the Git repository via SSH, it means you already have the
  69 access to push directly to the remote repository. Simply run add and commit
  70 all your changes, then run 'git push origin master'.