tor-webwml.git

en/translation.wml   1) ## translation metadata

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

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

translation.html     4) 

en/translation.wml   5) #include "head.wmi" TITLE="Tor Website Translation Guidelines"

translation.html     6) 

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

en/translation.wml   9) <h2>Tor Website Translation Guidelines</h2>

translation.html    10) <hr />
translation.html    11) 
translation.html    12) <p>

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

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

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

en/translation.wml  17) 

en/translation.wml  18) <p>

en/translation.wml  19) If you would like to help translate other Tor project related information,
en/translation.wml  20) please visit our <a href="<page translation-overview>">Translation Overview</a>
en/translation.wml  21) for a clear overview of what needs translation help. If you're stuck, please

en/translation.wml  22) contact us via email: <tt>tor-translation AT torproject.org</tt>.
en/translation.wml  23) </p>
en/translation.wml  24) 

en/translation.wml  25) <p>

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

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

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

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

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

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

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

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

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

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

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

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

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

en/translation.wml  47) 

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

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

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

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

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

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

en/translation.wml  56) 

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

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

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

translation.html    63) 

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

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

translation.html    73) 

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

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

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

translation.html    81) 

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

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

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

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

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

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

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

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

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

en/translation.wml  95) our translation portal for <a href="<page translation-overview>">translating

en/translation.wml  96) other useful and related software</a>.

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

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

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