tor-webwml.git

en/translation-portal.wml     1) ## translation metadata

en/translation-portal.wml     2) # Revision: $Revision$

en/translation-overview.wml   3) # Translation-Priority: 4-optional
en/translation-overview.wml   4) 

en/translation-overview.wml   5) #include "head.wmi" TITLE="Tor: Translation Overview"

en/translation-portal.wml     6) 
en/translation-portal.wml     7) <div class="main-column">
en/translation-portal.wml     8) 

en/translation-overview.wml   9) <h1>Tor: Translation Overview</h1>

en/translation-portal.wml    10) <hr />
en/translation-portal.wml    11) 
en/translation-portal.wml    12) <p>

en/translation-portal.wml    13) The Tor bundles include several different programs, all of which need

en/translation-portal.wml    14) translation help. In order of importance they are:

en/translation-overview.wml  15) <a href="<page vidalia/index>">Vidalia</a>,

en/translation-overview.wml  16) <a href="<page torbutton/index>">Torbutton</a>, and

en/translation-portal.wml    17) <a href="https://check.torproject.org/">TorCheck</a>.
en/translation-portal.wml    18) Please read the sections below and help out. If you need help, please
en/translation-portal.wml    19) ask; we're always happy to lend a hand.

en/translation-portal.wml    20) </p>
en/translation-portal.wml    21) 

en/translation-portal.wml    22) <ul>

en/translation-portal.wml    23) <li><a href="#TTP">Using The Tor Translation Portal</a></li>
en/translation-portal.wml    24) <li><a href="#TranslatingVidalia">Other Vidalia components</a></li>

en/translation-portal.wml    25) <li><a href="#TranslatingTor">Translating the Tor website and
en/translation-portal.wml    26) documentation</a></li>

en/translation-portal.wml    27) </ul>

en/translation-portal.wml    28) 

en/translation-portal.wml    29) <a id="TTP"></a>

en/translation-portal.wml    30) <a id="TTPVidalia"></a>
en/translation-portal.wml    31) <h2><a class="anchor" href="#TTP">Using The Tor Translation Portal</a></h2>

en/translation-portal.wml    32) <hr />
en/translation-portal.wml    33) 
en/translation-portal.wml    34) <p>

en/translation-portal.wml    35) The <a href="https://translation.torproject.org/">Tor Translation Portal</a>

en/translation-portal.wml    36) is a website that lets users contribute translations online using their
en/translation-portal.wml    37) web browser. It lists all sentences or phrases (called "strings") used

en/translation-portal.wml    38) by a particular project, and allows interested volunteers to translate

en/translation-portal.wml    39) individual sentences or phrases as they are able.

en/translation-portal.wml    40) </p>
en/translation-portal.wml    41) 
en/translation-portal.wml    42) <p>
en/translation-portal.wml    43) You can check the status of all translations for a given project by visiting
en/translation-portal.wml    44) each project page.  The following statuses are updated in real time when new
en/translation-portal.wml    45) translations are added:

en/translation-portal.wml    46) <a href="https://translation.torproject.org/projects/vidalia/">Vidalia</a>,

en/translation-portal.wml    47) <a href="https://translation.torproject.org/projects/torbutton/">Torbutton</a>,

en/translation-portal.wml    48) and
en/translation-portal.wml    49) <a href="https://translation.torproject.org/projects/torcheck/">TorCheck</a>.

en/translation-portal.wml    50) </p>
en/translation-portal.wml    51) 

en/translation-portal.wml    52) <p>

en/translation-portal.wml    53) To get started using our translation website, you need to sign up for an
en/translation-portal.wml    54) account. Visit the <a

en/translation-portal.wml    55) href="https://translation.torproject.org/register.html">account registration

en/translation-portal.wml    56) page</a> to get started. Be sure to enter a proper email address and a strong
en/translation-portal.wml    57) password. After you fill in the form and use the 'Register Account' button, you
en/translation-portal.wml    58) should see some text indicating that things worked out: 

en/translation-portal.wml    59) </p>

en/translation-portal.wml    60) <pre>
en/translation-portal.wml    61) Account created. You will be emailed login details and an activation code.
en/translation-portal.wml    62) Please enter your activation code on the activation page.
en/translation-portal.wml    63) </pre>
en/translation-portal.wml    64) 
en/translation-portal.wml    65) <p>

