web/html/docs/translation-quick-start-guide/en index.php, 1.5, 1.6 ln-legalnotice-opl.php, 1.1, 1.2 rv-revhistory.php, 1.5, 1.6 sn_accounts.php, 1.5, 1.6 sn_translating_docs.php, 1.5, 1.6 sn_translating_software.php, 1.5, 1.6
by Paul W. Frields (pfrields)
Author: pfrields
Update of /cvs/fedora/web/html/docs/translation-quick-start-guide/en
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6923/translation-quick-start-guide/en
Modified Files:
index.php ln-legalnotice-opl.php rv-revhistory.php
sn_accounts.php sn_translating_docs.php
sn_translating_software.php
Log Message:
Update English TQSG to 0.3.3
Index: index.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/index.php,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- index.php 6 Jun 2006 23:52:29 -0000 1.5
+++ index.php 8 Aug 2006 12:27:02 -0000 1.6
@@ -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"><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><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><p class="othercredit"><span class="firstname">Hugo</span> <span class="surname">Cisneiros</span></p></div><div><p class="othercredit"><span class="firstn!
ame">Francesco</span> <span class="surname">Tombolini</span></p></div><div><p class="othercredit"><span class="firstname">Andrew</span> <span class="surname">Martynov</span></p></div><div><p class="othercredit"><span class="firstname">Jos��</span> <span class="surname">Pires</span></p></div><div><p class="othercredit"><span class="firstname">Bart</span> <span class="surname">Courveur</span></p></div><div><p class="copyright">Copyright �� 2005, 2006 Red Hat, Inc., Manuel Ospina</p></div><div><p class="copyright">Copyright �� 2006 Paul W. Frields, Hugo Cisneiros, Francesco Tombolini, Andrew Martynov, Jos�� Pires, Bart Couvreur</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.
king an SSH Key</a></span></dt><dt><span class="section"><a href="sn_accounts.php#sn-accounts-trans">2.2. Accounts for Program 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-entities">4.2. Creating Common Entities!
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-intro"></a>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"><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><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><p class="othercredit"><span class="firstname">Hugo</span> <span class="surname">Cisneiros</span></p></div><div><p class="othercredit"><span class="firstn!
ame">Francesco</span> <span class="surname">Tombolini</span></p></div><div><p class="othercredit"><span class="firstname">Andrew</span> <span class="surname">Martynov</span></p></div><div><p class="othercredit"><span class="firstname">Jos��</span> <span class="surname">Pires</span></p></div><div><p class="othercredit"><span class="firstname">Bart</span> <span class="surname">Courveur</span></p></div><div><p class="othercredit"><span class="firstname">Dimitris</span> <span class="surname">Glezos</span></p></div><div><p class="othercredit"><span class="firstname">Damien</span> <span class="surname">Durand</span></p></div><div><p class="copyright">Copyright �� 2005, 2006 Red Hat, Inc., Manuel Ospina</p></div><div><p class="copyright">Copyright �� 2006 Paul W. Frields, Hugo Cisneiros, Francesco Tombolini, Andrew Martynov, Jos�� Pires, Bart Couvreur, Dimitris Glezos, Damien Durand</p></div><div><a href="ln-legalnotice-opl.php">Legal Notice</a></div><div><a href="rv-revhistory.ph!
p">Revision History</a></div></div><hr></div><div class="toc">!
<dl><d
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 Program 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-intro"></a>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
@@ -18,7 +18,7 @@
at <a href="http://bugzilla.redhat.com" target="_top">http://bugzilla.redhat.com</a>. When you file your bug, select "Fedora Documentation" as the
<code class="systemitem">Product</code>, and select the title of this document as
the <code class="systemitem">Component</code>. The version of this document is
- translation-quick-start-guide-0.3.1 (2006-05-28).
+ translation-quick-start-guide-0.3.3 (2006-08-06).
</p><p>
The maintainers of this document will automatically receive your bug report.
On behalf of the entire Fedora community, thank you for helping us make
Index: ln-legalnotice-opl.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/ln-legalnotice-opl.php,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ln-legalnotice-opl.php 8 Aug 2006 12:16:40 -0000 1.1
+++ ln-legalnotice-opl.php 8 Aug 2006 12:27:02 -0000 1.2
@@ -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="id2922869"></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="id2733696"></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="id2936979"></a>COPYRIGHT</h2><p>
+ </p></li><li><a name="opl.copyright"></a><h2><a name="id2729527"></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="id2920288"></a>SCOPE OF LICENSE</h2><p>
+ </p></li><li><a name="opl.scope"></a><h2><a name="id2720429"></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="id2921618"></a>REQUIREMENTS ON MODIFIED WORKS</h2><p>
+ </p></li><li><a name="opl.modified.works"></a><h2><a name="id2731182"></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="id2910378"></a>GOOD-PRACTICE RECOMMENDATIONS</h2><p>
+ </p></li></ol></div></li><li><a name="opl.good-practice"></a><h2><a name="id2728446"></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="id2923524"></a>LICENSE OPTIONS</h2><p>
+ </p></li></ol></div></li><li><a name="opl.options"></a><h2><a name="id2750482"></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/rv-revhistory.php,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- rv-revhistory.php 6 Jun 2006 23:52:29 -0000 1.5
+++ rv-revhistory.php 8 Aug 2006 12:27:02 -0000 1.6
@@ -7,7 +7,17 @@
?>
-<div class="revhistory"><div class="revhistory"><table border="1" width="100%" summary="Revision history - Translation Quick Start Guide"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.3.1</td><td align="left">2006-05-28</td><td align="left">PWF</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.3</td><td align="left">2006-08-06</td><td align="left">PWF</td></tr><tr><td align="left" colspan="3">
+ <p>
+ Remove step for translating rpm-info since this is now part of
+ document POT
+ </p>
+ </td></tr><tr><td align="left">Revision 0.3.2</td><td align="left">2006-07-03</td><td align="left">PWF</td></tr><tr><td align="left" colspan="3">
+ <p>
+ Fix doc translation procedure to include other common files
+ translations
+ </p>
+ </td></tr><tr><td align="left">Revision 0.3.1</td><td align="left">2006-05-28</td><td align="left">PWF</td></tr><tr><td align="left" colspan="3">
<p>
Add information on common entities and admonition for disabled
locales
@@ -45,7 +55,7 @@
<p>
First draft
</p>
- </td></tr></table></div></div>
+ </td></tr></table></div>
<?
Index: sn_accounts.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/sn_accounts.php,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- sn_accounts.php 6 Jun 2006 23:52:29 -0000 1.5
+++ sn_accounts.php 8 Aug 2006 12:27:02 -0000 1.6
@@ -18,7 +18,7 @@
Accept the default location
(<code class="filename">~/.ssh/id_dsa</code>) and enter a passphrase.
</p><div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Caution: Don't Forget Your Passphrase!"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="./stylesheet-images/caution.png"></td><th align="left">Don't Forget Your Passphrase!</th></tr><tr><td align="left" valign="top"><p>
- You will need your passphrase to access to the CVS
+ You must have your passphrase to access to the CVS
repository. It cannot be recovered if you forget it.
</p></td></tr></table></div></li><li><p>
Change permissions to your key and <code class="filename">.ssh</code>
@@ -44,7 +44,7 @@
translators, to discuss issues that affect only the individual
community of translators.
</p></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a name="sn-accounts-docs"></a>2.3.��Accounts for Documentation</h3></div></div></div><p>
- If you plan to translate Fedora documentation, you will need a
+ If you plan to translate Fedora documentation, you must have a
Fedora CVS account and membership on the Fedora Documentation Project mailing list. To
sign up for a Fedora CVS account, visit <a href="https://admin.fedora.redhat.com/accounts/" target="_top">https://admin.fedora.redhat.com/accounts/</a>. To join
the Fedora Documentation Project mailing list, refer to <a href="http://www.redhat.com/mailman/listinfo/fedora-docs-list/" target="_top">http://www.redhat.com/mailman/listinfo/fedora-docs-list/</a>.
Index: sn_translating_docs.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/sn_translating_docs.php,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- sn_translating_docs.php 6 Jun 2006 23:52:29 -0000 1.5
+++ sn_translating_docs.php 8 Aug 2006 12:27:02 -0000 1.6
@@ -8,7 +8,7 @@
?>
<div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">4.��Translating Documentation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sn_translating_software.php">Prev</a>��</td><th width="60%" align="center">��</th><td width="20%" align="right">��</td></tr></table><hr></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sn_translating_docs"></a>4.��Translating Documentation</h2></div></div></div><p>
- To translate documentation, you need a Fedora Core 4 or later
+ To translate documentation, you need a Fedora Core 5 or later
system with the following packages installed:
</p><div class="itemizedlist"><ul type="disc"><li><p><span class="package">gnome-doc-utils</span></p></li><li><p><span class="package">xmlto</span></p></li><li><p><span class="package">make</span></p></li></ul></div><p>
To install these packages, use the following command:
@@ -36,13 +36,14 @@
translation <code class="filename">.po</code> files are
stored in the <code class="filename">po/</code>
directory.
- </p></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a name="sn-creating-entities"></a>4.2.��Creating Common Entities Files</h3></div></div></div><p>
+ </p></div><div class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a name="sn-creating-common"></a>4.2.��Creating Common Files</h3></div></div></div><p>
If you are creating the first-ever translation for a locale, you
- must first translate the common entities files. The common
- entities are located in <code class="filename">docs-common/common/entities</code>.
+ must first translate some common files used in all documents for
+ your locale. The common files are located in <code class="filename">docs-common/common/</code>.
</p><div class="procedure"><ol type="1"><li><p>
- Read the <code class="filename">README.txt</code> file in that module
- and follow the directions to create new entities.
+ Read the <code class="filename">README.txt</code> file in the
+ <code class="filename">docs-common/common/entities</code> and
+ follow the directions to create new entities.
</p></li><li><p>
Once you have created common entities for your locale and
committed the results to CVS, create a locale file for the
@@ -50,11 +51,30 @@
</p><pre class="screen">
<code class="command">cd docs-common/common/</code>
<code class="command">cp legalnotice-opl-en_US.xml legalnotice-opl-<em class="replaceable"><code>pt_BR</code></em>.xml</code>
-</pre></li><li><p>
+</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Important: Do Not Translate Legal Notice"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Important]" src="./stylesheet-images/important.png"></td><th align="left">Do Not Translate Legal Notice</th></tr><tr><td align="left" valign="top"><p>
+ To ensure it is legally equivalent in all locales, do not
+ translate the OPL.
+ </p></td></tr></table></div></li><li><p>
Then commit that file to CVS also:
</p><pre class="screen">
<code class="command">cvs add legalnotice-opl-<em class="replaceable"><code>pt_BR</code></em>.xml</code>
<code class="command">cvs ci -m 'Added legal notice for <em class="replaceable"><code>pt_BR</code></em>' legalnotice-opl-<em class="replaceable"><code>pt_BR</code></em>.xml</code>
+</pre></li><li><p>
+ Next, build the draft watermark for your locale in the
+ <code class="filename">docs-common/images/</code>
+ folder:
+ </p><pre class="screen">
+<code class="command">cd docs-common/images/</code>
+<code class="command">cp watermark-en_US.svg watermark-<em class="replaceable"><code>pt_BR</code></em>.svg</code>
+</pre><p>
+ Translate the <code class="sgmltag-element">text</code>
+ elements in the SVG. Then add your locale's SVG file to the
+ <code class="filename">Makefile</code>, produce the PNG and commit
+ the results:
+ </p><pre class="screen">
+<code class="command">make watermark-<em class="replaceable"><code>pt_BR</code></em>.png</code>
+<code class="command">cvs add watermark-<em class="replaceable"><code>pt_BR</code></em>*</code>
+<code class="command">cvs ci -m 'Added <em class="replaceable"><code>pt_BR</code></em> images' Makefile watermark-<em class="replaceable"><code>pt_BR</code></em>*</code>
</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.
@@ -84,8 +104,8 @@
</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 are not complete, document editors
- will disable it by putting it behind a comment sign (#) in
+ 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.
Index: sn_translating_software.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/sn_translating_software.php,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- sn_translating_software.php 6 Jun 2006 23:52:29 -0000 1.5
+++ sn_translating_software.php 8 Aug 2006 12:27:02 -0000 1.6
@@ -90,7 +90,7 @@
</p><pre class="screen">
<code class="command">LANG=<em class="replaceable"><code>lang</code></em> rpm -qi <em class="replaceable"><code>package_name</code></em></code>
</pre></li></ol></div><p>
- The application related to the translated package will run with
+ The application related to the translated package runs with
the translated strings.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sn_accounts.php">Prev</a>��</td><td width="20%" align="center">��</td><td width="40%" align="right">��<a accesskey="n" href="sn_translating_docs.php">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.��Accounts and Subscriptions��</td><td width="20%" align="center"><a accesskey="h" href="index.php">Home</a></td><td width="40%" align="right" valign="top">��4.��Translating Documentation</td></tr></table></div>
