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: 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

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) To get an idea how

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

translation.html   21) 
translation.html   22) <p>

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

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

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

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

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

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

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

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

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

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

en/translation.wml 39) 

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

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

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

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

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

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

en/translation.wml 48) 

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

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

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

translation.html   55) 

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

en/translation.wml 61) <li>Translated pages should link to the other translated pages. In general
en/translation.wml 62) this is automatic: writing <code>&lt;page download&gt;</code>
en/translation.wml 63) will automatically link to the translated version of that page if
en/translation.wml 64) there is one, and the English version otherwise.</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

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

translation.html   73) 

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

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

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

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

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

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

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

translation.html   84) </ol>
translation.html   85) 

en/translation.wml 86) <p>Other projects related to Tor also need translators. Please see
en/translation.wml 87) the guidelines for <a
en/translation.wml 88) href="http://trac.vidalia-project.net/wiki/Translations">translating
en/translation.wml 89) Vidalia</a>.

en/translation.wml 90) </p>
en/translation.wml 91) 

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

en/translation.wml 93) 
en/translation.wml 94) #include <foot.wmi>