i18n - Translators needed! #506
Description
Tracking issue for adding i18n support to Trippy.
How to Help
Validate Machine Generated Translations
The table below contains links to PRs which contain machine generated translations for a variety of languages. Those marked as "help needed!" require a native speaker to review the associated PRs and suggest any corrections.
Changes can be made by starting a Github code review and suggesting changes, or alternative by adding comments to the PR.
Testing of the changes is not required, but if you wish to do so there are instructions below.
Add Additional Languages
If you wish to add support for an additional language, either create a new PR for that language or reply to this issue requesting a new PR containing machine generated translation for that language, which you can then review.
Note that right-to-left (RTL) languages are not currently supported.
Locale Support
| Language | Code | Status | Reviewers | Review Date | PR |
|---|---|---|---|---|---|
| English | en |
merged | @fujiapple852 | 2024-09-28 | #1321 |
| French | fr |
merged | @zarkdav | 2024-09-30 | #1322 |
| Turkish | tr |
merged | @orhun, @arda-guler | 2024-10-04 | #1330 |
| Chinese | zh |
merged | @sxyazi | 2024-10-18 | #1333 |
| Portuguese | pt |
merged | @ulissesf | 2024-10-18 | #1334 |
| Swedish | sv |
merged | @0323pin | 2024-11-02 | #1354 |
| Italian | it |
merged | @ricott1 | 2024-10-17 | #1355 |
| Russian | ru |
merged | @histrio | 2024-11-04 | #1345 |
| Spanish | es |
merged | @josueBarretogit | 2024-11-05 | #1325 |
| German | de |
merged | @peshay | 2024-11-08 | #1331 |
| Hindi | hi |
in progress | @kiranyele18 | #1343 | |
| Dutch | nl |
awaiting review | Help needed! | #1332 | |
| Korean | ko |
awaiting review | Help needed! | #1335 | |
| Japanese | jp |
awaiting review | Help needed! | #1342 | |
ar |
cancelled (RTL) | @tsallabi | 25-01-2025 | #1344 |
Additional locales not on this list are also welcome.
Language and Region
Locales can be specified for a language or a language and a region. For example, a general locale can be created for zh (Chinese) and a more specific locales such as zh-CN (China) and zh-HK (Hong Kong) can be created.
If the users chosen full locale (langauge-region) does not exist, then Trippy will fallback to using the locale for the language only, if it exists. For example, if the user sets a locale of zh-TW (which, assume, does not have a locale defined in Trippy) it will fallback to using the zh locale if it is defined.
Locales should generally be added to Trippy for the language only, except where it makes sense to have different translations per region as well.
Fallback
If the users chosen locale does not exists in Trippy it will fallback to en (English). Fallback is per word/phrase in the locale, and so it is possible to have a locale defined with only a subset of words/phrases, with the remainder falling back to en.
Testing
If you wish to see how the translations look and feel for a given locale you can checkout the PRs linked above (where xx is the locale code):
git clone https://github.com/fujiapple852/trippy.git
git checkout feat-i18n-xx
cargo buildThen run Trippy with the --tui-locale xx option (where xx is the locale code):
sudo ./target/debug/trip --tui-locale xx example.com