translation-guide-windows/en_US rpm-info.xml, NONE, 1.1 translate-windows.xml, NONE, 1.1
Paul W. Frields (pfrields)
fedora-docs-commits at redhat.com
Sun Jul 15 13:49:07 UTC 2007
Author: pfrields
Update of /cvs/docs/translation-guide-windows/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv15167/en_US
Added Files:
rpm-info.xml translate-windows.xml
Log Message:
Convert document to current FDP build toolchain standards. Hopefully someone will actually work on maintaining this document for the use of FDP contributors in the L10N project.
--- NEW FILE rpm-info.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Id: -->
<!DOCTYPE rpm-info PUBLIC "-//Fedora//DTD Docs RPM-INFO V1.0//EN"
"../docs-common/packaging/rpm-info.dtd">
<rpm-info>
<colophon>
<worker id="ChesterCheng" wholename="Chester Cheng"
email="ccheng at redhat.com" surname="Cheng" firstname="Chester"
initials="CC"/>
<worker id="PaulWFrields" wholename="Paul W. Frields"
email="stickster at gmail.com" surname="Frields" firstname="Paul"
othername="W." initials="PWF"/>
</colophon>
<author worker="ChesterCheng"/>
<license>
<rights>OPL</rights>
<version>1.0</version>
</license>
<copyright>
<year>2004, 2007</year>
<holder>Red Hat, Inc. and others</holder>
</copyright>
<title>Translate Fedora in Microsoft Windows</title>
<desc>How to translate Fedora resources using Microsoft Windows</desc>
<changelog order="newest-first">
<revision date="2007-07-15" number="0.1.5">
<author worker="PaulWFrields"/>
<details>Update file sources to current FDP standards</details>
</revision>
<revision date="2004-09-16" number="0.1">
<author worker="ChesterCheng"/>
<details>Initial release</details>
</revision>
</changelog>
</rpm-info>
--- NEW FILE translate-windows.xml ---
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
<!ENTITY BOOKID "how-to-translate-fedora-in-windows-0.1 (2004-09-16)"> <!-- change version of manual and date here -->
<!ENTITY LEGALNOTICE SYSTEM "../docs-common/common/legalnotice-en.xml">
]>
<article id="windows-howto" lang="en">
<articleinfo>
<title>Translate Fedora in <trademark
class="registered">Microsoft</trademark> <trademark class="registered">Windows</trademark></title>
<copyright>
<year>2004</year>
<holder>&FORMAL-RHI;</holder>
<holder>Chester Cheng</holder>
</copyright>
<authorgroup>
<author>
<surname>Cheng</surname>
<firstname>Chester</firstname>
</author>
</authorgroup>
&LEGALNOTICE;
</articleinfo>
<sect1 id="s1-intro">
<title>Introduction</title>
<indexterm>
<primary>Introduction</primary>
</indexterm>
<para>
To join the Fedora translation team and work with people around the world
is easy in <trademark class="registered">Microsoft</trademark> <trademark
class="registered">Windows</trademark> as well. To achieve this, several
tools are needed:
</para>
<itemizedlist>
<listitem>
<para>
A Web Browser that supports cookies
</para>
</listitem>
<listitem>
<para>
A <application>Concurrent Versions System</application> (<acronym>CVS</acronym>) client —
This artical uses <application>TortoiseCVS</application>
</para>
</listitem>
<listitem>
<para>
An editor for <filename>.po</filename> files — This article uses <application>poEdit</application>
</para>
</listitem>
<listitem>
<para>
A Secury Shell (<acronym>ssh</acronym>) client — This article uses <application>puttygen</application>
which is a free utility that generates personalized digital ID, using public key infrastructure.
This utility is bundled within <application>TortoiseCVS</application>
</para>
</listitem>
</itemizedlist>
<para>
This article will introduce you where to find and download these tools, how to install and setup,
and even a brief description of how to use them.
</para>
</sect1>
<sect1 id="s1-cvs">
<title>Download and Install <application>TortoiseCVS</application></title>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>download</secondary>
</indexterm>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>install</secondary>
</indexterm>
<para>
To download <application>TortoiseCVS</application>, go to:
<screen>
<ulink url="http://www.tortoisecvs.org/download.shtml">http://www.tortoisecvs.org/download.shtml</ulink>
</screen>
For demonstration purpose, this artical uses <filename>TortoiseCVS-1.6.14</filename>.
</para>
<para>
To install <application>TortoiseCVS</application>, double-click the file you just downloaded.
The following screenshots illustrate the installation process step by step:
</para>
<itemizedlist>
<listitem>
<para>
Step 1: Welcome to TortoiseCVS setup (as shown in
<xref linkend="fig-tortoise-setup1"/>). Press <guibutton>Next></guibutton> to continue.
</para>
</listitem>
<listitem>
<para>
Step 2: Select destination directory (as shown in <xref linkend="fig-tortoise-setup2"/>).
Customize your directory or press <guibutton>Next></guibutton>
to accept the default setting.
</para>
</listitem>
<listitem>
<para>
Step 3: Select components (as shown in <xref linkend="fig-tortoise-setup3"/>).
To accept <emphasis>full</emphasis> installation, press <guibutton>Next></guibutton>.
</para>
</listitem>
<listitem>
<para>
Step 4: Installing (as shown in <xref linkend="fig-tortoise-setup4"/>).
</para>
</listitem>
<listitem>
<para>
Step 5: To make changes take effect, you need to restart the computer. Press
<guibutton>Finish</guibutton> to restart (as shown in <xref linkend="fig-tortoise-setup5"/>).
</para>
</listitem>
</itemizedlist>
<figure id="fig-tortoise-setup1">
<title>Welcome to TortoiseCVS setup</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image001.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image001.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Welcome to TortoiseCVS setup.
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-tortoise-setup2">
<title>Select Destination Directory</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image002.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image002.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Select destination directory.
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-tortoise-setup3">
<title>Select Components</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image003.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image003.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Select components.
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-tortoise-setup4">
<title>Installing</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image004.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image004.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Installing.
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-tortoise-setup5">
<title>Finish</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image005.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/image005.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Finish.
</phrase>
</textobject>
</mediaobject>
</figure>
</sect1>
<sect1 id="s1-ssh">
<title>Generate Your Digital ID</title>
<indexterm>
<primary>SSH keys</primary>
</indexterm>
<para>
For security purpose, a pair of keys — private key and public key — is required to identify yourself.
To generate the key pair, open your <application>Windows Explorer</application>, and go to
<filename>C:\Program Files\TortoiseCVS</filename> (or other folder where you installed
<application>TortoiseCVS</application>), then double-click <filename>puttygen.exe</filename> as shown
in <xref linkend="fig-key-setup1"/>.
</para>
<figure id="fig-key-setup1">
<title>Start puttygen Program</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/key/image001.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/key/image001.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Start puttygen program.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Choose SSH2 DSA in <guilabel>Parameters</guilabel> (step 1), then press
<guibutton>Generate</guibutton> (step 2) as shown
in <xref linkend="fig-key-setup2"/>.
</para>
<figure id="fig-key-setup2">
<title>Generate DSA Keys</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/key/image002.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/key/image002.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Generate dsa keys.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Move your mouse around the screen to generate the key pairs, as shown in <xref linkend="fig-key-setup3"/>.
</para>
<figure id="fig-key-setup3">
<title>Key Generation In Progress</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/key/image003.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/key/image003.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Key generation in progress.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
After the key pair is generated, enter some comment for this key pair (or accept the default comment).
Don’t forget to input the <firstterm>key passphrase</firstterm> twice to protect your private key.
This “key passphrase†will be used every time you connect to the Fedora CVS repository to get the
latest documents. (As shown in <xref linkend="fig-key-setup4"/> step 1.)
</para>
<important>
<title>Important</title>
<para>
It is very important to save your public and private keys in a safe place.
To save these keys, press <guibutton>Save public key</guibutton> and <guibutton>Save private key</guibutton>
as shown in <xref linkend="fig-key-setup4"/> step 2.
</para>
</important>
<figure id="fig-key-setup4">
<title>Key Generation In Progress</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/key/image004.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/key/image004.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Key generation in progress.
</phrase>
</textobject>
</mediaobject>
</figure>
<tip>
<title> Tip </title>
<para>
The text circled in yellow (<xref linkend="fig-key-setup4"/>) is your public key that needs
to be copied and pasted when registering an
account (refer to <xref linkend="s1-reg"/> for more information). You may want to leave this windows open
for later use.
</para>
</tip>
<note>
<title> Note </title>
<para>
It doesn’t matter where you save your keys
or what filenames you save them as. In this example, the filename <filename>id_dsa.ppk</filename> is used.
It is also important to make a copy of your key pairs and store in a safe place.
</para>
</note>
</sect1>
<sect1 id="s1-reg">
<title>Register Your Fedora Account</title>
<indexterm>
<primary>Fedora Account</primary>
<secondary>register</secondary>
</indexterm>
<para>
It is essential to have an account and password to access Fedora translation CVS.
To become a translator please sign up at:
<screen>
<ulink url="http://i18n.redhat.com/cgi-bin/i18n-signup/">http://i18n.redhat.com/cgi-bin/i18n-signup/</ulink>
</screen>
</para>
<para>
You need to provide your basic information include Login name, Real Name, a valid email address,
the language or locale you are going to translate, as well as the SSH public key that generated
from the previous step (refer to <xref linkend="s1-ssh"/> and <xref linkend="fig-key-setup4"/>).
This step is illustrated in <xref linkend="fig-account-setup1"/>.
</para>
<figure id="fig-account-setup1">
<title>Account Sign up Screen</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/account/image001.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/account/image001.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Account Sign up screen.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Press <guibutton>Continue</guibutton> once you are done. The next screen (<xref linkend="fig-account-setup2"/>)
shows your account detail. Press <guibutton>Submit</guibutton> to confirm.
</para>
<figure id="fig-account-setup2">
<title>Confirm Account Details</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/account/image002.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/account/image002.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Confirm account details.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
An email will be sent to the email address you provided advising your application is being processed.
Once the account is approved another email will be sent to you advising your login name and
<firstterm>PIN code</firstterm>. The example email is shown in <xref linkend="fig-account-setup3"/>.
</para>
<figure id="fig-account-setup3">
<title>Example Email</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/account/image003.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/account/image003.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Example email.
</phrase>
</textobject>
</mediaobject>
</figure>
<note>
<title> Note </title>
<para>
In the example, the Login name is <wordasword>snowlet</wordasword>, while the PIN code is
<wordasword>0000</wordasword>. They are the information you use to access Fedora
translation status page, to take or release a file, to apply to be a maintainer,
or to approve a QA'ed file.
</para>
</note>
<para>
Once the account is activated, we can setup <application>TortoiseCVS</application> to
download Fedora files.
</para>
</sect1>
<sect1 id="s1-setup">
<title>Using TortoiseCVS</title>
<sect2 id="s2-setup-setup">
<title> Set up <application>TortoiseCVS</application> </title>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>setup</secondary>
</indexterm>
<para>
To connect <application>TortoiseCVS</application> to Fedora Translation Project CVS repository, you
need to first setup the environment. These steps only need be done once. Right-click in
<application>Windows Explorer</application>, choose <guimenu>CVS</guimenu> =>
<guimenuitem>Preferences…</guimenuitem> as shown in <xref linkend="fig-setup-setup1"/>.
</para>
<figure id="fig-setup-setup1">
<title>Setup Preferences</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/setup/image001.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/setup/image001.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Setup preferences.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>In <guilabel>Preferences</guilabel> popup window, click the <guilabel>Tools</guilabel> tab.
Add the parameter <option>–i <replaceable><Your Private Key></replaceable></option> as shown in
<xref linkend="fig-setup-setup2"/>. <replaceable><Your Private Key></replaceable> is the private
key you generated and saved on your computer. Its corresponding public key has been
used to apply the Fedora account in <xref linkend="fig-account-setup1"/>.
</para>
<figure id="fig-setup-setup2">
<title>TortoiseCVS Preferences Window - Tools</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/setup/image002.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/setup/image002.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
TortoiseCVS Preferences Window - Tools
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
The next thing needs to be setup is <guilabel>Network compression</guilabel> (as shown in
<xref linkend="fig-setup-setup3"/>), which will effectively speedup checkout process.
Set <userinput>9 - Best</userinput> for best compression if you have a powerful CPU.
</para>
<para>
Press <guibutton>OK</guibutton> when you're done. Now you are ready to download files from the Fedora server.
</para>
<figure id="fig-setup-setup3">
<title>TortoiseCVS Preferences Window - Advanced</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/setup/image003.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/setup/image003.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
TortoiseCVS Preferences Window - Advanced
</phrase>
</textobject>
</mediaobject>
</figure>
</sect2>
<sect2 id="s2-setup-download">
<title> Download Files from Fedora Server </title>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>connecting to cvs server</secondary>
</indexterm>
<para>
To download files from the Fedora server for the first time, it is important to tell
<application>TortoiseCVS</application> where to find them. Again, these only need to be done once.
The information are in the email sent to you when your account is activated. You may refer to the
following example, but don't forget to change 'snowlet' into your own username.
</para>
<para>
To start this, right click in <application>Windows Explorer</application>, choose
<guimenuitem>CVS checkout</guimenuitem> (also referred as "cvs co"). See <xref linkend="fig-account-setup31"/>.
</para>
<figure id="fig-account-setup31">
<title>CVS Checkout Menu</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_right_click_menu.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_right_click_menu.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
CVS Checkout menu.
</phrase>
</textobject>
</mediaobject>
</figure>
<note>
<title> Note </title>
<para>
Sometimes <guimenuitem>CVS checkout</guimenuitem> menu just doesn't appear.
Try to perform this action in "C:\" root directory.
</para>
</note>
<para>
You can find the <wordasword>CVSROOT</wordasword> in the email Fedora had sent you.
The information in <xref linkend="fig-account-setup32"/> is for your reference only. Don't forget to change the
<guilabel>User name:</guilabel> field to match your own account. The module for Fedora translation
is <filename>translate</filename>.
</para>
<figure id="fig-account-setup32">
<title>CVS Root and Module</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_cvsroot_module.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_cvsroot_module.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
CVS root and module.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Press <guibutton>OK</guibutton> will lead you to <xref linkend="fig-account-setup33"/>.
</para>
<figure id="fig-account-setup33">
<title>TortoisePlink</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_tortoisePlink.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_tortoisePlink.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
TortoisePlink.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Here, <application>TortoiseCVS</application> is trying to connect Fedora CVS repository to get all
the files needed. Your passphrase of your private key is required before you go on. Press
<guibutton>OK</guibutton> after you input the passphrase.
</para>
<para>
<application>TortoiseCVS</application> is downloading files from Fedora server
(<xref linkend="fig-tortoise-co"/>). It's time to take a
break before we go on to the next screen.
</para>
<figure id="fig-tortoise-co">
<title>Checking out Files</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_co.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_co.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Checking out files.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Done! You'll find a folder called <filename>translate</filename> that contains all the files for
different locales and packages (<xref linkend="fig-tortoise-cvs20"/>).
</para>
<figure id="fig-tortoise-cvs20">
<title>"translate" Folder</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs20.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs20.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
"translate" folder.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
To edit these files, you can use plain text editor, or specialised po file editors, such as
<application>poEdit</application>. The following section will discuss about this tool.
</para>
</sect2>
</sect1>
<sect1 id="s1-poedit">
<title> <application>poEdit</application> </title>
<sect2 id="s2-poedit-install">
<title>Download and Install poEdit</title>
<indexterm>
<primary>poEdit</primary>
<secondary>download</secondary>
</indexterm>
<indexterm>
<primary>poEdit</primary>
<secondary>install</secondary>
</indexterm>
<para>
To download <application>poEdit</application>, go to
<screen>
<ulink url="http://poedit.sourceforge.net/download.php#win32">http://poedit.sourceforge.net/download.php#win32
</ulink>
</screen>
For demonstration purpose, this article uses <filename>poEdit-1.3.1</filename>.
</para>
<para>
Installing <application>poEdit</application> is as easy and straight-forward as installing
<application>TortoiseCVS</application>. The main steps are:
</para>
<itemizedlist>
<listitem>
<para>
Step 1: Welcome. Double-click <filename>poEdit-1.3.1</filename> you just downloaded.
A screen similar to <xref linkend="fig-poedit-setup1"/> will appear
</para>
</listitem>
<listitem>
<para>
Step 2: You need to accept the agreement before you go on. See <xref linkend="fig-poedit-setup2"/>
</para>
</listitem>
<listitem>
<para>
Step 3: Select Destination Location. See <xref linkend="fig-poedit-setup3"/>
</para>
</listitem>
<listitem>
<para>
Step 4: Full installation is the default setting of component selection. Press
<guibutton>Next></guibutton> to accept. See <xref linkend="fig-poedit-setup4"/>
</para>
</listitem>
<listitem>
<para>
Step 5: Create a folder in the Start menu. See <xref linkend="fig-poedit-setup5"/>
</para>
</listitem>
<listitem>
<para>
Step 6: Final review of all the settings. Press <guibutton>Install</guibutton>
to accept. See <xref linkend="fig-poedit-setup6"/>
</para>
</listitem>
<listitem>
<para>
Step 7: Installing. See <xref linkend="fig-poedit-setup7"/>
</para>
</listitem>
<listitem>
<para>
Step 8: Finish! See <xref linkend="fig-poedit-setup8"/>
</para>
</listitem>
</itemizedlist>
<figure id="fig-poedit-setup1">
<title>Welcome</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image001.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image001.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Welcome
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup2">
<title>Licience Agreement</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image002.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image002.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Licience agreement
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup3">
<title>Select Destination Location</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image003.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image003.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Select destination location
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup4">
<title>Select Components</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image004.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image004.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Select components
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup5">
<title>Select Start Menu Folder</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image005.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image005.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Select start menu folder
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup6">
<title>Ready To Install</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image006.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image006.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Ready to install
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup7">
<title>Installing</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image007.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image007.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Installing
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup8">
<title>Finish</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/image008.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/image008.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Finish
</phrase>
</textobject>
</mediaobject>
</figure>
</sect2>
<sect2 id="s2-poedit-setup">
<title>Setup poEdit</title>
<indexterm>
<primary>poEdit</primary>
<secondary>start</secondary>
</indexterm>
<indexterm>
<primary>poEdit</primary>
<secondary>setup</secondary>
</indexterm>
<para>
To start <application>poEdit</application>, click <guimenu>start</guimenu> =>
<guimenuitem>All Programs</guimenuitem> => <guimenuitem>poEdit</guimenuitem> =>
<guimenuitem>poEdit</guimenuitem>. You will a screen similar to <xref linkend="fig-poedit-setup9"/>.
</para>
<figure id="fig-poedit-setup9">
<title>Starting poEdit</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/poEdit_start.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/poEdit_start.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Starting poEdit.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
To configure <application>poEdit</application>, go to <guimenu>File</guimenu> =>
<guimenuitem>Preferences</guimenuitem> (<xref linkend="fig-poedit-setup10"/>).
Enter your name and email address as shown in <xref linkend="fig-poedit-setup11"/>, then press
<guibutton>OK</guibutton>.
</para>
<figure id="fig-poedit-setup10">
<title>Preference Submenu</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/menu_preferences.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/menu_preferences.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Preference submenu
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-poedit-setup11">
<title>poEdit Preference Screen</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/poedit/preferences.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/poedit/preferences.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
poEdit Preference screen
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Huh~, finally! All the preparation has come to the end. In next section we'll step into
the real translation work.
</para>
</sect2>
</sect1>
<sect1 id="s1-cycle">
<title>Translation Lifecycle</title>
<indexterm>
<primary>Lifecycle</primary>
</indexterm>
<para>
To keep the consistency of all documents among Fedora repository and translators, a translation lifecycle is
being established. The life cycle involves 5 phases as shown in <xref linkend="tb-lifecycle"/>.
</para>
<table id="tb-lifecycle">
<title>Fedora PO file translation life cycle</title>
<tgroup cols="5">
<colspec colnum="1" colname="Phase" colwidth="1"/>
<colspec colnum="2" colname="Action" colwidth="2"/>
<colspec colnum="3" colname="Software" colwidth="2"/>
<colspec colnum="4" colname="Where" colwidth="2"/>
<colspec colnum="5" colname="Requires" colwidth="1"/>
<thead>
<row>
<entry>Phase</entry>
<entry>Action</entry>
<entry>Software</entry>
<entry>Where</entry>
<entry>Login Requires</entry>
</row>
</thead>
<tbody>
<row>
<entry><xref linkend="s2-cycle-1"/></entry>
<entry>Take the file you want to translate
(if no other translators took it)</entry>
<entry>Any Web broswer with cookies enabled</entry>
<entry><ulink url="http://i18n.redhat.com/cgi-bin/i18n-status">Fedora Translation Status Page</ulink></entry>
<entry>Login name and PIN code</entry>
</row>
<row>
<entry><xref linkend="s2-cycle-2"/></entry>
<entry>Download the latest file from Fedora repository</entry>
<entry><application>TortoiseCVS</application> or other CVS client</entry>
<entry>In <application>TortoiseCVS</application>, right click the <filename>translate</filename>
folder, choose <guimenuitem>CVS update</guimenuitem></entry>
<entry>Passphrase of your private key</entry>
</row>
<row>
<entry><xref linkend="s2-cycle-3"/></entry>
<entry>Edit the file you had taken.
Save before you finish</entry>
<entry><application>poEdit</application> or other editors</entry>
<entry>For <application>poEdit</application>, click <guimenu>start</guimenu> =>
<guimenuitem>All Programs</guimenuitem> => <guimenuitem>poEdit</guimenuitem> =>
<guimenuitem>poEdit</guimenuitem>, then open the file you want to edit in the
<filename>translate</filename> folder. Or double-click the file directly in
<application>Windows Explorer</application></entry>
<entry>N/A</entry>
</row>
<row>
<entry><xref linkend="s2-cycle-4"/></entry>
<entry>Upload your file back to Fedora repository</entry>
<entry><application>TortoiseCVS</application> or other CVS client</entry>
<entry>In <application>TortoiseCVS</application>, right click <filename>translate</filename>
folder, choose <guimenu>CVS update</guimenu>; Right click <filename>translate</filename> folder,
choose <guimenu>CVS commmit</guimenu> if there are no conflicts between files on your machine and the server.</entry>
<entry>Passphrase of your private key</entry>
</row>
<row>
<entry><xref linkend="s2-cycle-5"/></entry>
<entry>Release the file you have taken if you don't wish to translate any more</entry>
<entry>Any Web broswer with cookies enabled</entry>
<entry><ulink url="http://i18n.redhat.com/cgi-bin/i18n-status">Fedora Translation Status Page</ulink></entry>
<entry>Login name and PIN code</entry>
</row>
</tbody>
</tgroup>
</table>
<sect2 id="s2-cycle-1">
<title> Phase 1 </title>
<indexterm>
<primary>Status page</primary>
<secondary>take</secondary>
</indexterm>
<para>
Open your browser and go to:
<screen>
<ulink url="http://i18n.redhat.com/cgi-bin/i18n-status">http://i18n.redhat.com/cgi-bin/i18n-status</ulink>
</screen>
After select your language, you'll see a web page similar to <xref linkend="fig-cycle-1"/>.
In this example, po file in package <filename>dist</filename> has 839 entries untranslated and not taken
by any translator. To claim this file, press the <guibutton>Take</guibutton> link at the right hand side.
</para>
<figure id="fig-cycle-1">
<title>Take a File for Translation</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_take.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_take.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
To take a file for translation.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
If the file is not available for translation because someone else is working on it, you will see the
status as <guilabel>Assigned</guilabel>, as shown in <xref linkend="fig-cycle-2"/>.
</para>
<figure id="fig-cycle-2">
<title>File Has Been Taken</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_assigned.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_assigned.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
File has been taken.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
After click the <guibutton>Take</guibutton> link, you'll be prompted for username and password
(<xref linkend="fig-cycle-3"/>). Please enter your Login name and PIN code as described in
<xref linkend="fig-account-setup3"/>.
</para>
<figure id="fig-cycle-3">
<title>Username and Password Prompt</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_login.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_login.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Username and password prompt.
</phrase>
</textobject>
</mediaobject>
</figure>
<para> The system will assign the file to you after you successfully login (<xref
linkend="fig-cycle-4"/>), or display the error page upon unsuccessful login (<xref
linkend="fig-cycle-5"/>). Please email <ulink url="mailto:i18n at redhat.com">i18n at redhat.com</ulink>
to request your PIN code to be reissued if you have lost it.
</para>
<figure id="fig-cycle-4">
<title>File is Assigned to You</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_assign_to_you.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_assign_to_you.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
File is assigned to you.
</phrase>
</textobject>
</mediaobject>
</figure>
<figure id="fig-cycle-5">
<title>Authentication Failed</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_auth_denied.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_auth_denied.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Authentication failed.
</phrase>
</textobject>
</mediaobject>
</figure>
</sect2>
<sect2 id="s2-cycle-2">
<title> Phase 2 </title>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>cvs up</secondary>
</indexterm>
<para>
To download the latest files from server, please right-click on the <filename>translate</filename>
folder in <application>Windows Explorer</application> and select <guimenuitem>CVS Update</guimenuitem>
You'll be prompted to enter the passphrase of your private key before <application>TortoiseCVS</application>
can continue. <xref linkend="fig-cycle-6"/> illustrates.
</para>
<figure id="fig-cycle-6">
<title>Get Update Files from CVS</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Get update files from cvs repository.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
You'll see a screen similar to <xref linkend="fig-cycle-7"/> after the update successfully finished.
The letter "P" in front of any file stands for "patched", which means minor changes from the server had been
patched to your files; while "U" stands for "updated" that your file is overwritten by the latest version due
to major changes. Don't be panic if you see "P" and "U" since we work in the community environment the files
are bound to change from now and then. As long as you have committed your change, your version is never lost -
that's the beauty of cvs.
</para>
<figure id="fig-cycle-7">
<title>Update Successful</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_finish.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_finish.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Update successful.
</phrase>
</textobject>
</mediaobject>
</figure>
</sect2>
<sect2 id="s2-cycle-3">
<title> Phase 3 </title>
<para>
Open the file you had taken and downloaded from the server. You can either double click on the
<filename>.po</filename> file or open the <filename>.po</filename> file within <application>poEdit</application>
application. Don't forget to save your changes before you finish everything.
</para>
</sect2>
<sect2 id="s2-cycle-4">
<title> Phase 4 </title>
<indexterm>
<primary>TortoiseCVS</primary>
<secondary>cvs commit</secondary>
</indexterm>
<para>
To upload the file you've taken and subsequently translated back to cvs server is similar to
download operation. Right-click on <filename>translate</filename> folder in <application>Windows
Explorer</application> and select <guimenuitem>CVS Update</guimenuitem>. You'll be prompted to enter
the passphrase of your private key before <application>TortoiseCVS</application> can continue.
After you correctly input your passphrase, you may see a screen similar to <xref linkend="fig-cycle-8"/>.
</para>
<figure id="fig-cycle-8">
<title>Update Before Commit</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_modified.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_modified.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Update before commit.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
"M" stands for "modified". It indicates that this file had been modified on <emphasis>YOUR</emphasis>
local machine and needed to be uploaded to server.
</para>
<para>
If you see a capital "C" instead of "M", then it's time to panic. :P (See <xref linkend="fig-cycle-9"/>.)
"C" stands for "conflict", which means while you were modifying your local file
this file on the server has been changed at the same time.
This may be caused by the package maintainer who merged your file with <filename>.pot</filename>
file, or you forget to <emphasis>Take</emphasis> the file before starting working on it and someone else
had taken and committed the translation before you. The file conflicts have to be resolved manually
and may cause lost translation and wasted effort. Please seek assistance through your community
and relavant mailing lists.
</para>
<figure id="fig-cycle-9">
<title>File Conflict</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/conflict.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/conflict.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
File conflict
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
If everything is fine, you can upload the file you had modified. Choose <guimenuitem>CVS Commit</guimenuitem>
after you right-click on the <filename>translate</filename> folder, as shown in <xref linkend="fig-cycle-10"/>.
</para>
<note>
<title> Note </title>
<para>
<command>cvs update</command> will notify you the file modification on <emphasis>your local</emphasis>
computer. It will <emphasis>NOT</emphasis>, however, upload the file back to server until you choose to
<command>cvs commit</command>.
</para>
</note>
<figure id="fig-cycle-10">
<title>Commit Files to Server</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_menu_commit.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_menu_commit.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Commit files to server.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
You'll see a list of modified files, as shown in <xref linkend="fig-cycle-101"/>. Check the file(s)
you will upload to the server. It is also recommended to key in some comments, so other translators
can easily track what has been changed in any file. Press <guibutton>OK</guibutton> to upload the file.
</para>
<figure id="fig-cycle-101">
<title>Commit Files to Server</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_commit.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/tortoise/cvs_commit.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Commit files to server.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
Again, you'll be prompted the passphrase of your private key. After files are successfully uploaded
to server, you will see a screen similar to <xref linkend="fig-cycle-11"/>.
</para>
<figure id="fig-cycle-11">
<title>Commit Files to Server Successfully</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_commit.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/cvs_up_commit.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Commit files to server successfully.
</phrase>
</textobject>
</mediaobject>
</figure>
</sect2>
<sect2 id="s2-cycle-5">
<title> Phase 5 </title>
<indexterm>
<primary>Status page</primary>
<secondary>release</secondary>
</indexterm>
<para>
The phase is an optional one, only occurs when you decide to stop working on a file before it's fully translated. For example, you may go on a holiday and don't want to keep working on a file but would like others to be able
to resume the work. To do so, you need to go to the Fedora status page, find the package you had taken,
and click the package name to view the detail. On the bottom of that page, you would see the
<guibutton>Release</guibutton> link, as shown in <xref linkend="fig-cycle-12"/>.
</para>
<figure id="fig-cycle-12">
<title>Release File Screen</title>
<mediaobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_released.eps"
format="EPS"/>
</imageobject>
<imageobject>
<imagedata fileref="./figs/cycle/fedora_released.jpg"
format="JPG"/>
</imageobject>
<textobject>
<phrase>
Release file screen.
</phrase>
</textobject>
</mediaobject>
</figure>
<para>
This is the end of the life cycle of Fedora software translation. We do hope you enjoy being with part of the
open source community and continue lending your support.
</para>
</sect2>
</sect1>
<sect1 id="s1-resource">
<title>Other Resources</title>
<sect2 id="s2-resource-website">
<title> Related Websites </title>
<indexterm>
<primary>resource</primary>
<secondary>websites</secondary>
</indexterm>
<variablelist>
<varlistentry>
<term> Official website of <application>TortoiseCVS</application></term>
<listitem>
<para>
<screen>
<ulink url="http://www.tortoisecvs.org/">http://www.tortoisecvs.org/</ulink>
</screen>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> Official website of <application>poEdit</application></term>
<listitem>
<para>
<screen>
<ulink url="http://poedit.sourceforge.net/">http://poedit.sourceforge.net/</ulink>
</screen>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> Official website of <application>PuTTY</application></term>
<listitem>
<para>
<screen>
<ulink url="http://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</ulink>
</screen>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> <application>WinCvs</application> CVS Client </term>
<listitem>
<para>
<application>WinCvs</application> is an alternative CVS client you can use. The following article
describes its installation steps in detail.
<screen>
<ulink url="http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1">http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1</ulink>
</screen>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> A good CVS guide</term>
<listitem>
<para>
<screen>
<ulink url="http://www.loria.fr/~molli/cvs/doc/cvs_toc.html">http://www.loria.fr/~molli/cvs/doc/cvs_toc.html</ulink>
</screen>
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2 id="s2-resource-feedback">
<title> Your Feedback </title>
<para>
Your feedback is always welcome! If you have spotted any typo or errors, please contact
<ulink url="mailto:ccheng at redhat.com?subject=[Fedora translation in Windows] ">Chester Cheng</ulink>,
or simply discuss it through <ulink url="http://www.redhat.com/mailman/listinfo/fedora-trans-list">
Fedora Translation List</ulink>.
</para>
<para>
Hope this article has helped you to set things up. Looking forward to hearing from you!
</para>
</sect2>
</sect1>
<index id="generated-index"></index>
</article>
More information about the Fedora-docs-commits
mailing list