44cdf24560391679148591498f4c23bca33dfaa2
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

1) ## translation metadata
2) # Revision: $Revision: 13774 $
3) 
4) #include "head.wmi" TITLE="Tor: Translation Portal"
5) 
6) <div class="main-column">
7) 
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

8) <h1>Tor: Translation Portal</h1>
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

9) <hr />
10) 
11) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

12) Effective use of Tor is made possible by an ecosystem of software.
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

13) Many different parts of this ecosystem need translation help:
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

14) Our <a href="https://translation.torproject.org/">Translation Portal</a> will suit most translators best.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

15) </p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

16) <ul>
17) <li><a href="#TranslatingTor">Translating the Tor website and
18) documentation</a></li>
19) <li><a href="#TranslatingVidalia">Translating Vidalia</a></li>
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

20) <li><a href="#TTPVidalia">Tor Translation Portal walkthrough with Vidalia</a></li>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

21) <li><a href="#TranslatingTorbutton">Translating Torbutton</a></li>
22) <li><a href="#TranslatingTorCheck">Translating Torcheck</a></li>
23) </ul>
Roger Dingledine streamline the header names

Roger Dingledine authored 16 years ago

24) 
25) <a id="TranslatingTor"></a>
26) <h2><a class="anchor" href="#TranslatingTor">Translating the
27) Tor website and documentation</a></h2>
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

28) <hr />
29) 
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

30) # XXX We should move this section to the bottom, since for
31) # now Pootle is the far easier thing to tackle. wml editing is
32) # really still only for experts (meaning folks with text editors)
33) # until we can fold it into Pootle too. So in fact the guidelines
34) # at the tor translation page are not useful for most of our
35) # translators. -RD
36) 
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

37) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

38) We've written some basic guidelines to help you translate
39) the Tor website and documentation on our <a href="<page translation>">main
40) translation page</a>. The guidelines there also provide good advice for
41) the other translation items on this page.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

42) </p>
43) 
44) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

45) In addition to the main Tor website and Tor documentation, there are currently
46) other projects in need of translation help. In order of importance they
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

47) are: Vidalia, TorButton and TorCheck. Please read the sections that interest
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

48) you and if you need help, please ask &mdash; we're always happy to lend a hand.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

49) </p>
50) 
Roger Dingledine streamline the header names

Roger Dingledine authored 16 years ago

51) <a id="TranslatingVidalia"></a>
52) <h2><a class="anchor" href="#TranslatingVidalia">Translating
53) Vidalia</a></h2>
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

54) <hr />
55) 
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

56) # XXX We should get rid of this section, or at least move it under
57) # the Pootle walk-through and remove all the redundant pieces. -RD
58) 
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

59) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

60) Getting started with <a href="http://www.vidalia-project.net/">Vidalia</a>
61) translations is easy. We're working on making it easier daily.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

62) </p>
63) 
64) <p>
65) It's best to start by reading the general Vidalia
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

66) <a href="http://trac.vidalia-project.net/wiki/Translations">translation
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

67) overview page on the Vidalia wiki</a>.
68) </p>
69) 
70) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

71) Vidalia has three key areas in need of translation. The first area is the
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

72) Vidalia GUI itself, the second is the Win32 installer, and then third is
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

73) localized help documentation.
74) </p>
75) 
76) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

77) <b>The main Vidalia program</b> (the GUI itself) needs to be translated.
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

78) Please visit the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

79) href="https://translation.torproject.org/projects/vidalia/">Tor Translation
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

80) Portal page for Vidalia</a>.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

81) </p>
82) 
83) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

84) For more advanced users, translation of Vidalia can be handled in subversion.
85) You're welcome to
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

86) <a href="https://svn.torproject.org/svn/translation/trunk/projects/vidalia/">check
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

87) the current translation files</a>, and find a locale that
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

88) <a href="https://translation.torproject.org/projects/vidalia/">
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

89) requires further translation</a> or
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

90) <a href="http://trac.vidalia-project.net/wiki/Translations#NewGUITranslation">
91) start a translation</a> that we don't have.
92) </p>
93) 
94) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

95) Regardless of your choice between the two methods, you can translate with the
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

96) Tor Translation Portal service and/or with files directly from subversion.
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

97) The process isn't as important as the final product, so you should use
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

98) the method that best suits your working style. We think that the Tor
Jacob Appelbaum suite is not suit.

Jacob Appelbaum authored 16 years ago

99) Translation Portal will suit most users best.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

100) </p>
101) 
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

102) <p>
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

103) The <b>Win32 installer</b> uses the NSI format and is found in the Vidalia subversion
104) repository. The NSI format is very similar to normal gettext templates.
105) The file format is quite simple. Essentially, it is text with the corresponding
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

106) translations. This is a good place to get your feet wet with localization.
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

107) You'll only need a text editor and knowledge of two languages, English and
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

108) whatever locale you'll be translating the original English into.
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

