L10n:B2G/Adding Locales: Difference between revisions
No edit summary |
|||
| Line 1: | Line 1: | ||
Here are the steps to follow by l10n drivers to add a locale to Gaia. | Here are the steps to follow by l10n drivers to add a locale to Gaia. | ||
==Create the repository== | == 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 [http://pike.github.io/fonts/], 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. | Follow [[ReleaseEngineering/RepositoryCreationRequest]] to get the repository created. See {{bug|834221}} for an example. | ||
| Line 11: | Line 25: | ||
(See [https://hg.mozilla.org/gaia-l10n/vi/rev/edc4b2acc214 example].) | (See [https://hg.mozilla.org/gaia-l10n/vi/rev/edc4b2acc214 example].) | ||
==Add to Gaia== | ===Add to Gaia=== | ||
Edit [https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_all.json locales/languages_all.json] in Gaia. Native language names can be found in the [http://viewvc.svn.mozilla.org/vc/libs/product-details/localeDetails.class.php?view=markup product-details lib]. | Edit [https://github.com/mozilla-b2g/gaia/blob/master/locales/languages_all.json locales/languages_all.json] in Gaia. Native language names can be found in the [http://viewvc.svn.mozilla.org/vc/libs/product-details/localeDetails.class.php?view=markup product-details lib]. | ||
| Line 19: | Line 33: | ||
See {{bug|838516}} for example and the [https://github.com/mozilla-b2g/gaia/pull/7980 corresponding pull request]. | See {{bug|838516}} for example and the [https://github.com/mozilla-b2g/gaia/pull/7980 corresponding pull request]. | ||
==Add to Elmo== | ===Add to Elmo=== | ||
Edit [https://github.com/Pike/master-ball/blob/master/l10n-master/dir-builds.json l10n-master/dir-builds.json] in master-ball. | Edit [https://github.com/Pike/master-ball/blob/master/l10n-master/dir-builds.json l10n-master/dir-builds.json] in master-ball. | ||
See [https://github.com/Pike/master-ball/pull/7 this pull request] for an example. | See [https://github.com/Pike/master-ball/pull/7 this pull request] for an example. | ||
== Localization work == | |||
== Related projects == | |||
== Ready-to-ship criteria == | |||
Revision as of 13:42, 10 July 2013
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.