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="Tor Website Translation guidelines"

translation.html     5) 

translation.html     6) <div class="main-column">
translation.html     7) 

en/translation.wml   8) <h2>Tor Website 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

en/translation.wml  13) other languages, here are some guidelines to help you do this as

en/translation.wml  14) efficiently as possible.
en/translation.wml  15) </p>

en/translation.wml  16) 

en/translation.wml  17) <p>
en/translation.wml  18) If you would like to help translate other Tor project related information, 
en/translation.wml  19) please visit our <a href="<page translation-portal>">Translation Portal</a> 
en/translation.wml  20) for a clear overview of what needs translation help. If you're stuck, please 
en/translation.wml  21) contact us via email: <tt>tor-translation AT torproject.org</tt>.
en/translation.wml  22) </p>
en/translation.wml  23) 

en/translation.wml  24) <p>

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

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

translation.html    28) 
translation.html    29) <p>

en/translation.wml  30) Note that even if you can't translate many pages for your language,
en/translation.wml  31) a few pages will still be helpful.

en/translation.wml  32) Also, rather than just translating each page word
en/translation.wml  33) by word, please try to translate the ideas so they make the most sense
en/translation.wml  34) in your language.</p>

translation.html    35) 
translation.html    36) <ol>

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

en/translation.wml  38) href="<svnwebsite>en/"><svnwebsite>en/</a>

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

en/translation.wml  40) translate are listed as "high priority", "medium priority",
en/translation.wml  41) and "low priority" on the
en/translation.wml  42) <a href="<page translation-status>">translation status</a> page.

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

en/translation.wml  44) href="<svnwebsite>de/"><svnwebsite>de/</a>

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

en/translation.wml  46) 

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

en/translation.wml  48) \# Based-On-Revision: 13000<br />

en/translation.wml  49) where 13000 is the revision number of the original English page. This

en/translation.wml  50) lets you easily spot when a page gets out of date. The revision number

en/translation.wml  51) is found at the top on each page -- you can either look at the files in the
en/translation.wml  52) <a href="<svnwebsite>en/"><svnwebsite>en/</a> directory, or manually

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

en/translation.wml  55) 

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

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

en/translation.wml  59) so we can get ahold of you if the pages needs to be corrected or updated.
en/translation.wml  60) (Since the pages will be posted on the web and spammers will find them,
en/translation.wml  61) you may want to obfuscate your email address or use a separate one.)</li>

translation.html    62) 

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

en/translation.wml  68) <li>Translated pages should link to the other translated pages. In general
en/translation.wml  69) this is automatic: writing <code>&lt;page download&gt;</code>
en/translation.wml  70) will automatically link to the translated version of that page if
en/translation.wml  71) there is one, and the English version otherwise.</li>

translation.html    72) 

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

translation.html    74) Even though most browsers display the characters correctly these days, we want
translation.html    75) to be on the safe side, so we don't get bug reports from people who can't

en/translation.wml  76) read the text. If you need to use a character set other than ISO-8859-1,
en/translation.wml  77) add something like <code>CHARSET="UTF-8"</code> to the end of the line
en/translation.wml  78) that starts with <code>#include "head.wmi"</code>.
en/translation.wml  79) </li>

translation.html    80) 

en/translation.wml  81) <li>Keep your translation valid XHTML. Once it's in place, you can test
en/translation.wml  82) your page at <a

translation.html    83) href="http://validator.w3.org/">validator.w3.org</a>.</li>

en/translation.wml  84) 
en/translation.wml  85) <li>When you have some pages ready, send them to the

en/translation.wml  86) <tt>tor-translation</tt> alias on the <a href="<page contact>">contact

en/translation.wml  87) page</a>.  (If you have changes to existing pages, please use the diff
en/translation.wml  88) tool to generate patch files, if possible.)  If you plan to stick

en/translation.wml  89) around and keep maintaining them, let us know and we'll

en/translation.wml  90) be happy to give you an SVN account to manage them directly.</li>

translation.html    91) </ol>
translation.html    92) 

en/translation.wml  93) <p>Other projects related to Tor also need translators. Please see

en/translation.wml  94) our translation portal for <a href="<page translation-portal>">translating
en/translation.wml  95) other useful and related software</a>.

en/translation.wml  96) </p>
en/translation.wml  97) 

translation.html    98)   </div><!-- #main -->

en/translation.wml  99) 
en/translation.wml 100) #include <foot.wmi>