Using Mozilla Translator

NOT FINISHED YET!!

Glossary

[user] → is your actual user on Linux: guillermo, father, matt...

[product] → the name of the product you are going to translate: firefox, thunderbird, sunbird, flock, songbird...

[version] → actual version: trunk, 3.0.x, 1.0, 0.x ...

Setting up the enviroment

Install CVS and diff (patches)

Open your distro package manager and select: "cvs" and "diff". Install it

sudo apt-get install cvs diff

(on Ubuntu or Debian)

Install Java

You need to download Java (from here) or install it from your repositories if you are using Linux:

sudo apt-get install java

(for Ubuntu or Debian OS, may vary for other systems)

Directory structure

Create a directory structure like this:

/home/[user]/bin/
                 |cvs-moz.sh (file, see bellow)
                 |cvs-moz-l10n.sh (file, see bellow)
                 |run-mt.sh (file, see bellow)
            /MT/
                |mt.jar (file, see bellow)
                |MT.sh (file, see bellow)
                |[product]/[version]/
                                    |cvs-moz.cfg (file, see bellow)
                                    |cvs-moz-l10n.cfg (file, see bellow)

Files and scripts

mt.jar: Download MT (not the sources!) from here. Extract MT5xx.jar to your /home/[user]/MT/ directory. Then, rename it from MT5xx.jar to mt.jar.

And then download this file. Extract in a temp folder (maybe on your desktop for example). And do:

cvs-moz.sh: Copy this file to /home/[user]/bin/

cvs-moz-l10n.sh: The same, copy to /home/[user]/bin/

run-mt.sh: Copy to /home/[user]/bin/

MT.sh: Copy the file to /home/[user]/MT/

cvs-moz.cfg: Copy the file to /home/[user]/MT/[product]/[version]/

cvs-moz-l10n.cfg: Copy the file to /home/[user]/MT/[product]/[version]/

Editing some files

You need to edit two files to get things working. They are used to download the exact version of product you want:

cvs-moz.cfg

You will find this file in /home/[user]/MT/[product]/[version]/.

Open it with an UTF-8 editor and edit it with options you need: 1 for true (or download), or 0 to not download. For example, if you need to download the browser module (Firefox), edit:

# Download Firefox?
GET_FFX=0

and change 0 with 1:

# Download Firefox?
GET_FFX=1

NOTE: As we are working with a special folder structure, please, DO NOT download two products at the same time. This will maintain a clean workspace and will be easy to maintain in the future. It is recommended that you "log" your work with:

# Save logs?
LOG=1

cvs-moz-l10n.cfg

You will find this file in /home/[user]/MT/[product]/[version]/.

Open it with an UTF-8 editor and edit it with options you need: 1 for true (or download), or 0 to not download. Also you need to change your locale and edit your CVS account.

Branch

You need to put the actual branch you are working with:

# Branch
TAG=MOZILLA_1_8_BRANCH

[firefox3 localizers, as Mozilla is working on "trunk" on CVS, there is no branch property, so you can comment the TAG property]

Locale

You need to change this lines:

# Locale
LOCALE=ab-CD

to your actual locale. For example, for downloading es-ES files:

# Locale
LOCALE=es-ES

CVS account

Edit the lines:

# CVS Access
# Anonymous user
CVSROOT=:pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
# Personal user (you need CVS Access to use this option!!!
# CVSROOT=:ext:willyaranda%gmail.com@cvs.mozilla.org:/l10n

Put your user and comment the "anonymous" user.

NOTE: The "anonymous" user CAN'T check in files to cvs.mozilla.org. You need a CVS account.

Products

Select your product, 1 to download, 0 to not download. For example, to sources for Firefox:

# Download Firefox?
GET_FFX=0

and change 0 with 1:

# Download Firefox?
GET_FFX=1

NOTE: As we are working with a special folder structure, please, DO NOT download two products at the same time. This will maintain a clean workspace and will be easy to maintain in the future. It is recommended that you "log" your work with:

# Save logs?
LOG=1

Downloading en-US sources

Once we have prepared our system to get the sources and modify it, we need to pull the en-US sources.

Open a Terminal and go:

cd MT/[product]/[version]

For example:

cd MT/firefox/trunk

And then, we need to check out the sources:

cvs-moz.sh

And you will see a screen like this:

guillermo@guillermo-laptop:~/MT/firefox/prueba$ cvs-moz.sh 
=== Variables definidas ===
CVSROOT = :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot
TAG = 
LOG = 1
GET_FFX = 1
GET_TBD = 0
GET_MNM = 0
GET_CMN = 0
GET_SBD = 0
===========================
Se usarán estos directorios: mozilla/browser/locales/en-US mozilla/extensions  /reporter/locales/en-US mozilla/other-licenses/branding/firefox/locales/en-US

Pulse una tecla para proceder, o [Ctrl]+[C] para cancelar

As you can see, we are going to pull the en-US sources for Firefox, with no TAG (means trunk) and log the check.

Press enter and you will see the log of the diff for that checkout

Note: If you have a problem with no existent directories, please, create inside MT/[product]/[version] a directory called: LOG_EN.