[tor-commits] r24288: {translation} more text, some nitpicking, still work in progress (translation/trunk/documentation)

[Runa Sandvik]

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