xnick / protondb-i18n

protondb-i18n

A crowdsourced journey to translate ProtonDB (News post)

Overview

ProtonDB loads its text using react-i18next (version 10) resource bundles in JSON.

Each language, as represented by their 'xx-XX' BCP-47 language tag, lives within locales. Within each locale's directory are two files:

• contribute.json (translations for the reporting flow)
• translation.json (everything else)

Prerequisites

None! You can browse this repository and edit the files manually. But editing language files can be fiddly and typos are common. It's preferable to grab some tools:

• Node.js
• yarn (if you want to skip this, npm is included with node and will probably work fine as a substitute).
• A text editor, ideally one with colored formatting for JSON.

Contributing

All native speakers are welcome to contribute! Please do not make pull requests with automated translations.

• Fork this repo
• Download your fork
• In your downloaded directory, run yarn install
• If starting a new locale, create the directory named after your language tag within locales and copy over files from the locales/en-US directory
• Make your changes/additions
• Review them visually (see Verify Your Changes below)
• Run yarn run lint:json to validate everything is alphabetized and formatted properly
• Commit, push, and open a pull request!

Any questions? Ask us on Discord You might want to let us know on there anyway that you're starting work so that we can add you to Known Active Translations below.

Verify Your Changes

Keep an eye out for page rendering issues if your text is smaller or larger than the English equivalent, and open an issue with a screenshot if you cannot fit readable words for your language.

• Learn how to modify your browser's local storage (here are instructions for Chrome and Firefox)
• Visit ProtonDB
• If you're not already, switch to English
• Copy the contents of your contribute.json file into a local storage entry as i18next:en-US-contribute
• Copy the contents of your translation.json file into a local storage entry as i18next:en-US-translation
• Reload and review

Known Active Translations

• Portuguese (pt-BR): @pedrofleck (ongoing at PR #10)
• Spanish (es-ES): @xathech (ongoing at PR #4)
• Swedish (sv-SE): @kattus (ongoing at PR #12)
• Swedish (sv-SE): @newbytee (ongoing at PR #13)
• Italian (it-IT): @apontini (ongoing at PR #16)
• French (fr-FR): @julroy67 (ongoing at PR #19)

Hall of Fame

• German (de-DE): @NoXPhasma
• Polish (pl-PL): @kacperski1
• Ukrainian (uk-UA): @iodream
• Bulgarian (bg-BG): @mialy

Coming soon

• An expanded ProtonDB help section will need translations too!