e18809ceb8
Co-authored-by: Balázs Meskó <meskobalazs@mailbox.org> |
||
---|---|---|
.circleci | ||
grunttasks | ||
locale | ||
scripts | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
Gruntfile.js | ||
README.md | ||
id_bug_mirror.enc | ||
package-lock.json | ||
package.json | ||
secret-env-cipher |
README.md
fxa-content-server-l10n
This repo (abbreviated as "L10N" in this README) contains all translated/translatable strings for all of the FxA servers (fxa-content-server, fxa-auth-server, etc.). The FxA repository is abbreviated as "SOURCE" in this document.
The string localization is managed in Pontoon and it pushes changes anytime it likes.
On a regular basis (currently once a week) a cron job runs which extracts all the strings from SOURCE and opens a PR to merge them into this repository. Someone from the localization team will review that PR for any strings that are confusing to localize and, if there aren't any problems, will merge it. At that point Pontoon sees the changes and strings can be localized from the Pontoon interface.
A new copy of this repository is checked out every time a deploy happens so deployed sites have the latest strings.
Submitting Translations
Please find your locale on Pontoon - Firefox Accounts. Follow the instructions on those sites to submit your translations.
!! Warning !!
The directions below are super old and may not be relevant anymore. The tools, like gettext, still matter, but I don't think all the script that exist here are run anymore. So, beware.
Dependencies
- Install gettext. OS X:
brew install gettext
brew link gettext --force # brew does not link the tools into /usr/local. Force the link.
Ubuntu: sudo apt-get install gettext
The process to work with strings:
- Make sure you installed the dependencies and
msgfilter
(fromgettext
) command is available in your shell. - Have the
fxa-auth-server
andfxa-content-server
repos at the same directory level asfxa-content-server-l10n
. - Have all the dependencies be up to date in the fxa-auth-server and fxa-content-server repos using
npm install
.
Locale Normalization
Before Release Build
Some locales need to be copied over into a different directory. Run this script a few hours before the production deploy:
./scripts/before_prod_deploy.sh --l10n-repo .
String extraction
After Production Deploy
Source strings are extracted from the fxa-content-server and fxa-auth-server repos. Make sure you to git pull
the latest changes from master
for both of those repositories.
cd
into this project directory and run:
./scripts/extract_strings.sh --mailer-repo ../fxa-auth-server --content-repo ../fxa-content-server --l10n-repo . TRAIN_NUMBER
where TRAIN_NUMBER
is the train you are cutting strings for.
This will create a new branch. Now run:
./scripts/before_prod_deploy.sh --l10n-repo .
Git commit the changes made by the script. Pull request that branch against master
.
After that pull request is merged run:
./scripts/email-dev-l10n.sh
The script above will generate an email for the l10n mailing list. Read through the instructions in the script output to post to the l10n mailing list.