TRANSLATORS

   1
   2 - Translation info -
   3 http://super-tux.sf.net/
   4
   5 Last update: June 7, 2004
   6
   7  == TRANSLATORS ==
   8
   9 1. Notes for Translators
  10 ~~~~~~~~~~~~~~~~~~~~~~~~
  11
  12 * If there isn't a good translation for some term (ie. fullscreen), you might consider
  13   to just keep it. It's better than making the user confused.
  14
  15 * In English, there is only one singular second person mode (You). If your language does
  16   have more than one - a personal and impersonal - remember that this is a game, so you
  17   should use the personal one. And if it is possible to ommit it in your language, it might
  18   be a good idea.
  19
  20 * Names like SuperTux, Tux, Penny and other game elements should not be translated. If you
  21   really think one of these to be a too strange word for your people, first inform us at
  22   our mailing list.
  23
  24 A couple of notes:
  25 * If somewhere in the game, after translating a string, it doesn't look well (bad
  26   aligment, overlaps other text...), let us know - will be fixed.
  27
  28 * Currently, only the game itself is translatable. Data files, like levels,
  29   credits, story... are not yet translatable.
  30
  31 All in all, translating lots of strings can be boring and time consuming, but it
  32 worths when lookins at the results ;-)
  33
  34 2. Programs to Aid Translation
  35 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36
  37  KBabel      - a long dated KDE program that has been maturing over the years, and it's
  38                really handy by now.
  39  (X)Emacs    - a commonly used program for translating with the respective plugin.
  40  QTranslator - made by Qt, has the advantage of running in several platforms.
  41  PO files are written in ASCII and are pretty intuitive, so they can be used by any text
  42  editor. But it would be wise to use a program made for that effect. If not possible,
  43  use a text editor with highlighting for PO files.
  44
  45
  46  If all of this is new to you, the translation file that you should use is the supertux.pot
  47  that is inside the po/ root folder. Rename it to your language (ie. Spanish - es.po) and
  48  then open it with an appropriate program.
  49  After translating the file, add an entry of your language to the LINGUAS file (ie. Spanish - es)
  50  and run 'make update-po'. Then a binary file will be created. In order to make SuperTux using
  51  it, you will have to install it ('make install').
  52
  53
  54  == DEVELOPERS ==
  55
  56 1. Translatable Strings
  57 ~~~~~~~~~~~~~~~~~~~~~~~
  58
  59  Output should not be translated, since their purpose is mainly for debugging.
  60  However, command description (ie. --help) should obviously be translated. Messages
  61  that give the user a solution for a problem, might be translatable, as well.
  62
  63  Parametars shouldn't also be translatable. It breaks scripting, besides advanced users,
  64  the ones that will make use of this, usually don't like it.
  65
  66
  67 The SuperTux Team