90
edits
L10n:Localizing Overview: Difference between revisions
more...
MarkTyndall (talk | contribs) (moved CVS info to new page) |
MarkTyndall (talk | contribs) (more...) |
||
| Line 24: | Line 24: | ||
= How to begin a localization = | = How to begin a localization = | ||
The following steps should give you an idea of how to localize Firefox, Thunderbird etc. | 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 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. | *Download a release of the product you want to localize. | ||
| Line 32: | Line 32: | ||
**[http://www.mozilla.org/projects/thunderbird/ Thunderbird mail client] | **[http://www.mozilla.org/projects/thunderbird/ Thunderbird mail client] | ||
**[http://www.mozilla.org/projects/calendar/| Sunbird & Calendar] | **[http://www.mozilla.org/projects/calendar/| Sunbird & Calendar] | ||
*Alternatively (for Firefox, and soon, Thunderbird) you can | *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 [[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) | ...(tbc) | ||
| Line 40: | Line 66: | ||
* [http://www.mozilla.org/projects/l10n/ Localization Project home] | * [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_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: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] | * [news://news.mozilla.org/netscape.public.mozilla.l10n Newsgroup discussion] | ||
* [mailto:mozilla-l10n-request@mozilla.org?subject=subscribe Mailing list] | * [mailto:mozilla-l10n-request@mozilla.org?subject=subscribe Mailing list] | ||
* [mailto:mlp-staff@mozilla.org Mozilla Localization Project Staff] | * [mailto:mlp-staff@mozilla.org Mozilla Localization Project Staff] | ||