tor-webwml.git

en/translation.wml  1) ## translation metadata

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

translation.html    3) 

en/translation.wml  4) #include "head.wmi" TITLE="Translation guidelines"

translation.html    5) 

translation.html    6) <div class="main-column">
translation.html    7) 
translation.html    8) <h2>Tor: Translation guidelines</h2>
translation.html    9) <hr />
translation.html   10) 
translation.html   11) <p>

translation.html   12) If you want to help translate the Tor website and documentation into

translation.html   13) other languages, here are some basic guidelines to help you do this

translation.html   14) as efficiently as possible.<br />

en/translation.wml 15) To get an idea how

en/translation.wml 16) current our translations are, we have created a page with the current
en/translation.wml 17) <a href="<page translation-status>">translation status</a>.</p>

translation.html   18) 
translation.html   19) <p>

translation.html   20) Note that we're interested in getting the complete website translated

translation.html   21) for each language, but even a few pages will still be helpful.

translation.html   22) </p>
translation.html   23) 
translation.html   24) <ol>

en/translation.wml 25) <li>Look in <a

en/translation.wml 26) href="<cvssandbox>website/en/"><cvssandbox>website/en/</a>

en/translation.wml 27) for a set of ".wml" files. The most important ones to

en/translation.wml 28) translate are <code>index.wml</code>, <code>overview.wml</code>,
en/translation.wml 29) <code>download.wml</code>, <code>documentation.wml</code>,
en/translation.wml 30) <code>foot.wmi</code>, and <code>navigation.wml</code>.

en/translation.wml 31) You are welcome to translate more pages than this if you would
en/translation.wml 32) like: the next set that would be useful are the ".wml" files in <a

en/translation.wml 33) href="<cvssandbox>website/docs/en/"><cvssandbox>website/docs/en/</a>.

en/translation.wml 34) You can look at <a

en/translation.wml 35) href="<cvssandbox>website/de/"><cvssandbox>website/de/</a>

en/translation.wml 36) for examples of the desired translation formats.</li>

en/translation.wml 37) 

en/translation.wml 38) #<li>File names should be changed from index.html to index.xx.html, where xx
en/translation.wml 39) #is your <a href="http://www.w3.org/WAI/ER/IG/ert/iso639.htm">ISO 639</a>
en/translation.wml 40) #two letter language code.</li>

en/translation.wml 41) 

translation.html   42) <li>The first line in the translated file should be<br />

en/translation.wml 43) \# Based-On-Revision: 1.4<br />
en/translation.wml 44) where 1.4 is the revision number of the original page translated, to

translation.html   45) easily spot when a page gets out of date. The revision number is found at

en/translation.wml 46) the top on each page -- it is created by CVS so be sure to

en/translation.wml 47) <a href="<page documentation>#Developers">checkout</a> the latest version
en/translation.wml 48) of the website.</li>

en/translation.wml 49) 

translation.html   50) <li>The second line in the translated file should be the email address of
translation.html   51) the translator:<br />

en/translation.wml 52) \# Last-Translator: abc@example.com<br />

translation.html   53) so we can get ahold of you if the pages needs to be corrected or updated.</li>

translation.html   54) 

en/translation.wml 55) <li>We would also like some translations for the diagrams on
en/translation.wml 56) <a href="<page overview>">the overview page</a>. You can just send us
en/translation.wml 57) the text that should go in the diagrams, and we'll take care of making
en/translation.wml 58) new versions of the pictures.</li>
en/translation.wml 59) 

translation.html   60) <li>Translated pages should link to the other translated pages.</li>

translation.html   61) 

en/translation.wml 62) <li>Translated pages should include a note in foot.wml, translated to the

translation.html   63) appropriate language: "Neither the Tor developers nor EFF have reviewed
translation.html   64) this translation for accuracy and correctness. It may be out of date
translation.html   65) or wrong. The official Tor web site is the English version, available
translation.html   66) at http://tor.eff.org/"</li>
translation.html   67) 

translation.html   68) <li>Use valid <a href="http://roselli.org/adrian/articles/character_charts.asp">character entities</a>.

translation.html   69) Even though most browsers display the characters correctly these days, we want
translation.html   70) to be on the safe side, so we don't get bug reports from people who can't
translation.html   71) read the text.</li>
translation.html   72) 
translation.html   73) <li>Keep your translation valid XHTML to minimize the work needed
translation.html   74) before the page is committed to CVS. You can test your code at <a
translation.html   75) href="http://validator.w3.org/">validator.w3.org</a>.</li>

translation.html   76) </ol>
translation.html   77) 
translation.html   78)   </div><!-- #main -->