en/translation-portal.wml    66) Shortly after you see this text an email will be sent to the email address you

en/translation-portal.wml    67) provided. The email should look something like the following:

en/translation-portal.wml    68) </p><pre>

en/translation-portal.wml    69) A Pootle account has been created for you using this email address.
en/translation-portal.wml    70) Your activation code is:
en/translation-portal.wml    71) 36074ec543c1fa23ceeaf8e187dfa43e
en/translation-portal.wml    72) This message is sent to verify that the email address is in fact correct. If
en/translation-portal.wml    73) you did not want to register an account, you may simply ignore the message.
en/translation-portal.wml    74) Your user name is: example_user
en/translation-portal.wml    75) Your password is: example_user
en/translation-portal.wml    76) Your registered email address is: username@example.com
en/translation-portal.wml    77) </pre>
en/translation-portal.wml    78) 
en/translation-portal.wml    79) <p>
en/translation-portal.wml    80) Once you've received the email, you'll need to activate your account by
en/translation-portal.wml    81) visiting the <a

en/translation-portal.wml    82) href="https://translation.torproject.org/activate.html">activation page</a>.

en/translation-portal.wml    83) Enter your username and activation code into the form and then submit the form
en/translation-portal.wml    84) by pressing the "Activate Account" button.
en/translation-portal.wml    85) 
en/translation-portal.wml    86) You'll see a message that says:

en/translation-portal.wml    87) </p><pre>

en/translation-portal.wml    88) Redirecting to login Page...
en/translation-portal.wml    89) Your account has been activated! Redirecting to login...
en/translation-portal.wml    90) </pre>
en/translation-portal.wml    91) 
en/translation-portal.wml    92) <p>

en/translation-portal.wml    93) When you login to your new account, you'll be prompted to configure your basic

en/translation-portal.wml    94) language preferences on the <a

en/translation-portal.wml    95) href="https://translation.torproject.org/home/options.html">options page</a>. At

en/translation-portal.wml    96) the very least, you'll want to select the user interface language, select any

en/translation-portal.wml    97) of the projects you're interested in translating, and additionally the languages

en/translation-portal.wml    98) you wish to translate. Save your changes by clicking the "Save Changes" button
en/translation-portal.wml    99) when you're finished.
en/translation-portal.wml   100) </p>
en/translation-portal.wml   101) 
en/translation-portal.wml   102) <p>
en/translation-portal.wml   103) You're ready to translate!
en/translation-portal.wml   104) </p>
en/translation-portal.wml   105) 
en/translation-portal.wml   106) <p>

en/translation-portal.wml   107) At this point, you can select a project, such as <a

en/translation-portal.wml   108) href="https://translation.torproject.org/projects/vidalia/">Vidalia</a>. You'll

en/translation-portal.wml   109) see a nice list of all of the currently supported languages along with the

en/translation-portal.wml   110) current translation progress. Select a language — in our example,
en/translation-portal.wml   111) you'll click

en/translation-portal.wml   112) <a href="https://translation.torproject.org/de/vidalia/">German</a>. The next

en/translation-portal.wml   113) page should show you a single row of data for the file "<a

en/translation-portal.wml   114) href='https://translation.torproject.org/de/vidalia/vidalia_de.po?translate=1&amp;view=1'>vidalia_de.po</a>".

en/translation-portal.wml   115) This is the file with all of the currently translated German strings for

en/translation-portal.wml   116) Vidalia. You should click on the "<a

en/translation-portal.wml   117) href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show

en/translation-portal.wml   118) Editing Functions</a>" link above the 'vidalia_de.po' row. Next you should

en/translation-portal.wml   119) click the "<a

en/translation-portal.wml   120) href='https://translation.torproject.org/de/vidalia/translate.html?fuzzy=1&editing=1&blank=1'>Quick

en/translation-portal.wml   121) Translate</a>" link. This will take you to the first untranslated string in the
en/translation-portal.wml   122) language group for the current project.
en/translation-portal.wml   123) </p>
en/translation-portal.wml   124) 
en/translation-portal.wml   125) <p>
en/translation-portal.wml   126) If you're able, please translate the string you see and click the 'Submit'
en/translation-portal.wml   127) button. If you're unsure, click the 'Suggest' button. Feel free to leave
en/translation-portal.wml   128) comments for any of the translations if you feel it's important to clarify
en/translation-portal.wml   129) anything.
en/translation-portal.wml   130) </p>
en/translation-portal.wml   131) 
en/translation-portal.wml   132) <p>

