L10n:B2G/Adding Locales

Here are the steps to follow by l10n drivers to add a locale to Gaia.

Prerequisites

Before being able to pursue a localization effort, there are a few requirements that need to be met. They're not in any explicit ordering, and the ordering might depend on locale. In particular, a few open spots in font support are probably best fixed once the localization effort is on the way, whereas complete lack of font support probably means that the localization effort doesn't need to start until there's progress on the font front.

Localization Team

Someone needs to do the work, of course. A team of two or three is healthy, and it's best if the motivation to start the effort comes from the community itself. See L10n:Teams for existing teams to reach out to. We should make sure that there's no detriment to already ongoing projects.

Fonts

[NEEDINFO] timdream?

It's not clear which font combinations we need to test, but fontconfig's fc-validate is likely the right start. Axel also has a project on [1], but the examples don't work against the current font setup.

Technical Infrastructure

Create the repository

Follow ReleaseEngineering/RepositoryCreationRequest to get the repository created. See bug 834221 for an example.

Push to the repo at least once before you enable the locale in Elmo. For example, you could push a README file, similar to this:

   This directory contains the vi locale for Firefox OS.
   For English files, see https://hg.mozilla.org/gaia-l10n/en-US/

(See example.)

Add to Gaia

Edit locales/languages_all.json in Gaia. Native language names can be found in the product-details lib.

Edit shared/resources/kayboard_layouts.json to enable the desired layout during the FTU setup.

See bug 838516 for example and the corresponding pull request.

Add to Elmo

Edit l10n-master/dir-builds.json in master-ball.

See this pull request for an example.