Author: pfrields Update of /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7631 Modified Files: index.php ln-legalnotice-opl.php rv-revhistory.php sn_accounts.php sn_translating_docs.php sn_translating_software.php Log Message: Push new TQSG 0.3.7.4, translations to follow as they are completed. Index: index.php =================================================================== RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US/index.php,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- index.php 12 Jul 2007 02:23:49 -0000 1.2 +++ index.php 28 Jul 2007 21:29:08 -0000 1.3 @@ -7,7 +7,7 @@ ?> -<div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Translation Quick Start Guide</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sn_accounts.php">Next</a></td></tr></table><hr></div><div class="article" lang="en-US" id="translation-quickstart-guide"><div class="titlepage"><div><div><h1 class="title"><a name="translation-quickstart-guide"></a>Translation Quick Start Guide</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Manuel</span> <span class="surname">Ospina</span></h3></div><div class="editor"><h4 class="editedby">Edited by</h4><h3 class="editor"><span class="firstname">Paul</span> <span class="othername">W.</span> <span class="surname">Frields</span></h3></div></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Hugo</span> <span cla! ss="surname">Cisneiros</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Francesco</span> <span class="surname">Tombolini</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Andrew</span> <span class="surname">Martynov</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">José</span> <span class="surname">Pires</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Bart</span> <span class="surname">Courveur</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Dimitris</span> <span class="surname">Glezos</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Damien</span> <span class="surname">Durand</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="fir! stname">Guillermo</span> <span class="surname">Gomez</span></h! 3></di /div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Diego</span> <span class="othername">Búrigo</span> <span class="surname">Zacarão</span></h3></div></div><div><p class="releaseinfo">Version 0.3.7.3 (2007-07-06)</p></div><div><p class="copyright">Copyright © 2005, 2006, 2007 Red Hat, Inc. and others</p></div><div><a href="ln-legalnotice-opl.php">Legal Notice</a></div><div><a href="rv-revhistory.php">Revision History</a></div></div><hr></div><div class="toc"><dl><dt><span class="section"><a href="index.php#sn-intro">1. Introduction</a></span></dt><dt><span class="section"><a href="sn_accounts.php">2. Accounts and Subscriptions</a></span></dt><dd><dl><dt><span class="section"><a href="sn_accounts.php#sn-ssh-key">2.1. Making an SSH Key</a></span></dt><dt><span class="section"><a href="sn_accounts.php#sn-accounts-trans">2.2. Accounts for Software Translation</a></span></dt><dt><span class="section"><a href="sn_accounts.php#sn-accounts-docs">2.3! . Accounts for Documentation</a></span></dt></dl></dd><dt><span class="section"><a href="sn_translating_software.php">3. Translating Software</a></span></dt><dd><dl><dt><span class="section"><a href="sn_translating_software.php#sn-translating-strings">3.1. Translating Strings</a></span></dt><dt><span class="section"><a href="sn_translating_software.php#sn-proofreading">3.2. Proofreading</a></span></dt></dl></dd><dt><span class="section"><a href="sn_translating_docs.php">4. Translating Documentation</a></span></dt><dd><dl><dt><span class="section"><a href="sn_translating_docs.php#sn-downloading-docs">4.1. Downloading Documentation</a></span></dt><dt><span class="section"><a href="sn_translating_docs.php#sn-creating-common">4.2. Creating Common Files</a></span></dt><dt><span class="section"><a href="sn_translating_docs.php#sn-translating-with-apps">4.3. Using Translation Applications</a></span></dt></dl></dd></dl></div><div class="section" lang="en-US"><div class="titlepage">! <div><div><h2 class="title" style="clear: both"><a name="sn-in! tro">< 1. Introduction</h2></div></div></div><p> +<div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Translation Quick Start Guide</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sn_accounts.php">Next</a></td></tr></table><hr></div><div class="article" lang="en-US" id="translation-quickstart-guide"><div class="titlepage"><div><div><h1 class="title"><a name="translation-quickstart-guide"></a>Translation Quick Start Guide</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Manuel</span> <span class="surname">Ospina</span></h3></div><div class="editor"><h4 class="editedby">Edited by</h4><h3 class="editor"><span class="firstname">Paul</span> <span class="othername">W.</span> <span class="surname">Frields</span></h3></div></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Hugo</span> <span cla! ss="surname">Cisneiros</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Francesco</span> <span class="surname">Tombolini</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Andrew</span> <span class="surname">Martynov</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">José</span> <span class="surname">Pires</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Bart</span> <span class="surname">Courveur</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Dimitris</span> <span class="surname">Glezos</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Damien</span> <span class="surname">Durand</span></h3></div></div><div><div class="othercredit"><h3 class="othercredit"><span class="fir! stname">Guillermo</span> <span class="surname">Gomez</span></h! 3></di /div><div><div class="othercredit"><h3 class="othercredit"><span class="firstname">Diego</span> <span class="othername">Búrigo</span> <span class="surname">Zacarão</span></h3></div></div><div><p class="releaseinfo">Version 0.3.7.4 (2007-07-28)</p></div><div><p class="copyright">Copyright © 2005, 2006, 2007 Red Hat, Inc. and others</p></div><div><a href="ln-legalnotice-opl.php">Legal Notice</a></div><div><a href="rv-revhistory.php">Revision History</a></div></div><hr></div><div class="toc"><dl><dt><span class="section"><a href="index.php#sn-intro">1. Introduction</a></span></dt><dt><span class="section"><a href="sn_accounts.php">2. Accounts and Subscriptions</a></span></dt><dd><dl><dt><span class="section"><a href="sn_accounts.php#sn-ssh-key">2.1. Making an SSH Key</a></span></dt><dt><span class="section"><a href="sn_accounts.php#sn-accounts-trans">2.2. Accounts for Software Translation</a></span></dt><dt><span class="section"><a href="sn_accounts.php#sn-accounts-docs">2.3! . Accounts for Documentation</a></span></dt></dl></dd><dt><span class="section"><a href="sn_translating_software.php">3. Translating Software</a></span></dt><dd><dl><dt><span class="section"><a href="sn_translating_software.php#sn-translating-strings">3.1. Translating Strings</a></span></dt><dt><span class="section"><a href="sn_translating_software.php#sn-proofreading">3.2. Proofreading</a></span></dt></dl></dd><dt><span class="section"><a href="sn_translating_docs.php">4. Translating Documentation</a></span></dt><dd><dl><dt><span class="section"><a href="sn_translating_docs.php#sn-downloading-docs">4.1. Downloading Documentation</a></span></dt><dt><span class="section"><a href="sn_translating_docs.php#sn-creating-common">4.2. Creating Common Files</a></span></dt><dt><span class="section"><a href="sn_translating_docs.php#sn-translating-with-apps">4.3. Using Translation Applications</a></span></dt></dl></dd></dl></div><div class="section" lang="en-US"><div class="titlepage">! <div><div><h2 class="title" style="clear: both"><a name="sn-in! tro">< 1. Introduction</h2></div></div></div><p> This guide is a fast, simple, step-by-step set of instructions for translating Fedora Project software and documents. If you are interested in better understanding the translation process involved, refer to Index: ln-legalnotice-opl.php =================================================================== RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US/ln-legalnotice-opl.php,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- ln-legalnotice-opl.php 12 Jul 2007 02:23:49 -0000 1.2 +++ ln-legalnotice-opl.php 28 Jul 2007 21:29:08 -0000 1.3 @@ -11,7 +11,7 @@ Permission is granted to copy, distribute, and/or modify this document under the terms of the Open Publication Licence, Version 1.0, or any later version. The terms of the OPL are set out below. - </p><div class="orderedlist"><a name="opl.terms"></a><ol type="I"><li><a name="opl.require"></a><h2><a name="id2840802"></a>REQUIREMENTS ON BOTH UNMODIFIED AND MODIFIED + </p><div class="orderedlist"><a name="opl.terms"></a><ol type="I"><li><a name="opl.require"></a><h2><a name="id2966944"></a>REQUIREMENTS ON BOTH UNMODIFIED AND MODIFIED VERSIONS</h2><p> Open Publication works may be reproduced and distributed in whole or in part, in any medium physical or electronic, provided @@ -37,10 +37,10 @@ surfaces of the book the original publisher's name shall be as large as the title of the work and cited as possessive with respect to the title. - </p></li><li><a name="opl.copyright"></a><h2><a name="id2852516"></a>COPYRIGHT</h2><p> + </p></li><li><a name="opl.copyright"></a><h2><a name="id2981812"></a>COPYRIGHT</h2><p> The copyright to each Open Publication is owned by its author(s) or designee. - </p></li><li><a name="opl.scope"></a><h2><a name="id2859049"></a>SCOPE OF LICENSE</h2><p> + </p></li><li><a name="opl.scope"></a><h2><a name="id2986480"></a>SCOPE OF LICENSE</h2><p> The following license terms apply to all Open Publication works, unless otherwise explicitly stated in the document. </p><p> @@ -60,7 +60,7 @@ including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose or a warranty of non-infringement. - </p></li><li><a name="opl.modified.works"></a><h2><a name="id2853759"></a>REQUIREMENTS ON MODIFIED WORKS</h2><p> + </p></li><li><a name="opl.modified.works"></a><h2><a name="id2984874"></a>REQUIREMENTS ON MODIFIED WORKS</h2><p> All modified versions of documents covered by this license, including translations, anthologies, compilations and partial documents, must meet the following requirements: @@ -80,7 +80,7 @@ The original author's (or authors') name(s) may not be used to assert or imply endorsement of the resulting document without the original author's (or authors') permission. - </p></li></ol></div></li><li><a name="opl.good-practice"></a><h2><a name="id2843454"></a>GOOD-PRACTICE RECOMMENDATIONS</h2><p> + </p></li></ol></div></li><li><a name="opl.good-practice"></a><h2><a name="id2976408"></a>GOOD-PRACTICE RECOMMENDATIONS</h2><p> In addition to the requirements of this license, it is requested from and strongly recommended of redistributors that: </p><div class="orderedlist"><ol type="1"><li><p> @@ -99,7 +99,7 @@ considered good form to offer a free copy of any hardcopy and CD-ROM expression of an Open Publication-licensed work to its author(s). - </p></li></ol></div></li><li><a name="opl.options"></a><h2><a name="id2830130"></a>LICENSE OPTIONS</h2><p> + </p></li></ol></div></li><li><a name="opl.options"></a><h2><a name="id2988832"></a>LICENSE OPTIONS</h2><p> The author(s) and/or publisher of an Open Publication-licensed document may elect certain options by appending language to the reference to or copy of the license. These options are Index: rv-revhistory.php =================================================================== RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US/rv-revhistory.php,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- rv-revhistory.php 12 Jul 2007 02:23:49 -0000 1.2 +++ rv-revhistory.php 28 Jul 2007 21:29:08 -0000 1.3 @@ -7,7 +7,11 @@ ?> -<div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.3.7.3</td><td align="left">2007-07-06</td><td align="left"></td></tr><tr><td align="left" colspan="3"> +<div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.3.7.4</td><td align="left">2007-07-28</td><td align="left"></td></tr><tr><td align="left" colspan="3"> + <p> + Add information on branch modules and testing changes + </p> + </td></tr><tr><td align="left">Revision 0.3.7.3</td><td align="left">2007-07-06</td><td align="left"></td></tr><tr><td align="left" colspan="3"> <p> Make admonition against manual POT changes </p> Index: sn_translating_docs.php =================================================================== RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US/sn_translating_docs.php,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- sn_translating_docs.php 12 Jul 2007 02:23:49 -0000 1.2 +++ sn_translating_docs.php 28 Jul 2007 21:29:08 -0000 1.3 @@ -27,10 +27,16 @@ </pre><p> To download a module to translate, list the current modules in the repository and then check out that module. You must also - check out the <code class="filename">docs-common</code> module. + check out the <code class="filename">docs-common</code> module to work + with some modules. </p><pre class="screen"> <code class="command">cvs co example-tutorial docs-common</code> -</pre><p> +</pre><p>Modules that are created for each release of Fedora are + separated into <em class="firstterm">branches</em>. The branch + shows the release of Fedora for which that document was + created. The <code class="filename">release-notes-F-7</code> module, for + example, contains the branch of the <em class="citetitle">Release + Notes</em> created for Fedora 7.</p><p> The documents are written in DocBook XML format. Each is stored in a directory named for the specific-language locale, such as <code class="filename">en_US/example-tutorial.xml</code>. The @@ -124,7 +130,10 @@ Test your translation using the HTML build tools: </p><pre class="screen"> <code class="command">make html-<em class="replaceable"><code>pt_BR</code></em></code> -</pre></li><li><p> +</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Always Test Your Translation"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="./stylesheet-images/important.png"></td><th align="left">Always Test Your Translation</th></tr><tr><td align="left" valign="top"><p>Do not go to the next step or commit changes until you + test your work in this step. Erroneous changes can break + documents for other users, editors, and automated + applications.</p></td></tr></table></div></li><li><p> When you have finished your translation, commit the <code class="filename">.po</code> file. You may note the percent complete or some other useful message at