trunk/i18n/README

   1 This directory contains the internationalization package for OpenXPKI.
   2
   3 Usage notes:
   4
   5 Invocation
   6
   7 make scan
   8   will skim through the source code, collect all I18N identifiers and
   9   write them out to the message catalog openxpki.pot
  10
  11 make
  12   rebuilds the machine translations (.mo files)
  13
  14
  15 Customizing messages
  16
  17 OpenXPKI ships with a default set of translations (LANG/openxpki.po). This
  18 catalog will naturally change as the project evolves.
  19
  20 If you need to modify or add translations (e. g. you do not like the
  21 default translation or you have extended the system in a way that it
  22 uses additional I18N tags) it is recommended not to modify openxpki.po,
  23 because keeping up with changes in the project will become difficult for
  24 you.
  25
  26 Instead you should generate a file <LANG>/openxpki.po.local (same format
  27 as the normal .po file) in which you specifically include all additional
  28 translations and all translations you would like to override.
  29
  30 If such a file is detected by the 'make' operation, it will include
  31 your local changes in the machine translation file. (We do not ship
  32 a sample file under version control in order to allow you to have
  33 a local file that will not be overwritten by subsequent checkouts.)
  34