Help for l10n contributors

Adding a new locale

What is required?

In order to be able to localise the app for a given language we need:

1. The properties files for the Loop strings, e.g. app/locales/loop.en-US.properties for English
2. The properties files for dates l10n, e.g. app/locales/date/date.en-US.properties for English
3. Modify Loop manifest file (app/manifest.webapp) to include the language in the locales list, e.g.
   "en-US": { "name": "Firefox Hello", "description": "Firefox Hello" },

How to do it?

1 - In https://github.com/mozilla-b2g/firefoxos-loop-client fork the repo to your Github account

2 - Clone your fork to your machine

$ git clone https://github.com/<your_user>/firefoxos-loop-client

3 - In the folder that has been created add a pointer to the upstream repo

$ git remote add upstream https://github.com/mozilla-b2g/firefoxos-loop-client

4 - Get the latest changes from the upstream repo and merge to your local copy

$ git fetch upstream $ git merge upstream/master

5 - Create a branch in your working copy so you made your changes into that branch

$ git checkout -b l10n-german

6 - Do the changes to add the language:

• Add a properties file to the app/locales folder, e.g. app/locales/loop.de.properties
• Add a date file to the app/locales/date folder, e.g. app/locales/date/date.de.properties
• Add your language to the app/manifest file

7 - Tell git the changes you made:

$ git add app/locales/loop.de.properties $ git add app/locales/date/date.de.properties $ git add app/manifest.webapp

8 - Configure your repo to include the version number

$ make

9 - Add your commit

$ git commit -m "Added DE locale"

10 - And push your branch that should include your commit and another one bumping up the version

$ git push -u origin l10n-german

(last parameter is your branch name)

11 - Now your github fork is up-to-date, you just need to send a pull request from github website, you should have a button called “Compare & Pull Request"