109) You can download the NSI localization files from the Vidalia subversion
110) repository. For more information on translating the Win32
111) installer, please see the corresponding instructional
112) <a href="http://trac.vidalia-project.net/wiki/Translations#TranslateInstallers">
113) page on the Vidalia wiki</a>. It's a useful page that explains step by step
114) information for translation, encoding and submission for inclusion in the next
115) release. You'll also notice that the wiki page lists translators - we're
Jacob Appelbaum Updates to the layout of th...

Jacob Appelbaum authored 16 years ago

116) especially in need of Farsi and Hebrew translators. Perhaps you're the one?
117) </p>
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

118) 
119) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

120) Last but certainly not least, Vidalia requires diligent
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

121) <a href="http://trac.vidalia-project.net/wiki/Translations#AvailableHelpTranslations">
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

122) translation of its <b>help documents</b></a>. This is important to ensure that users
123) fully understand the choices that they make and so they understand
124) the choices the software makes on their behalf. We're currently looking
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

125) for German and Bulgarian translators; perhaps you're the right person for the job?
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

126) </p>
127) 
Jacob Appelbaum Fix anchor link.

Jacob Appelbaum authored 16 years ago

128) <a id="TTPVidalia"></a>
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

129) <h2>
130) <a class="anchor" href="#TTPVidalia">Translating Vidalia with the Tor Translation Portal</a></h2>
131) <hr />
132) 
133) <p>
Jacob Appelbaum Minor fix.

Jacob Appelbaum authored 16 years ago

134) The Tor Translation Portal is a system which lists all sentences in use in a
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

135) particular project, and allows interested volunteers to translate individual
136) strings as they are able.
137) </p>
138) 
139) <p>
140) You can check the status of all translations for a given project by visiting
141) each project page.  The following statuses are updated in real time when new
142) translations are added:
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

143) <a href="https://translation.torproject.org/projects/torbutton/">Torbutton</a>,
144) <a href="https://translation.torproject.org/projects/torcheck/">TorCheck</a> and
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

145) of course <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

146) href="https://translation.torproject.org/projects/vidalia/">Vidalia</a>. The
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

147) current status of the website translations can be found on our <a
148) href="https://www.torproject.org/translation-status.html">website translation
149) status page</a>.
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

150) # XXX the above sentence is out of place here. shouldn't it be in the
151) # 'tor page translator' section? -RD
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

152) </p>
153) 
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

154) <p>
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

155) To get started using our translation website, you need to sign up for an
156) account. Visit the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

157) href="https://translation.torproject.org/register.html">account registration
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

158) page</a> to get started. Be sure to enter a proper email address and a strong
159) password. After you fill in the form and use the 'Register Account' button, you
160) should see some text indicating that things worked out: 
161) <pre>
162) Account created. You will be emailed login details and an activation code.
163) Please enter your activation code on the activation page.
164) </pre>
165) </p>
166) 
167) <p>
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

168) Shortly after you see this text an email will be sent to the email address you
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

169) provided. The email should look something like the following:
170) <pre>
171) A Pootle account has been created for you using this email address.
172) Your activation code is:
173) 36074ec543c1fa23ceeaf8e187dfa43e
174) This message is sent to verify that the email address is in fact correct. If
175) you did not want to register an account, you may simply ignore the message.
176) Your user name is: example_user
177) Your password is: example_user
178) Your registered email address is: username@example.com
179) </pre>
180) </p>
181) 
182) <p>
183) Once you've received the email, you'll need to activate your account by
184) visiting the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

185) href="https://translation.torproject.org/activate.html">activation page</a>.
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

186) Enter your username and activation code into the form and then submit the form
187) by pressing the "Activate Account" button.
188) 
189) You'll see a message that says:
190) <pre>
191) Redirecting to login Page...
192) Your account has been activated! Redirecting to login...
193) </pre>
194) </p>
195) 
196) <p>
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

197) When you login to your new account, you'll be prompted to configure your basic
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

198) language preferences on the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

199) href="https://translation.torproject.org/home/options.html">options page</a>. At
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

200) the very least, you'll want to select the user interface language, select any
Roger Dingledine some notes on how to make t...

Roger Dingledine authored 16 years ago

201) of the projects you're interested in translating, and additionally the languages
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

202) you wish to translate. Save your changes by clicking the "Save Changes" button
203) when you're finished.
204) </p>
205) 
206) <p>
207) You're ready to translate!
208) </p>
209) 
210) <p>
211) At this point, you'll want to select a project, such as <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

212) href="https://translation.torproject.org/projects/vidalia/">Vidalia</a>. You'll
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

213) see a nice list of all of the currently supported languages along with the
214) current translation progress. Select a language, in our example, you'll click
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

215) <a href="https://translation.torproject.org/de/vidalia/">German</a>. The next
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

216) page should show you a single row of data for the file "<a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

217) href='https://translation.torproject.org/de/vidalia/vidalia.po?translate=1&view=1'>vidalia.po</a>".
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

218) This is the file with all of the currently translated German strings for
219) Vidalia. You'll want to click on the "<a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

220) href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

221) Editing Functions</a>" link above the 'vidalia.po' row. Next you'll want to
222) click the "<a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

223) href='https://translation.torproject.org/de/vidalia/translate.html?fuzzy=1&editing=1&blank=1'>Quick
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

