4643adff0d
* feats: add script to improve localization * fix: the script used to generate the translations didn't take certain concatenations into account. Previously : Many features are unavailable in plain-text mode. To create a single Now : Many features are unavailable in plain-text mode. To create a single plain-text draft, hold Alt or Option while clicking Compose or Reply. - Previously : These features were %@ of the messages you sentin this time period, so these numbers do not reflect all of your activity. To enableread receipts and link tracking on emails you send, click the %@ or link tracking %@ icons in the composer. Now : These features were %@ of the messages you sent in this time period, so these numbers do not reflect all of your activity. To enable read receipts and link tracking on emails you send, click the %@ or link tracking %@ icons in the composer. - Previously : To make changes to contacts in this account, you'll need to re-authorize Mailspring to access your data.\n\n Now : To make changes to contacts in this account, you'll need to re-authorize Mailspring to access your data.\n\nIn Mailspring's main window, go to Preferences > Accounts, select this account, and click \"Re-authenticate\". You'll be prompted to give Mailspring additional permission to update and delete your contacts. ... * chore: improving the french and format-localizations.js executed * feats: add templates to localizations * fix(localization): define default template to english * chore(localization): added explanations on how to use script files --------- Co-authored-by: Ben Gotow <ben@foundry376.com>
3.6 KiB
Localization / Internationalization
Mailspring 1.5 and above support localization - the app's menus, messages, buttons, and more are loaded from language files based on the user's locale. This makes the app accessible to millions of people around the world and helps it blend in on your desktop!
Providing localization in many languages is a challenge, and automatic translation often does a poor job of technical text. Mailspring's initial translation in ~90 languages was accomplished using a database of human-translated email terms and technical phrases (eg: "Archive", "Send message", etc.) supplemented with Google's NLT Translation API. If you use your computer in another language and also speak English, contributing translations to Mailspring is a great way to impact the open source project and could greatly improve localization quality!
Contributing Localizations
Submit a Pull Request
If you have a GitHub account, you can improve the localization files directly and submit a Pull Request! If you're interested in providing many translations, or translating things like network error messages you may not ever see yourself, this is the best bet. It also means you'll be recognized as a Mailspring contributor and the Mailspring project will appear on your GitHub profile!
You'll find the localization files in app/lang named according to the "Language tag" standard. If you're not sure what language tag applies to your language, check the ISO 639-1 lookup table. To modify the file on GitHub and submit a pull request, click the "Pencil Icon" when viewing the file as shown here.
Each file contains a JSON dictionary mapping an English string to a translated string. For example:
{
"%@ of %@": "%1$@ de %2$@",
"Accept": "Aceptar",
"Account": "Cuenta",
"Moved to %@": "Movido a %@"
}
The example above shows two examples of variable substitution. Some strings in Mailspring display text the user provides, like a folder name. In the localized strings, placeholders (%@) represent this text.
If a string contains multiple placeholders, you can optionally reference the variables by index using the %2$@ syntax. Using 2 means this placeholder should be replaced with the second placeholder in the English string. This allows you to change the order variables appear, which is important for languages like Japanese.
Running Mailspring with a Specific Locale
It can be useful to run Mailspring with a specific locale. To do this, pass the lang flag at launch. For example:
/Applications/Mailspring.app/Contents/MacOS/Mailspring --lang=de
Or, when developing th app and running it from your working copy:
npm start -- --lang=de
Understanding the scripts
-
format-localizations.js
- Usage:
node scripts/format-localizations.js - Description: This script finds all uses of
localized()in ts, tsx, js, jsx files. And include them in en.json. It also removes unused translations from all locales and sorts them alphabetically.
- Usage:
-
improve-localization.js
-
Usage:
node scripts/improve-localization.js -
Description: This script compares the translations in en.json and in the chosen locale.
-
Option 1: It will prompt you for each missing translation. (if you wish to skip a translation, simply leave blank and press Enter)
-
Option 2: It will set null to each missing translation, and it will be up to you to replace them directly in the corresponding json file.
-
-