Using Mozilla Translator

Needs to be addapted for Firefox 3.1 and mercurial, so DO NOT USE

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 hg (Mercurial), diff (patches) and Meld

Open your distribution package manager and select: "hg", "diff" and "meld". You can skip Meld, but it is a nice merging and diff tool, you may use it in the future. Install them.

sudo apt-get install hg diff meld

(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/
                 |run-mt.sh (file, see bellow)
            /MT/
                |mt.jar (file, see bellow)
                |MT.sh (file, see bellow)
                |[product]/[version]/

As you could know, change [product] with your actual product, like firefox, fennec, sunbird... and [version] with the actual version you will work on: 3.1, 3.0 ...

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 [test this file]. Extract in a temp folder (maybe on your desktop for example). And:

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

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

Configuring hg to pull files

You need to configure your environment to work well with your existing ssh key and the new installed hg. You can read Mercurial FAQ on MDC to learn more about hg (the command-line tool for Mercurial), but I'm writing the tips to get working your setup.

Then, you should configure Mercurial before pulling the code. Your Mercurial configuration file (~/.hgrc) should have at least the following settings:

[ui]
username = Your Real Name <user@example.com>
merge = your-merge-program → in our case meld

[diff]
git = 1

[defaults]
diff=-p -U 8

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 [product][version]/

For example:

cd firefox31/

And then, we need to check out the sources for our project, in the case of Firefox: "mozilla-central", and the rest (Thunderbird, Seamonkey, Sunbird...) is "comm-central". So, use the apropiate repo for you:

hg clone http://hg.mozilla.org/mozilla-central/

or

hg clone http://hg.mozilla.org/comm-central/

[You maybe want to use the hg repo that FrenchMozilla has done. I haven't tested myself, so, be adventurous]

Be patient, this will download the WHOLE mozilla-central or comm-central repository as Mercurial doesn't allow to do partial checkouts. In the end, you will have a lot of useless data for localizers ;).

And you will have a new directory placed on ~/[product][version]/[mozilla or comm]-central/

Downloading ab-CD sources

You need to go to the directory we have created before. So, open a terminal, and in our case:

cd ~/firefox31/

and then, pull out the sources by:

hg clone http://hg.mozilla.org/l10n-central/[locale]/

for example:

hg clone http://hg.mozilla.org/l10n-central/es-ES/