en/translation-portal.wml   133) When you're finished, you need to commit your changes. Return to the

en/translation-portal.wml   134) page with the <a

en/translation-portal.wml   135) href="https://translation.torproject.org/de/vidalia/index.html?editing=1">Editing

en/translation-portal.wml   136) Functions</a>, and click on the "<a

en/translation-portal.wml   137) href='https://translation.torproject.org/de/vidalia/index.html?editing=1&amp;docommit=1&amp;commitfile=vidalia_de.po'>Commit</a>"

en/translation-portal.wml   138) link. This will commit your changes into the <a

en/translation-overview.wml 139) href="https://svn.torproject.org/svn/translation/trunk/projects/vidalia/de/">Translation

en/translation-portal.wml   140) subversion module</a> in the specific area as specified by your choices of
en/translation-portal.wml   141) language and project (Vidalia and German, for this example).
en/translation-portal.wml   142) </p>
en/translation-portal.wml   143) 

en/translation-portal.wml   144) <p>

en/translation-portal.wml   145) That's all there is to it! Be sure to go through the steps again and
en/translation-portal.wml   146) contribute to Torbutton and Torcheck too.

en/translation-portal.wml   147) </p>
en/translation-portal.wml   148) 

en/translation-portal.wml   149) <p>
en/translation-portal.wml   150) If your language isn't in the list of options yet, send mail to <a
en/translation-portal.wml   151) href="<page contact>">the tor-translations team</a> and we'll add it
en/translation-portal.wml   152) for you.
en/translation-portal.wml   153) </p>
en/translation-portal.wml   154) 

en/translation-portal.wml   155) <p>
en/translation-portal.wml   156) For more advanced users who like to translate without a web browser, you can
en/translation-portal.wml   157) also download the .po file directly. You'll find this option after clicking on
en/translation-portal.wml   158) the "<a

en/translation-portal.wml   159) href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show

en/translation-portal.wml   160) Editing Functions</a>" link. You should see a link to download the "<a

en/translation-portal.wml   161) href="https://translation.torproject.org/de/vidalia/vidalia_de.po">PO file</a>".

en/translation-portal.wml   162) If this option fits your working habits, by all means, please use it!

en/translation-portal.wml   163) You may find a program called <a href="http://www.poedit.net/">Poedit</a>
en/translation-portal.wml   164) to make the job easier, especially for right-to-left languages that don't
en/translation-portal.wml   165) work as well in text editors. If you're using Poedit, you should disable
en/translation-portal.wml   166) compiling .mo files in Poedit's preferences (File -&gt; Preferences -&gt;
en/translation-portal.wml   167) Editor -&gt; Behavior, uncheck "Automatically compile .mo file on save").
en/translation-portal.wml   168) When you're finished translating the .po file, you can upload it by
en/translation-portal.wml   169) using the "upload file" form in the upper right hand corner: simply
en/translation-portal.wml   170) select the file and click the 'Upload file' button.

en/translation-portal.wml   171) </p>
en/translation-portal.wml   172) 

en/translation-portal.wml   173) <a id="TranslatingVidalia"></a>
en/translation-portal.wml   174) <h2>
en/translation-portal.wml   175) <a class="anchor" href="#TranslatingVidalia">Other Vidalia translation efforts</a>
en/translation-portal.wml   176) </h2>
en/translation-portal.wml   177) <hr />
en/translation-portal.wml   178) 
en/translation-portal.wml   179) <p>

en/translation-portal.wml   180) In addition to the main Vidalia interface, which is covered by the above <a

en/translation-portal.wml   181) href="#TTPVidalia">Vidalia walkthrough</a>, we also need translations
en/translation-portal.wml   182) for the Win32 installer and the help documentation.

