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

en/translation.wml 13) other languages, here are some guidelines to help you do this as
en/translation.wml 14) efficiently as possible. Rather than just translating each page word
en/translation.wml 15) by word, please try to translate the ideas so they make the most sense
en/translation.wml 16) in your language.</p>
en/translation.wml 17) 
en/translation.wml 18) <p>

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

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

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

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

translation.html   26) </p>
translation.html   27) 
translation.html   28) <ol>

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

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

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

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

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

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

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

en/translation.wml 38) 

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

en/translation.wml 40) \# Based-On-Revision: 13000<br />
en/translation.wml 41) where 13000 is the revision number of the original page translated. This

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

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

en/translation.wml 45) <a href="<page documentation>#Developers">checkout</a> the latest version
en/translation.wml 46) 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 at example.com<br />

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

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

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

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

translation.html   69) 
translation.html   70) <li>Keep your translation valid XHTML to minimize the work needed

en/translation.wml 71) before the page is committed to SVN. You can test your page at <a

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

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

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

en/translation.wml 76) page</a>.  (If you have changes to existing pages, please use the diff
en/translation.wml 77) tool to generate patch files, if possible.)  If you plan to stick
en/translation.wml 78) around and keep maintaining them, we'll

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

translation.html   80) </ol>
translation.html   81) 

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

en/translation.wml 86) </p>
en/translation.wml 87) 

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