90
edits
Changes
more...
= How to begin a localization =
The following steps should give you an idea of how to localize Firefox, Thunderbird etc.
<p class="note">if you want to contribute your localizations back to the MLP, head over to the [http://www.mozilla.org/projects/l10n/registration.html registration page]. From there, you can check whether anyone is already producing localizations for your intended language, and either join them or register yourself for one of the projects.</p>
*Download a release of the product you want to localize.
**[http://www.mozilla.org/projects/thunderbird/ Thunderbird mail client]
**[http://www.mozilla.org/projects/calendar/| Sunbird & Calendar]
*Extract the files, using the appropriate extraction tool:**<tt>tar -xzvf</tt> for Linux packages**[http://moztw.org/tools/ mozip] for the Application Suite and Sunbird**[http://www.7-zip.org/ 7z] for Firefox and Thunderbird**??? for Camino**any ZIP archiver for Calendar*Alternatively (for Firefox, and soon, Thunderbird) you can use [[L10n:Localizing_Using_CVS|use CVS to download the localizable parts]], for either a branch or the current trunk.
=Localize the files=
To do this, you can use all-in-one tools, such as MozillaTranslator, or your favourite UTF-8–aware text-editor.
Ensure you translate the directory structure (from <tt>../en-US/..</tt> to <tt>../ab-CD/..</tt>) as well.
==Package your localization==
This step applies to all localisations that aren't held in CVS.
See [http://www.mozilla.org/projects/l10n/mlp_packaging.html Packaging your Work] – however, note that when ZIPping your files, you should use '''no compression at all''':
<pre class="code">zip -r0 ''<file.jar> <dir>''</pre>
==Re-package the new installer==
This step applies to all localisations that aren't held in CVS.
<p>All the installers use <tt>config.ini</tt> and <tt>install.ini</tt>. [http://www.tyndall.org.uk/create-installer.html Building a Mozilla Suite Localised Installer] gives an account of the process involved. It is based on using <tt>mozip</tt>, but is applicable to all installers that use <tt>config.ini/install.ini</tt>.</p>
<p class="note"> when testing a 7z-based installer, use a faster compression ratio rather than one geared for smaller installer files. Only when you have checked that the installer works correctly should you recompress for minimum size.</p>
For the smallest possible installer, ensure that none of the archive files within the installer (eg XPI files) are compressed and use the following command:
<pre class="code">7z a -t7z stage\app.7z *.* -mx -m0=BCJ2 -m1=LZMA:d24 -m2=LZMA:d19 -m3=LZMA:d19 -mb0:1 -mb0s1:2 -mb0s2:3</pre>
This assumes that you are in the directory with all the necessary files, and the archive will be put in a sub-directory called <tt>stage/</tt>.
...(tbc)
* [http://www.mozilla.org/projects/l10n/ Localization Project home]
* [http://www.mozilla.org/projects/l10n/mlp_docs.html Localization docs]
* [http://www.mozilla.org/projects/l10n/mlp_packaging.html Packaging your Work]
* [http://www.tyndall.org.uk/create-installer.html Building a Mozilla Suite Localised Installer]
* [[L10n:Home_Page|Wiki Localization Home Page]]
* [[L10n:Localizing_Using_CVS|Using CVS to download the localizable parts]]
* [news://news.mozilla.org/netscape.public.mozilla.l10n Newsgroup discussion]
* [mailto:mozilla-l10n-request@mozilla.org?subject=subscribe Mailing list]
* [mailto:mlp-staff@mozilla.org Mozilla Localization Project Staff]
