tor-webwml.git

@@ -34,9 +34,10 @@ documentation</a></li>

 <hr />

 <p>

-The <a href="https://translation.torproject.org/">Tor Translation Portal</a> is

-a system which lists all sentences in use in a particular project, and allows

-interested volunteers to translate individual

+The <a href="https://translation.torproject.org/">Tor Translation Portal</a>

+is a website that lists all sentences or phrases (called "strings") used

+by a particular project, and allows interested volunteers to translate

+individual

 sentences or phrases as they are able.

 </p>

@@ -117,17 +118,18 @@ You're ready to translate!

 </p>

 <p>

-At this point, you'll want to select a project, such as <a

+At this point, you can select a project, such as <a

 href="https://translation.torproject.org/projects/vidalia/">Vidalia</a>. You'll

 see a nice list of all of the currently supported languages along with the

-current translation progress. Select a language, in our example, you'll click

+current translation progress. Select a language — in our example,

+you'll click

 <a href="https://translation.torproject.org/de/vidalia/">German</a>. The next

 page should show you a single row of data for the file "<a

-href='https://translation.torproject.org/de/vidalia/vidalia.po?translate=1&view=1'>vidalia.po</a>".

+href='https://translation.torproject.org/de/vidalia/vidalia.po?translate=1&view=1'>vidalia_de.po</a>".

 This is the file with all of the currently translated German strings for

-Vidalia. You'll want to click on the "<a

+Vidalia. You should click on the "<a

 href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show

-Editing Functions</a>" link above the 'vidalia.po' row. Next you'll want to

+Editing Functions</a>" link above the 'vidalia_de.po' row. Next you should

 click the "<a

 href='https://translation.torproject.org/de/vidalia/translate.html?fuzzy=1&editing=1&blank=1'>Quick

 Translate</a>" link. This will take you to the first untranslated string in the

@@ -142,10 +144,10 @@ anything.

 </p>

 <p>

-When you're finished, you'll want to commit your changes by returning to the

+When you're finished, you need to commit your changes. Return to the

 page with the <a

 href="https://translation.torproject.org/de/vidalia/index.html?editing=1">Editing

-Functions</a>. You'll want to click on the "<a

+Functions</a>, and click on the "<a

 href='https://translation.torproject.org/de/vidalia/index.html?editing=1&docommit=1&commitfile=vidalia.po'>Commit</a>"

 link. This will commit your changes into the <a

 href="https://tor-svn.freehaven.net/svn/translation/trunk/projects/vidalia/de/">Translation

@@ -153,6 +155,10 @@ subversion module</a> in the specific area as specified by your choices of

 language and project (Vidalia and German, for this example).

 </p>

+<p>

+That's all there is to it!

+</p>

+

 <p>

 For more advanced users who like to translate without a web browser, you can

 also download the .po file directly. You'll find this option after clicking on

@@ -160,14 +166,15 @@ the "<a

 href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show

 Editing Functions</a>" link. You should see a link to download the <a

 href="https://translation.torproject.org/de/vidalia/vidalia.po">PO file</a>. If

-this option fits your working habits, by all means, please use it! When you're

-finished translating the .po file, you can upload it by using the "upload file"

-form in the upper right hand corner, simply select the file and click the

-'Upload file' button. 

-</p>

-

-<p>

-That's all there is to it!

+this option fits your working habits, by all means, please use it!

+You may find a program called <a href="http://www.poedit.net/">Poedit</a>

+to make the job easier, especially for right-to-left languages that don't

+work as well in text editors. If you're using Poedit, you should disable

+compiling .mo files in Poedit's preferences (File -> Preferences ->

+Editor -> Behavior, uncheck "Automatically compile .mo file on save").

+When you're finished translating the .po file, you can upload it by

+using the "upload file" form in the upper right hand corner: simply

+select the file and click the 'Upload file' button.

 </p>

 <a id="TranslatingVidalia"></a>