Welcome to the Hellō Wallet i18n repository! Great to have you here.
In this repository, we coordinate all community-driven translation efforts for wallet.hello.coop.
This step-by-step guide is written assuming that this may be your first time contributing on GitHub. If you're familiar with GitHub, you can skim through this guide. If you have questions or concerns, feel free to file an issue or send us an email.
| Short code | Language | Contributors |
|---|---|---|
| en | English | Hellō |
| hi | Hindi | Rohan Harikumar, S. Harikumar, Vinod Kandra |
| ar | Arabic | Kishor Kumar |
| fr | French | Jennifer Hardt |
| de | German | Nicole Fior-Greant, Zak Greant |
| es | Spanish | Santiago Madrid |
| pt | Portuguese (Incomplete) | Tiago Rangel |
| xx | Don't see a locale? PR's welcome! | your-name-here |
Want to add a locale or make corrections? Follow the guide below and we will happily review and merge!
- Log in to GitHub
If you don't have an account, follow this guide to create one. - Fork this repository
Click theForkbutton on the top right. This will create your own personal copy of the repository (known as a fork). - Add yourself to locales table
To let everyone know that a new locale is in progress, please click on the edit icon on the top right and add the locale short code, language, status as "In Progress", and your name (which links to your GitHub profile) to the locales table. Once the changes have been saved, please send us a Pull request. If you are unfamilar with sending Pull requests, please refer to this section. - Clone the fork to your machine
If you are unfamilar with git operations, this is a good guide to get started. - Duplicate
en.jsonand rename
In thelocaledirectory, duplicateen.json(this is the base for our translations) and rename to the short code of the locale you are planning to add (eg:ja.jsonfor Japanese locale). You can find short codes for locales here. If you want to make any corrections, simply edit the existing locale file. - Commit and push changes
If you are using VS Code, we recommend installing the i18n ally plugin for a better localising experience which also enforces consistent formatting across locale files. - Submit a Pull request
Please make sure the title of the Pull request matches the file name. In case of corrections, prepend the Pull request title withfix:. (eg: "fix: de.json").
While localising, you'll come across text that contains keys contained in curly braces, such as Continue with {provider} and Welcome {name}.
The keys should not be translated, neither should "Hellō".
These keys are replaced with a value generated by the system. For example, {date} would be replaced with a date such as 22 March 2022. See the table below for a description of each key.
| Variable | Description | Example Occurrence | Example Output |
|---|---|---|---|
| {provider} | {provider} can be Google, Facebook, etc. | Continue with {provider} | Continue with Google |
| {appName} | {appName} can be Spotify, YouTube, etc. | Return to {appName} | Return to Spotify |
| {date} | {date} can be 22 March 2022, etc. | Member since {date} | Member since 22 March 2022 |
| {contact} | {contact} can be an email address or phone number. | {contact} has already been verified | [email protected] has already been verified |
| {label} | {label} can be an email address or username. | {provider} {label} is now preferred | Google ([email protected]) is now preferred |
| {language} | {language} can be English, Hindi, etc. | Preferred language is now {language} | Preferred language is now English |
| {address} | {address} is an ethereum hexadecimal address. | Wallet Connected ({address}) | Wallet Connected (0xb794...579268) |
| {name} | {name} is user provided preferred name. | Welcome {name} | Welcome John |
<br/> - Indicates a line break; the text following this would be pushed to the next line. When localising, please add <br/> where necessary for readibility.
In the GitHub repo page (https://github.com/your-username/wallet-i18n), click on the Pull requests tab and then the New pull request button. Please merge your changes to the main branch of hellocoop/wallet-i18n. Learn more here.
