Author: runa Date: 2011-03-02 16:43:14 +0000 (Wed, 02 Mar 2011) New Revision: 24288 Modified: translation/trunk/documentation/howto.txt Log: more text, some nitpicking, still work in progress Modified: translation/trunk/documentation/howto.txt =================================================================== --- translation/trunk/documentation/howto.txt 2011-03-02 15:46:57 UTC (rev 24287) +++ translation/trunk/documentation/howto.txt 2011-03-02 16:43:14 UTC (rev 24288) @@ -1,16 +1,16 @@ # This file documents the translation process for all projects # currently available in the Tor translation portal: # -# *. BridgeDB -# *. GetTor -# *. Vidalia Help Files -# *. Vidalia Installer -# *. Vidalia -# *. Orbot -# *. Torbutton-alpha -# *. Torbutton -# *. Torcheck -# *. The Website +# * BridgeDB +# * GetTor +# * Vidalia Help Files +# * Vidalia Installer +# * Vidalia +# * Orbot +# * Torbutton-alpha +# * Torbutton +# * Torcheck +# * The Website # * Tor Manual Pages # # ( More translation information for Tor related apps and documentation @@ -235,8 +235,8 @@ 5. Pushing Files to the Transifex Server - To push new/updated source files or translations to the Transifex, - simply run 'tx push' with either '-s' or '-t'. + To push new/updated source files or translations to the Transifex + server, simply run 'tx push' with either '-s' or '-t'. Vidalia: @@ -266,7 +266,7 @@ 5. Pushing Files to the Transifex Server To push new/updated source files or translations to the - Transifex, simply run 'tx push' with either '-s' or '-t'. + Transifex server, simply run 'tx push' with either '-s' or '-t'. Orbot: @@ -314,7 +314,7 @@ 5. Pushing Files to the Transifex Server To push new/updated source files or translations to the - Transifex, simply run 'tx push' with either '-s' or '-t'. + Transifex server, simply run 'tx push' with either '-s' or '-t'. Torbutton and Torbutton-alpha: @@ -324,15 +324,71 @@ and here: https://svn.torproject.org/svn/translation/trunk/projects/torbutton-alpha/. + You will also need: https://gitweb.torproject.org/torbutton.git/. + 1. Pulling Translations from the Transifex Server - To pull new translations from the server, run 'tx pull'. Remember - to commit the changes to SVN. + To pull new translations from the server, cd to the 'po' + directory and run 'tx pull'. Remember to commit the changes to + SVN. + 2. Converting Translations to Mozilla Files + # TODO: document how to convert translations to mozilla files. + + 3. Creating/Updating Translation Template Files + If you made changes to strings in Torbutton, you need to rebuild + the templates in the 'po/templates' directory. This is done with + the following command from within the torbutton.git checkout + directory: + $ moz2po -P -i src/chrome/locale/en/ -o /path/to/po/templates + 4. Adding New Translation Resources to Transifex + + To add new translation resources to Transifex, open up + 'po/.tx/config' and create entries for the new resources. Use an + existing entry as a template. Remember to commit the file to SVN. + + 5. Pushing Files to the Transifex Server + + To push new/updated source files or translations to the Transifex + server, cd to the 'po' directory and run 'tx push' with either + '-s' or '-t'. + +Torcheck: + + The Transifex configuration file, source file and translations can + be found here: + https://svn.torproject.org/svn/translation/trunk/projects/torcheck/. + + 1. Pulling Translations from the Transifex Server + + To pull new translations from the server, cd to the 'po' + directory and run 'tx pull'. Remember to commit the changes to + SVN. + + 2. Converting Translations to + + # TODO: document how to convert translations to a useful format. + + 3. Creating/Updating Translation Template Files + + # TODO: document this as well + + 4. Adding New Translation Resources to Transifex + + To add new translation resources to Transifex, open up + 'po/.tx/config' and create entries for the new resources. Use an + existing entry as a template. Remember to commit the file to SVN. + + 5. Pushing Files to the Transifex Server + + To push new/updated source files or translations to the Transifex + server, cd to the 'po' directory and run 'tx push' with either + '-s' or '-t'. + ---------------------------- TorCheck ------------------------------- TorCheck uses our translation portal to accept translations. Users use