en/translation-portal.wml   183) </p>
en/translation-portal.wml   184) 
en/translation-portal.wml   185) <p>
en/translation-portal.wml   186) The <b>Win32 installer</b> uses the NSI format and is found in the Vidalia subversion
en/translation-portal.wml   187) repository. The NSI format is very similar to normal gettext templates.
en/translation-portal.wml   188) The file format is quite simple. Essentially, it is text with the corresponding
en/translation-portal.wml   189) translations. This is a good place to get your feet wet with localization and a
en/translation-portal.wml   190) normal text editor. Currently this format is not supported by the translation
en/translation-portal.wml   191) portal.  You'll only need a text editor and knowledge of two languages, English
en/translation-portal.wml   192) and whatever locale you'll be translating the original English into.
en/translation-portal.wml   193) You can download the NSI localization files from the Vidalia subversion
en/translation-portal.wml   194) repository. For more information on translating the Win32
en/translation-portal.wml   195) installer, please see the corresponding instructional
en/translation-portal.wml   196) <a href="http://trac.vidalia-project.net/wiki/Translations#TranslateInstallers">
en/translation-portal.wml   197) page on the Vidalia wiki</a>. It's a useful page that explains step by step
en/translation-portal.wml   198) information for translation, encoding and submission for inclusion in the next
en/translation-portal.wml   199) release. You'll also notice that the wiki page lists translators - we're
en/translation-portal.wml   200) especially in need of Farsi and Hebrew translators. Perhaps you're the one?
en/translation-portal.wml   201) </p>
en/translation-portal.wml   202) 
en/translation-portal.wml   203) <p>
en/translation-portal.wml   204) Last but certainly not least, Vidalia requires diligent
en/translation-portal.wml   205) <a href="http://trac.vidalia-project.net/wiki/Translations#AvailableHelpTranslations">
en/translation-portal.wml   206) translation of its <b>help documents</b></a>. This is important to ensure that users
en/translation-portal.wml   207) fully understand the choices that they make and so they understand
en/translation-portal.wml   208) the choices the software makes on their behalf. We're currently looking
en/translation-portal.wml   209) for German and Bulgarian translators; perhaps you're the right person for the job?
en/translation-portal.wml   210) </p>
en/translation-portal.wml   211) 

en/translation-portal.wml   212) <p>

en/translation-portal.wml   213) Torbutton (like Vidalia and TorCheck) translation is managed by the <a

en/translation-portal.wml   214) href="https://translation.torproject.org/">Tor Translation Portal</a>. You can

en/translation-portal.wml   215) easily view the status of all translations on the <a

en/translation-portal.wml   216) href="https://translation.torproject.org/projects/torbutton/">Portal status page

en/translation-portal.wml   217) for Torbutton</a>. Torbutton is also <a

en/translation-overview.wml 218) href="https://svn.torproject.org/svn/translation/trunk/projects/torbutton/">in

en/translation-portal.wml   219) subversion</a> like Vidalia and TorCheck.  Please visit the Portal page for <a

en/translation-portal.wml   220) href="https://translation.torproject.org/projects/torbutton/">Torbutton</a> and

en/translation-portal.wml   221) pick a locale to translate.  (You'll have to create an account and log in.)

en/translation-portal.wml   222) </p>
en/translation-portal.wml   223) 

en/translation-portal.wml   224) <p>

en/translation-portal.wml   225) If you're unsure about how to use the <a

en/translation-portal.wml   226) href="https://translation.torproject.org/">Tor Translation Portal</a> to

en/translation-overview.wml 227) translate Torbutton, please read <a href="#TTPVidalia">our example
en/translation-overview.wml 228) walkthrough with Vidalia</a>. Torbutton uses the same system with the
en/translation-overview.wml 229) same processes.

en/translation-portal.wml   230) </p>
en/translation-portal.wml   231) 

en/translation-portal.wml   232) <a id="TranslatingTor"></a>
en/translation-portal.wml   233) <h2><a class="anchor" href="#TranslatingTor">Translating the
en/translation-portal.wml   234) Tor website and documentation</a></h2>
en/translation-portal.wml   235) <hr />
en/translation-portal.wml   236) 
en/translation-portal.wml   237) <p>
en/translation-portal.wml   238) We've written some basic guidelines to help you translate
en/translation-portal.wml   239) the Tor website and documentation on our <a href="<page translation>">main

en/translation-portal.wml   240) website translation page</a>. The guidelines there also provide good advice for

en/translation-portal.wml   241) the other translation items on this page. The current status of the website
en/translation-portal.wml   242) translations can be found on our <a

en/translation-portal.wml   243) href="<page translation-status>">website translation status page</a>.