Skip to content

Latest commit

 

History

History
45 lines (27 loc) · 2.6 KB

README.md

File metadata and controls

45 lines (27 loc) · 2.6 KB
Raw

Focus by Firefox localization

This repository hosts the localization for the Focus by Firefox project for iOS.

The application code with build instructions can be found at https://github.com/mozilla-mobile/firefox-ios

Localization only happens via Pontoon.

For Developers

If your PR touches many files (such as string exports that need to be localized), it will get stale very quickly because many contributors add to these files. Please make sure there is someone around to merge your PR in a timely manner, or expect to need to update your PR to resolve conflicts.

String updates

Automation is used to extract strings from the code repository, and expose them to all other locales.

  1. Strings are extracted and saved in the en-US XLIFF file.
  2. The updated en-US XLIFF is used as a template. Existing translations are copied over if all these elements match:
    • id attribute of trans-unit.
    • original attribute of file.
    • source text.

As a consequence, the default update removes translations if:

  • The source text was changed.
  • The string was moved from one file to another.

This is not ideal when the change in the source text is trivial, or the string move is caused by code refactoring.

It’s possible to invoke automation manually, and use a different matching criterion:

  • nofile will copy translations if the ID and source text match, ignoring the file. This is useful to minimize the impact of code refactoring.
  • matchid will ignore both file and source text, copying translations if the ID matches. This is useful for source changes that don’t require invalidating existing translations.

Linter for reference strings

When opening a pull request that touches the en-US folder, a GitHub workflow is used to check for common issues in the reference strings (misused quotes or ellipsis, hard-coded brand names). It's possible to add exceptions in this JSON file.

Locales in build

Check product locales

Brand new locales might not be correctly imported in the product. This workflow tries to identify missing locales looking at .lproj folders in the product repository.

License

Translations in this repository are available under the terms of the Mozilla Public License v2.0.