Author: pfrields
Update of /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv5226
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 0.3.7.5, with translations to follow.
Index: index.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en_US/index.php,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- index.php 28 Jul 2007 21:29:08 -0000 1.3
+++ index.php 29 Jul 2007 23:42:54 -0000 1.4
@@ -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.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>
+<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.5 (2007-07-29)</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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- ln-legalnotice-opl.php 28 Jul 2007 21:29:08 -0000 1.3
+++ ln-legalnotice-opl.php 29 Jul 2007 23:42:54 -0000 1.4
@@ -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="id2966944"></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="id3031939"></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="id2981812"></a>COPYRIGHT</h2><p>
+ </p></li><li><a name="opl.copyright"></a><h2><a name="id3029848"></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="id2986480"></a>SCOPE OF LICENSE</h2><p>
+ </p></li><li><a name="opl.scope"></a><h2><a name="id3051605"></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="id2984874"></a>REQUIREMENTS ON MODIFIED WORKS</h2><p>
+ </p></li><li><a name="opl.modified.works"></a><h2><a name="id3039655"></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="id2976408"></a>GOOD-PRACTICE RECOMMENDATIONS</h2><p>
+ </p></li></ol></div></li><li><a name="opl.good-practice"></a><h2><a name="id3019686"></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="id2988832"></a>LICENSE OPTIONS</h2><p>
+ </p></li></ol></div></li><li><a name="opl.options"></a><h2><a name="id3046403"></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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- rv-revhistory.php 28 Jul 2007 21:29:08 -0000 1.3
+++ rv-revhistory.php 29 Jul 2007 23:42:54 -0000 1.4
@@ -7,7 +7,12 @@
?>
-<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">
+<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.5</td><td align="left">2007-07-29</td><td align="left"></td></tr><tr><td align="left" colspan="3">
+ <p>
+ Add information about LINGUAS and remove unnecessary
+ admonitions
+ </p>
+ </td></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>
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.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- sn_translating_docs.php 28 Jul 2007 21:29:08 -0000 1.3
+++ sn_translating_docs.php 29 Jul 2007 23:42:54 -0000 1.4
@@ -85,17 +85,15 @@
</pre></li></ol></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Build Errors"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="./stylesheet-images/important.png"></td><th align="left">Build Errors</th></tr><tr><td align="left" valign="top"><p>
If you do not create these common entities, building your
document may fail.
- </p></td></tr></table></div></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a name="sn-translating-with-apps"></a>4.3. Using Translation Applications</h3></div></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Creating the po/
- Directory"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="./stylesheet-images/note.png"></td><th align="left">Creating the <code class="filename">po/</code>
- Directory</th></tr><tr><td align="left" valign="top"><p>
- If the <code class="filename">po/</code> directory
- does not exist, you can create it and the translation
- template file with the following commands:
- </p><pre class="screen">
+ </p></td></tr></table></div></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a name="sn-translating-with-apps"></a>4.3. Using Translation Applications</h3></div></div></div><p>
+ If the <code class="filename">po/</code> directory does
+ not exist, you can create it and the translation template file
+ with the following commands:
+ </p><pre class="screen">
<code class="command">mkdir po</code>
<code class="command">cvs add po/</code>
<code class="command">make pot</code>
-</pre></td></tr></table></div><p>
+</pre><p>
To work with a <code class="filename">.po</code> editor
like <span><strong class="application">KBabel</strong></span> or
<span><strong class="application">gtranslator</strong></span>, follow these
@@ -105,18 +103,15 @@
to translate:
</p><pre class="screen">
<code class="command">cd ~/docs/example-tutorial</code>
-</pre></li><li><p>
- In the <code class="filename">Makefile</code>, add your translation
- language code to the <code class="varname">OTHERS</code> variable:
- </p><pre class="screen">
-<code class="computeroutput">OTHERS = it <strong class="userinput"><code><em class="replaceable"><code>pt_BR</code></em></code></strong></code>
-</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Disabled Translations"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="./stylesheet-images/note.png"></td><th align="left">Disabled Translations</th></tr><tr><td align="left" valign="top"><p>
- Often, if a translation is not complete, document editors
- disable it by putting it behind a comment sign (#) in
- the <code class="varname">OTHERS</code> variable. To enable a
- translation, make sure it <span class="emphasis"><em>precedes</em></span>
- any comment sign.
- </p></td></tr></table></div></li><li><p>
+</pre></li><li><p>To add your locale, you must locate and change the
+ appropriate locale list. Some documents are using the
+ <code class="filename">po/LINGUAS</code> file, as standardized in the
+ GNOME project, to track locales. Some documents have not
+ been updated to this standard yet. If you find the module
+ you are translating has not been updated, notify the Fedora Documentation Project
+ or file a bug using Bugzilla.</p><p>In the <code class="filename">po/LINGUAS</code>, add your
+ translation language code to the list. <span class="emphasis"><em>Keep the
+ list in alphabetical order.</em></span></p></li><li><p>
Make a new <code class="filename">.po</code> file
for your locale:
</p><pre class="screen">
@@ -140,13 +135,13 @@
commit time.
</p><pre class="screen">
<code class="command">cvs ci -m <em class="replaceable"><code>'Message about commit'</code></em> po/<em class="replaceable"><code>pt_BR</code></em>.po</code>
-</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Committing the Makefile"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="./stylesheet-images/important.png"></td><th align="left">Committing the <code class="filename">Makefile</code></th></tr><tr><td align="left" valign="top"><p>
- <span class="emphasis"><em>Do not commit the <code class="filename">Makefile</code>
+</pre><p>
+ <span class="emphasis"><em>Do not commit the <code class="filename">Makefile</code>
until your translation is finished.</em></span> To do so,
- run this command:
- </p><pre class="screen">
+ run this command:
+ </p><pre class="screen">
<code class="command">cvs ci -m 'Translation to <em class="replaceable"><code>pt_BR</code></em> finished' Makefile</code>
-</pre></td></tr></table></div><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Caution: Do Not Make Manual POT Changes"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="./stylesheet-images/caution.png"></td><th align="left">Do Not Make Manual POT Changes</th></tr><tr><td align="left" valign="top"><p>Authors and editors generate the POT file from the
+</pre><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Caution: Do Not Make Manual POT Changes"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="./stylesheet-images/caution.png"></td><th align="left">Do Not Make Manual POT Changes</th></tr><tr><td align="left" valign="top"><p>Authors and editors generate the POT file from the
source XML files, which overwrite any manual changes to a
POT file. If you find a problem in the original messages
of a POT file, visit Bugzilla at <a href="https://bugzilla.redhat.com"; target="_top">https://bugzilla.redhat.com</a> to file a bug
