Using Mozilla Translator

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", there is no branch property, so you can forget that step]

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