README.i18n

   1 This file contains some important hints for translators.
   2
   3
   4 The current status of the GIMP translation can be checked at
   5
   6   https://l10n.gnome.org/module/gimp
   7
   8
   9 Translation of the GNU Image Manipulation Program is handled by the
  10 GNOME Translation Project (see https://l10n.gnome.org/). If you want to
  11 help, we suggest that you get in touch with the translation team of
  12 your language (see https://l10n.gnome.org/teams/).
  13
  14
  15 GIMP is different
  16
  17  GIMP is a complex application which has a bunch of scripts and
  18  plug-ins that all want to be internationalized. Therefore there is
  19  not one catalog but many. For a full translation of GIMP's UI, you
  20  will have to add translations for the following catalogs:
  21
  22    po/gimp20.po                                       --  the core
  23    po-libgimp/gimp20-libgimp.pot                      --  the libgimp library
  24    po-plugins/gimp20-std-plugins.pot                  --  the C plug-ins
  25    po-python/gimp20-python.pot                        --  the pygimp plug-ins
  26    po-script-fu/gimp20-script-fu.pot                  --  the script-fu scripts
  27    po-tips/gimp20-tips.pot                            --  the startup tips
  28    po-windows-installer/gimp20-windows-installer.pot  --  the windows installer
  29
  30  If you are looking for the translations of gimp-perl, please note that
  31  gimp-perl has been moved into it's own git module called
  32  gimp-perl.
  33
  34
  35 GIMP Tips dialog
  36
  37  In addition to message catalogs GIMP provides a file with tips that
  38  are displayed in the Tips dialog. This file is in XML format and can
  39  be found in the tips directory. The english tips messages are
  40  extracted from gimp-tips.xml.in so translators can use the usual
  41  tools to create a <lang>.po file that holds the translations. All
  42  translations are then merged into gimp-tips.xml with language
  43  identifiers taken from the po filename.
  44
  45  GIMP needs to know what language it should select from gimp-tips.xml.
  46  Therefore, there's the special message "tips-locale:C" in the main
  47  message catalog that needs to be translated correctly. For a german
  48  translation of the tips this would look like this:
  49
  50  #: ../app/dialogs/tips-parser.c:188
  51  msgid "tips-locale:C"
  52  msgstr "tips-locale:de"
  53
  54
  55 Localization of third-party plug-ins
  56
  57  Third-party plug-ins (plug-ins that are not distributed with GIMP)
  58  can't have their messages in the gimp-std-plugins textdomain.  We
  59  have therefore provided a mechanism that allows plug-ins to install
  60  their own message catalogs and tell GIMP to bind to that
  61  textdomain. This is necessary so that GIMP can correctly translate
  62  the menu paths the plug-in registers. Basically the plug-in has to
  63  call gimp_plugin_domain_add() or gimp_domain_plugin_add_with_path()
  64  before it registers any functions. Have a look at the script-fu
  65  plug-in to see how this is done in detail.