doc/translations.txt

   1 ##      Instructions for helping translate text for Vidalia, TorButton
   2 ##      and TorCheck
   3 ##  ( More translation information for Tor related apps will accumulate here )
   4
   5 Our translations are handled in one of two places. The Tor Translation Portal
   6 handles all of the translations for Vidalia, Torbutton and TorCheck. The Tor
   7 website itself is currently handled by hand translations using subversion.
   8
   9 -------------------------------------------------------------------------
  10
  11 For the Tor website, you'll need a Tor SVN account.
  12 If you do not have one and you need one, please run this command with your
  13 desired username in place of 'USERNAME':
  14     htdigest -c passwd.tmp "Tor subversion repository" USERNAME
  15 and send us the contents of passwd.tmp.
  16
  17 -------------------------------------------------------------------------
  18
  19 For the Portal-based projects, all three check in their respective .po
  20 files into the following subversion urls:
  21
  22     https://tor-svn.freehaven.net/svn/translation/trunk/projects/torbutton
  23     https://tor-svn.freehaven.net/svn/translation/trunk/projects/torcheck
  24     https://svn.vidalia-project.net/svn/vidalia/trunk/src/vidalia/i18n/
  25
  26 The current pootle configuration is checked into subversion as well:
  27
  28     https://tor-svn.freehaven.net/svn/translation/trunk/pootle
  29
  30 TorCheck uses our translation portal to accept translations. Users use
  31 the portal to check in their changes.  To make use of the translations
  32 that users have commited to the translations/ subversion module, you'll
  33 need to ensure that you have a current checked out copy of TorCheck:
  34
  35     cd check/trunk/i18n/
  36     check/trunk/i18n$ svn up
  37
  38 You should see something like the following:
  39
  40     Fetching external item into 'pootle'
  41     External at revision 15300.
  42
  43     At revision 15300.
  44
  45 Now if you had changes, you'd simply want to move the newly updated .po files
  46 into the current stable directory.  Moving the .po files from
  47 'check/trunk/i18n/pootle/' into 'check/trunk/i18n' properly naming the files
  48 for their respective locale.
  49
  50 Here's an example of how to move all of the current pootle translations into
  51 the svn trunk area of TorCheck:
  52
  53     cd check/trunk/i18n/
  54     for locale in `ls -1 pootle/|grep -v template`;
  55     do
  56     mv -v pootle/$locale/TorCheck_$locale.po TorCheck_$locale.po;
  57     done
  58
  59 Now check the differences (ensure the output looks reasonable):
  60
  61     svn diff
  62
  63 Ensure that msgfmt has no errors:
  64
  65     msgfmt -C *.po
  66
  67 And finally check in the changes:
  68
  69     svn commit
  70
  71 Torbutton uses our translation portal to accept translations. Users use
  72 the portal to check in their changes.
  73 To make use of the translations that users have commited to the translations/
  74 subversion module, you'll need to ensure that you have a current checked out
  75 copy of Torbutton:
  76
  77     cd torbutton/trans_tools
  78     torbutton/trans_tools$ svn up
  79
  80 You should see something like the following:
  81
  82     Fetching external item into 'pootle'
  83     External at revision 15300.
  84
  85     At revision 15300.
  86
  87 Now if you had changes, you need to convert from .po and move
  88 the newly updated mozilla files into the current stable locale
  89 directory. First convert them with the 'mkmoz.sh' script and then
  90 moving the proper mozilla files from 'torbutton/trans_tools/moz/' into
  91 'torbutton/src/chrome/locale/' directory while properly naming the files
  92 for their respective locale.
  93
  94 Here's an example of how to move all of the current pootle translations into
  95 the svn trunk area of Torbutton:
  96
  97     cd torbutton/trans_tools
  98     ./mkmoz.sh
  99     for locale in `ls -1 moz/`;
 100     do
 101     mv -v moz/$locale/*.{rdf,dtd,properties} ../src/chrome/locale/$locale/;
 102     done
 103
 104 Now check the differences (ensure the output looks reasonable):
 105
 106     svn diff
 107
 108 And finally check in the changes:
 109
 110     svn commit
 111
 112 Vidalia uses our translation portal to accept translations. Users use the
 113 portal to check in their changes. No conversion or moving is required other
 114 than normal pootle usage.
 115