joshuafhiggins/realm-homepage
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: more details in the README-LANGUAGES.md

Browse Source
This commit is contained in:
Waled Khatiz
2024-09-01 04:04:44 +10:00
parent 02b37104ce
commit 94123c52bf
1 changed files with 15 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
messages/README-LANGUAGES.md
View File

@@ -13,7 +13,7 @@ If you do not see a JSON for your language then may add the language by followin
## Adding a language ## Adding a language
1. Add the language to the `const SUPPORTED_LANGUAGES = ['en', 'de'];` variable in the `./src/i18n.ts` file. 1. Add the language to the `const SUPPORTED_LANGUAGES = ['en', 'de'];` variable in the `./src/i18n.ts` file.
2. Create a new `.json` file in the `./messages` directory named after the [ISO Language Code](https://www.w3schools.com/tags/ref_language_codes.asp) of the language. 2. Create a new `.json` file in the `./messages` directory named after the [ISO Language Code](https://www.w3schools.com/tags/ref_language_codes.asp) of the language (all lower case so language code es-ES should be es-es.json).
3. Copy the contents of the `en.json` file, make your way down the key-value pairs changing **only the values** to the translated equivalent. 3. Copy the contents of the `en.json` file, make your way down the key-value pairs changing **only the values** to the translated equivalent.
## Usage ## Usage
@@ -75,6 +75,20 @@ Translated:
The JSON is organized by the file names in the `/components` directory. Find the `.tsx` file that generates the untranslated text and modify it to use the translated value. The JSON is organized by the file names in the `/components` directory. Find the `.tsx` file that generates the untranslated text and modify it to use the translated value.
## Wrong Language Code
It is common to mix up the 'es' language code with the 'es-ES' language code, for example.
To see the language code that is actually being sent to the server you can do as follows:
1) Set your browser settings to the language you are trying to translate.
2) Open your browser developer tools.
3) Go to the 'Network' tab.
4) Ensure the Network tab is recording traffic (it typically is already recording).
5) Refresh the website and you will see all the requests the browser made to the server.
6) Scroll up to the very first request that was sent when you refreshed and click on it. The details of that request should be displayed.
7) In the 'Headers' tab of the details scroll down to 'Request Headers'.
8) Under 'Request Headers' you will see the 'Accept-Language' header whose value will be the language code(s) being sent by your browser, each with a 'q' value to specify which language code is most preferred.
### Documentation ### Documentation
If the error persists consult the [next-intl documentation](https://next-intl-docs.vercel.app/docs/getting-started). If the error persists consult the [next-intl documentation](https://next-intl-docs.vercel.app/docs/getting-started).