Author: pfrields
Update of /cvs/fedora/web/html/docs/translation-quick-start-guide/en
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv30479/en
Modified Files:
index.php rv-revhistory.php sn_accounts.php
sn_translating_docs.php sn_translating_software.php
Log Message:
Update to 0.3.1 and push new translations. The "it" and "pt" versions
are now outdated and require additional translation.
Index: index.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/index.php,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- index.php 28 May 2006 15:38:25 -0000 1.4
+++ index.php 6 Jun 2006 23:52:29 -0000 1.5
@@ -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="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</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><dt><span
class="section"><a href="sn_translating_software.php">3.
Translating
Software</a></span></dt><dd><dl><dt><span
class="secti!
on"><a href="sn_translating_software.php#sn-translating-string!
s">3.1
ranslating 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-translating-with-apps">4.2. 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="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>
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 (2006-05-27).
+ translation-quick-start-guide-0.3.1 (2006-05-28).
</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: rv-revhistory.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/rv-revhistory.php,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- rv-revhistory.php 28 May 2006 15:38:25 -0000 1.4
+++ rv-revhistory.php 6 Jun 2006 23:52:29 -0000 1.5
@@ -7,7 +7,12 @@
?>
-<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</td><td align="left">2006-05-27</td><td
align="left">PWF</td></tr><tr><td align="left"
colspan="3">
+<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">
+ <p>
+ Add information on common entities and admonition for disabled
+ locales
+ </p>
+ </td></tr><tr><td align="left">Revision
0.3</td><td align="left">2006-05-27</td><td
align="left">PWF</td></tr><tr><td align="left"
colspan="3">
<p>
Fix procedural guide and include document-specific entities
</p>
Index: sn_accounts.php
===================================================================
RCS file: /cvs/fedora/web/html/docs/translation-quick-start-guide/en/sn_accounts.php,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- sn_accounts.php 28 May 2006 15:38:25 -0000 1.4
+++ sn_accounts.php 6 Jun 2006 23:52:29 -0000 1.5
@@ -7,47 +7,51 @@
?>
-<div class="navheader"><table width="100%"
summary="Navigation header"><tr><th colspan="3"
align="center">2.��Accounts and
Subscriptions</th></tr><tr><td width="20%"
align="left"><a accesskey="p"
href="index.php">Prev</a>��</td><th width="60%"
align="center">��</th><td width="20%"
align="right">��<a accesskey="n"
href="sn_translating_software.php">Next</a></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_accounts"></a>2.��Accounts and
Subscriptions</h2></div></div></div><p>
- To participate in the Fedora Project as a translator you need an account.
- You can apply for an account at <a
href="http://i18n.redhat.com/cgi-bin/i18n-signup/"
target="_top">http://i18n.redhat.com/cgi-bin/i18n-signup/<...;. You need
to
- provide a user name, an email address, a target language ���
- most likely your native language ��� and the public part of
- your SSH key.
- </p><p>
- If you do not have a SSH key yet, you can generate one using the
- following steps:
- </p><div class="procedure"><ol
type="1"><li><p>
- Type in a comand line:
- </p><pre class="screen">
+<div class="navheader"><table width="100%"
summary="Navigation header"><tr><th colspan="3"
align="center">2.��Accounts and
Subscriptions</th></tr><tr><td width="20%"
align="left"><a accesskey="p"
href="index.php">Prev</a>��</td><th width="60%"
align="center">��</th><td width="20%"
align="right">��<a accesskey="n"
href="sn_translating_software.php">Next</a></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_accounts"></a>2.��Accounts and
Subscriptions</h2></div></div></div><div
class="section" lang="en-US"><div
class="titlepage"><div><div><h3
class="title"><a name="sn-ssh-key"></a>2.1.��Making an
SSH Key</h3></div></div></div><p>
+ If you do not have a SSH key yet, generate one using the
+ following steps:
+ </p><div class="procedure"><ol
type="1"><li><p>
+ Type in a comand line:
+ </p><pre class="screen">
<code class="command">ssh-keygen -t dsa</code>
</pre><p>
- 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
- 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>
- directory:
- </p><pre class="screen">
+ 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
+ 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>
+ directory:
+ </p><pre class="screen">
<code class="command">chmod 700 ~/.ssh</code>
</pre></li><li><p>
- Copy and paste the SSH key in the space provided in order to
- complete the account application.
- </p></li></ol></div><p>
- There are also two lists where you can discuss translation issues.
- The first is <em class="firstterm">fedora-trans-list</em>, a
general
- list to discuss problems that affect all languages. Refer to
- <a
href="http://www.redhat.com/archives/fedora-trans-list"
target="_top">http://www.redhat.com/archives/fedora-trans-li...
- for more information. The second is the language-specific list,
- such as <em class="firstterm">fedora-trans-es</em> for
Spanish
- translators, to discuss issues that affect only the individual
- community of translators.
- </p><div class="tip" style="margin-left: 0.5in; margin-right:
0.5in;"><table border="0" summary="Tip: General Documentation
Issues"><tr><td rowspan="2" align="center"
valign="top" width="25"><img alt="[Tip]"
src="./stylesheet-images/tip.png"></td><th
align="left">General Documentation
Issues</th></tr><tr><td align="left"
valign="top"><p>
- You may also find it useful to subscribe to
- <em class="firstterm">fedora-docs-list</em> to stay informed
about
- general documentation issues.
- </p></td></tr></table></div></div><div
class="navfooter"><hr><table width="100%"
summary="Navigation footer"><tr><td width="40%"
align="left"><a accesskey="p"
href="index.php">Prev</a>��</td><td width="20%"
align="center">��</td><td width="40%"
align="right">��<a accesskey="n"
href="sn_translating_software.php">Next</a></td></tr><tr><td
width="40%" align="left" valign="top">Translation Quick
Start Guide��</td><td width="20%" align="center"><a
accesskey="h" href="index.php">Home</a></td><td
width="40%" align="right" valign="top">��3.��Translating
Software</td></tr></table></div>
+ Copy and paste the SSH key in the space provided in order to
+ complete the account application.
+ </p></li></ol></div></div><div
class="section" lang="en-US"><div
class="titlepage"><div><div><h3
class="title"><a
name="sn-accounts-trans"></a>2.2.��Accounts for Program
Translation</h3></div></div></div><p>
+ To participate in the Fedora Project as a translator you need an account.
+ You can apply for an account at <a
href="http://i18n.redhat.com/cgi-bin/i18n-signup/"
target="_top">http://i18n.redhat.com/cgi-bin/i18n-signup/<...;. You
need
+ to provide a user name, an email address, a target language
+ ��� most likely your native language ��� and the public
+ part of your SSH key.
+ </p><p>
+ There are also two lists where you can discuss translation
+ issues. The first is <em class="firstterm">fedora-trans-list</em>,
a
+ general list to discuss problems that affect all languages.
+ Refer to <a
href="http://www.redhat.com/archives/fedora-trans-list"
target="_top">http://www.redhat.com/archives/fedora-trans-li... for
+ more information. The second is the language-specific list,
+ such as <em class="firstterm">fedora-trans-es</em> for Spanish
+ 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
+ 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/</...;. 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-...;.
+ </p><p>
+ You should also post a self-introduction to the Fedora Documentation Project mailing
+ list. For details, refer to <a
href="http://fedoraproject.org/wiki/DocsProject/SelfIntroduction"
target="_top">http://fedoraproject.org/wiki/DocsProject/Self...;.
+ </p></div></div><div
class="navfooter"><hr><table width="100%"
summary="Navigation footer"><tr><td width="40%"
align="left"><a accesskey="p"
href="index.php">Prev</a>��</td><td width="20%"
align="center">��</td><td width="40%"
align="right">��<a accesskey="n"
href="sn_translating_software.php">Next</a></td></tr><tr><td
width="40%" align="left" valign="top">Translation Quick
Start Guide��</td><td width="20%" align="center"><a
accesskey="h" href="index.php">Home</a></td><td
width="40%" align="right" valign="top">��3.��Translating
Software</td></tr></table></div>
<?
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.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- sn_translating_docs.php 28 May 2006 15:38:25 -0000 1.4
+++ sn_translating_docs.php 6 Jun 2006 23:52:29 -0000 1.5
@@ -36,7 +36,29 @@
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-translating-with-apps"></a>4.2.��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/
+ </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>
+ 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>.
+ </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.
+ </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
+ legal notice:
+ </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>
+ 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></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
@@ -61,7 +83,13 @@
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></li><li><p>
+</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
+ 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>
Make a new <code class="filename">.po</code> file
for your locale:
</p><pre class="screen">