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

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

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

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

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

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

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

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

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

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

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

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

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

en/translation.wml 34) 

en/translation.wml 35) #<li>File names should be changed from index.html to index.xx.html, where xx

en/translation.wml 36) #is your <a
en/translation.wml 37) #href="http://www.loc.gov/standards/iso639-2/php/code_list.php">ISO 639</a>

en/translation.wml 38) #two letter language code.</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: 6000<br />
en/translation.wml 42) where 6000 is the revision number of the original page translated. 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

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

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) 

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

translation.html   62) 

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

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

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

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

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

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

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

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

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

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

translation.html   81) </ol>
translation.html   82) 
translation.html   83)   </div><!-- #main -->