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) At this time, we have an actively maintained German translation, one

en/translation.wml 16) page in French, some pages in Swedish, and

en/translation.wml 17) an old Italian translation that needs a new maintainer.

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

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

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

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

en/translation.wml 26) <li>Look in <a
en/translation.wml 27) href="http://tor.eff.org/cvs/website/en/">http://tor.eff.org/cvs/website/en/</a>
en/translation.wml 28) for a set of ".wml" files. The most important ones to

en/translation.wml 29) translate are <code>index.wml</code>, <code>overview.wml</code>,
en/translation.wml 30) <code>download.wml</code>, <code>documentation.wml</code>,
en/translation.wml 31) <code>foot.wmi</code>, and <code>navigation.wml</code>.
en/translation.wml 32) You are welcome to translate

en/translation.wml 33) more pages than this if you would like. You can look at <a
en/translation.wml 34) href="http://tor.eff.org/cvs/website/de/">http://tor.eff.org/cvs/website/de/</a>
en/translation.wml 35) for examples of the desired translation formats.</li>

en/translation.wml 36) 

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

en/translation.wml 40) 

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

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

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

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

en/translation.wml 46) <a href="<page developers>">checkout</a> the latest version of the website.</li>

en/translation.wml 47) 

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

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

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

translation.html   52) 

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

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

translation.html   59) 

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

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

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

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

translation.html   74) </ol>
translation.html   75) 
translation.html   76)   </div><!-- #main -->