Find a Doc - Localization
Find a Doc is a free online resource aimed at helping connect the foreign community in Japan with health services in their native language.
Translations are initially created by machine in a special file format, and then edited by volunteers to be published on the site.
How to Contribute
If you speak a foreign language and can help translate files, Go to
If are a developer trying to add internationalization (i18n) keys, Go to
Translator Guide
The easiest and fastest way to contribute is through Git. Simply clone this repo and open a PR to merge your changes.
If you're new to Git, here are some easy steps you can take to get started:
Beginner Git
-
Go into the locales folder and click on the language file you wish to contribute to. It will take you to a screen that will show you its content. (Note if you are creating a new language file, copy from
en.jsonand please name the new file using the two-letter language codes defined here)
-
Click the
editbutton so you can directly edit the translation through your browser. Use theen.jsonfile and the website as the reference content.
Make sure to only edit the part inside of the quotation marks of your selected language.
You might notice the files are in a special format so the computer can read it. This format is called JSON (JavaScript Object Notation) and contains a key on the left side, and a value on the right side. Notice that the key names are in English, and sometimes the letters are squished together like this noSpacesHere. Please only edit the values, not the keys. Note the example below has a key of "vaccine" and a value translated into Japanese.
{
"key": "value",
"vaccine": "ワクチン"
}
If this is confusing or you get stuck, we are here to help. See contact information below
-
Select the
Create a new branch for this commit and start a pull requestoption at the bottom of the page. Then click thePropose changesbutton.
-
Optional - Add any comments you want to make on the pull request screen.
-
Click the
Create pull requestbutton.
Thank you! Your changes will be reviewed!
If you have any trouble with this document, please file an issue or reach out to @stonecoldkilzer on Twitter
Developer Guide
- Fork & clone this repo to your computer
- Edit the
locales/en.jsonto contain the new keys. - If you know another language, feel free to add the same key and translation to the appropriate locale file. Omit if you don't know it; we use English as the fallback language so nothing will break.
- Make a pull request in this repo and wait for it to be merged to
main - Make your change in the parent repository with the new i18n keys and submit your PR
🎉
1 Oct 23, 2021
3 May 18, 2022
56 Jan 22, 2022
3 Oct 09, 2021
98 Jan 07, 2023
3.1k Jan 04, 2023
383 Dec 27, 2022
2 Feb 18, 2022
1.3k Jan 04, 2023
5 Mar 27, 2022
10 Sep 29, 2022
16 Sep 15, 2022
13 Dec 09, 2022
5 Jul 26, 2022
1 Jan 12, 2022
5 Jul 15, 2022
106 Nov 08, 2022
1 Oct 20, 2021
1 Nov 26, 2021
1 Nov 09, 2021