224) Translate</a>" link. This will take you to the first untranslated string in the
225) language group for the current project.
226) </p>
227) 
228) <p>
229) If you're able, please translate the string you see and click the 'Submit'
230) button. If you're unsure, click the 'Suggest' button. Feel free to leave
231) comments for any of the translations if you feel it's important to clarify
232) anything.
233) </p>
234) 
235) <p>
236) When you're finished, you'll want to commit your changes by returning to the
237) page with the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

238) href="https://translation.torproject.org/de/vidalia/index.html?editing=1">Editing
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

239) Functions</a>. You'll want to click on the "<a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

240) href='https://translation.torproject.org/de/vidalia/index.html?editing=1&docommit=1&commitfile=vidalia.po'>Commit</a>"
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

241) link. This will commit your changes into the <a
242) href="https://tor-svn.freehaven.net/svn/translation/trunk/projects/vidalia/de/">Translation
243) subversion module</a> in the specific area as specified by your choices of
244) language and project (Vidalia and German, for this example).
245) </p>
246) 
247) <p>
248) For more advanced users who like to translate without a web browser, you can
249) also download the .po file directly. You'll find this option after clicking on
250) the "<a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

251) href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

252) Editing Functions</a>" link. You should see a link to download the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

253) href="https://translation.torproject.org/de/vidalia/vidalia.po">PO file</a>. If
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

254) this option fits your working habits, by all means, please use it! When you're
255) finished translating the .po file, you can upload it by using the "upload file"
256) form in the upper right hand corner, simply select the file and click the
257) 'Upload file' button. 
258) </p>
259) 
260) <p>
261) That's all there is to it!
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

262) </p>
263) 
Roger Dingledine streamline the header names

Roger Dingledine authored 16 years ago

264) <a id="TranslatingTorbutton"></a>
265) <h2>
266) <a class="anchor" href="#TranslatingTorbutton">Translating Torbutton</a></h2>
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

267) <hr />
268) 
269) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

270) <a href="https://torbutton.torproject.org/dev/">Torbutton</a>
271) is a Firefox extension that protects Firefox users from many different
272) threats. Since Torbutton is necessary to help protect users, we need
273) Torbutton to be translated into as many languages as possible.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

274) </p>
275) 
276) <p>
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

277) Torbutton translation is managed by the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

278) href="https://translation.torproject.org/">Tor Translation Portal</a>. You can
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

279) easily view the status of all translations on the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

280) href="https://translation.torproject.org/projects/torbutton/">Portal status page
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

281) for Torbutton</a>. Torbutton is also <a
282) href="https://tor-svn.freehaven.net/svn/translation/trunk/projects/torbutton/">in
283) subversion</a> like Vidalia and TorCheck.  Please visit the Portal page for <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

284) href="https://translation.torproject.org/projects/torbutton/">Torbutton</a> and
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

285) pick a locale to translate.  (You'll have to create an account and log in.)
Jacob Appelbaum Update note about translati...

Jacob Appelbaum authored 16 years ago

286) </p>
287) 
Roger Dingledine streamline the header names

Roger Dingledine authored 16 years ago

288) <a id="TranslatingTorCheck"></a>
289) <h2><a class="anchor" href="#TranslatingTorCheck">Translating TorCheck</a></h2>
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

290) <hr />
291) 
292) <p>
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

293) TorCheck is the simplest and smallest of the bunch. TorCheck is a
294) website run by a simple python program. It allows Tor users to check if
295) they are using Tor properly. Since TorCheck is the first website that
296) some Tor users see, and its goal is to let them know if their browser
297) is set up correctly, it is useful to have this page available in many
298) languages. TorCheck is also the easiest to translate as it's a single
299) very small file with only a few strings.
Jacob Appelbaum The start of the translatio...

Jacob Appelbaum authored 16 years ago

300) </p>
301) 
302) <p>
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

303) TorCheck uses the Tor Translation Portal. Simply visit the <a
Jacob Appelbaum We've now have https for tr...

Jacob Appelbaum authored 16 years ago

304) href="https://translation.torproject.org/projects/torcheck/">TorCheck
Jacob Appelbaum Updated information that in...

Jacob Appelbaum authored 16 years ago

305) translation status page</a> to see what's in need of translation. Please just
306) jump in and start translating the missing messages. (You'll have to create an account and log in.)
307) </p>
308) 
309) <p>
310) If the locale
311) you wish to add support for isn't translated or doesn't exist, you can easily
312) start the translation. Simply download a copy of
313) <a
314) href="https://tor-svn.freehaven.net/svn/translation/trunk/projects/torcheck/templates/TorCheck.pot">the
Roger Dingledine more cleaning, plus note tw...

Roger Dingledine authored 16 years ago

315) gettext template from the subversion repository</a>, open it in your text
316) editor, and start translating.
Roger Dingledine whitespace fixes (remove tr...

Roger Dingledine authored 16 years ago

317) When you're finished translating, you'll want to submit a patch via email
318) to the <tt>tor-translation</tt> team as listed on the