L10n:B2G/Localizers: Difference between revisions

L10n:B2G/Localizers (view source)

Revision as of 01:47, 9 January 2013

748 bytes removed , 9 January 2013

no edit summary

Seta00

Confirmed users

100

edits

@@ Line 33: / Line 33: @@
 ===Set up Gaia===
-Clone Gaia and create a '''new debugging profile'''.
+Clone Gaia.
      git clone git://github.com/mozilla-b2g/gaia.git
      cd gaia
-    DEBUG=1 make profile
 ===Setup the l10n repo===
@@ Line 44: / Line 43: @@
      cd locales
-    hg clone https://hg.mozilla.org/gaia-l10n/en-US/
      hg clone ssh://hg.mozilla.org/gaia-l10n/pl/
@@ Line 51: / Line 49: @@
 ===Enable your locale===
-====apps/settings/resources/languages.json====
+====shared/resources/languages.json====
-Next, add you locale to <code>[https://github.com/mozilla-b2g/gaia/blob/master/apps/settings/resources/languages.json apps/settings/resources/languages.json]</code>:
+Next, add you locale to <code>[https://github.com/mozilla-b2g/gaia/blob/master/shared/resources/languages.json shared/resources/languages.json]</code>:
      {
@@ Line 63: / Line 61: @@
      }
-====locales.ini====
+====Localization files====
-For '''every''' app you're testing, edit its <code>[https://github.com/mozilla-b2g/gaia/blob/master/apps/browser/locales/locales.ini locales/locales.ini]</code> file and add your locale:
+You'll need to have Python installed for this next step. OS X and most Linux distributions come with it by default. You can download the Windows installer at http://www.python.org/download/.
-    [pl]
+Run <code>python build/multilocale.py --config shared/resources/languages.json --target apps --target shared --source locales/ pl</code> (replace "pl" with your locale) to copy the localization files to apps' folders and enable your locale in the appropriate locales.ini files.
-    @import url(browser.pl.properties)
-You may need to do the same in <code>shared/locales</code> for picking up date formats and the like.
+===Create a profile===
-If you have python on your system, you can run <code>python build/multilocale.py --ini --target apps --target shared pl</code> (replace "pl" with your locale) to automate this step.
+Now create a profile with your locale enabled:
+    make profile (or ./build.sh gaia if you're building the entire B2G project)
 ===Run Gaia===
@@ Line 79: / Line 78: @@
 (On Mac OS X, the path to the b2g executable is <code>/Applications/B2G.app/Contents/MacOS/b2g-bin</code>.  You'll also need to specify ''absolute'' path to the profile, without the trailing slash.)
-Skip the First Time Screen by pressing "Next" a few times (it will be localized too, eventually).
-Go into Settings and change the locale of the device.
-Use 'Home' on your keyboard to close Settings
-===How this works===
-Thanks to <code>DEBUG=1</code>, Gaia will look for files in <code>/locales/pl/</code>.  See https://hg.mozilla.org/gaia-l10n/en-US/ for how to lay out the files.  File names should be <code>browser.properties</code>, and ''not'' <code>browser.en-US.properties</code> even though <code>/apps/browser/locales/locales.ini</code> might suggest otherwise.  There's some magic going on with the file names and locations to make it easier to just clone the Mercurial repo into <code>/locales</code>.
 ===Troubleshooting/Known Issues===