Author: mikeperry Date: 2011-03-21 09:52:09 +0000 (Mon, 21 Mar 2011) New Revision: 24399 Modified: translation/trunk/documentation/howto.txt Log: Update the translation howto.txt for torbutton. Modified: translation/trunk/documentation/howto.txt =================================================================== --- translation/trunk/documentation/howto.txt 2011-03-21 09:03:03 UTC (rev 24398) +++ translation/trunk/documentation/howto.txt 2011-03-21 09:52:09 UTC (rev 24399) @@ -309,27 +309,45 @@ Torbutton and Torbutton-alpha: - The Transifex configuration file, source file and translations can - be found here: - https://svn.torproject.org/svn/translation/trunk/projects/torbutton/ - and here: - https://svn.torproject.org/svn/translation/trunk/projects/torbutton-alpha/. + First, you must fetch the appropriate translation checkout for your build. - You will also need: https://gitweb.torproject.org/torbutton.git/. + If you are on branch master, building a Torbutton 1.3.x alpha build: + cd torbutton.git/trans_tools + svn co https://svn.torproject.org/svn/translation/trunk/projects/torbutton-alpha/po po - 1. Converting Translations to Mozilla Files + If you are on branch maint-1.2, building a Torbutton 1.2.x build: + cd torbutton.git/trans_tools + svn co https://svn.torproject.org/svn/translation/trunk/projects/torbutton/po po - # TODO: document how to convert translations to mozilla files. - - 2. Creating/Updating Translation Template Files + You should then run this command to pull the latest translations from + transifex: + cd po + tx pull -a + cd .. - 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: + You should then verify the new strings from transifex for XSS exploits: + ./validate_all.py | less - $ moz2po -P -i src/chrome/locale/en/ -o /path/to/po/templates + Be careful, the unicode will cause tons of false positives to drown out + actual issues. + If you made changes to strings in Torbutton, you need to rebuild + the templates in torbutton.git/trans_tools/pootle/templates. This + is done with the following command from within the + torbutton.git/trans_tools directory: + ./new_tb_strings.sh + + Then, regardless of whether or not you had changes in the + torbutton strings, you then need to regenerate the mozilla .dtd and + .properties files, especially if your svn checkout had new + translations from Transifex: + ./mkmoz.sh + ./mvmoz.sh + + After this, you can 'git diff' to review the changes, and then commit + them. + + Torcheck: The Transifex configuration file, source file and translations can