doc/HowtoTranslate

   1
   2 HOWTO: Translate
   3 ================
   4
   5 NOTES
   6
   7 If you are unsure where NomNom saves the config file, open the Preferences
   8 (Ctrl+E) and choose "Options". The same info is also available in the About
   9 dialog.
  10
  11   * You can set "qmShowPaths=true" in your config file to have NomNom dump
  12   the qm search paths. They are printed to stderr in addition to displayed
  13   in the "Select language" dialog.
  14
  15     [General]
  16     qmShowPaths=true
  17
  18   * You can add an additional qm search path by adding "qmPath=$path" to your
  19   config file, e.g.:
  20
  21     [General]
  22     qmPath=/path/to/my/qmfiles
  23
  24   * The "About" dialog HTML content (containing the version information, etc.)
  25   does not necessarily need to be translated, if you do however, consider
  26   leaving the GPL for <http://www.gnu.org/licenses/translations.html>
  27
  28
  29 CREATING NEW TRANSLATION
  30
  31 Checklist
  32
  33   1) Get the latest source code from <http://nomnom.sourceforge.net/>
  34
  35      - Please do not use the NomNom git repository code for this,
  36      the development code is a subject to frequent changes
  37
  38   2) Install the required Qt tools, e.g. lupdate, lrelease, linguist
  39
  40 Get started
  41
  42   1) cd to the top source code dir
  43
  44   2) Run "mkdir tmp; cd tmp; cmake ..; mkdir tr"
  45
  46   3) Run "lupdate src/ i/ -ts tr/nomnom_$locale.ts"
  47     e.g. "lupdate src/ i/ -ts tr/nomnom_fi.ts" # for Finnish
  48
  49   4) Edit (translate) the created tr/nomnom_$locale.ts file
  50     e.g. linguist tr/nomnom_$locale.ts
  51
  52 Test translation
  53
  54   5) Run "make && mv nomnom_$locale.qm tr/ && ./nomnom"
  55
  56   Or, copy the produced qm file to one of the following paths:
  57
  58     $config_qmPath
  59     `cwd`/tr
  60     ~/.config/nomnom/tr/
  61     ~/.local/share/nomnom/tr/
  62     $CMAKE_INSTALL_PREFIX/share/nomnom/tr/
  63
  64   Alternatively, use linguist (File / Release).
  65
  66   6) Run "./nomnom".
  67
  68     Skip if you have done this previously:
  69         - Open Preferences / Options
  70         - Click "Language..." and select the language
  71         - Restart NomNom
  72
  73     Check that everything looks as it should.
  74
  75   7) Repeat steps 4-6 until you are happy with the results.
  76
  77
  78 UPDATE EXISTING TRANSLATION
  79
  80 The existing strings may change sometimes. We are also constantly adding new
  81 ones as the project evolves. This means that the translations must be updated
  82 accordingly.
  83
  84 Checklist
  85   * See "CREATING NEW TRANSLATION" and "Checklist" above
  86
  87 Get started
  88
  89   1) cd to the top source code dir
  90
  91   2) Run "lupdate -no-obsolete src/ i/ -ts tr/nomnom_$locale.ts"
  92
  93 Test the updated translation
  94
  95   See the steps 4-7 under "CREATING NEW TRANSLATION" and "Test translation"
  96   above.
  97
  98
  99 SUBMIT TRANSLATION
 100
 101 We can add your translation at the upstream to the distribution.
 102 Open a new ticket to the Feature tracker at:
 103     <http://sourceforge.net/projects/nomnom/support/>
 104
 105 And submit your ts file.
 106 Thanks!
 107
 108