aboutsummaryrefslogtreecommitdiffstats
path: root/doc/i18n.md
diff options
context:
space:
mode:
authorsecondl1ght <[email protected]>2022-09-13 19:39:53 -0600
committersecondl1ght <[email protected]>2022-09-13 19:39:53 -0600
commitc31388c1931affef331686a91b82bf1689e751fa (patch)
tree152b2781244b56a27ba33cf31008c2578d044724 /doc/i18n.md
parent6335fdf52309479249f309b81c5f069fd408283e (diff)
downloadcoinos-ui-c31388c1931affef331686a91b82bf1689e751fa.tar.gz
coinos-ui-c31388c1931affef331686a91b82bf1689e751fa.zip
update CoinOS to coinos
Diffstat (limited to 'doc/i18n.md')
-rw-r--r--doc/i18n.md22
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/i18n.md b/doc/i18n.md
index 528f611b..57172464 100644
--- a/doc/i18n.md
+++ b/doc/i18n.md
@@ -1,6 +1,6 @@
-# CoinOS Internationalization
+# coinos Internationalization
-CoinOS can be translated into other languages by editing [JSON](https://www.json.org/json-en.html) files. You do not need programming knowledge to do this, or to use these instructions. Here are instructions on how to translate CoinOS:
+coinos can be translated into other languages by editing [JSON](https://www.json.org/json-en.html) files. You do not need programming knowledge to do this, or to use these instructions. Here are instructions on how to translate coinos:
_NOTE: This guide was written for people without a technical background. If you want more technical details, click [here](./i18n-technical.md)._
@@ -12,11 +12,11 @@ Last Updated: 2022-08-23
### Language Codes
-Before you can translate CoinOS, you need to know the [ISO 639-1 code](https://en.wikipedia.org/wiki/ISO_639-1) of your language. This is a standard two-letter code that your browser uses to refer to a language (for example, English is `en`, and Spanish is `es`). You can also add a dash and more letters to refer to a specific region (for example, American English is `en-US`, and British English is `en-GB`). A list of all codes can be found [here](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes), and Firefox-based browsers show you the code when you are selecting your browser's language.
+Before you can translate coinos, you need to know the [ISO 639-1 code](https://en.wikipedia.org/wiki/ISO_639-1) of your language. This is a standard two-letter code that your browser uses to refer to a language (for example, English is `en`, and Spanish is `es`). You can also add a dash and more letters to refer to a specific region (for example, American English is `en-US`, and British English is `en-GB`). A list of all codes can be found [here](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes), and Firefox-based browsers show you the code when you are selecting your browser's language.
### Locale Files
-Each translation of CoinOS is stored in a special _locale file_. These files can be found in the `src/locales` folder in the CoinOS directory. The name of these files is the language code plus "`.json`". A file might look something like this:
+Each translation of coinos is stored in a special _locale file_. These files can be found in the `src/locales` folder in the coinos directory. The name of these files is the language code plus "`.json`". A file might look something like this:
```JSON
{
@@ -42,7 +42,7 @@ There is also a JSON file that controls which languages are understood. It is at
}
```
-This file simply maps each language to its name. It is used both to get a list of languages and to get the name of each language for the language selector. If a translation is not in this file, CoinOS will not be able to see it.
+This file simply maps each language to its name. It is used both to get a list of languages and to get the name of each language for the language selector. If a translation is not in this file, coinos will not be able to see it.
### JSON Sections
@@ -62,7 +62,7 @@ You might notice that some of the left-text in the language files don't have a s
These denote sections of the JSON file, which helps keep it organized. If you're translating some text that is in a section, make sure the translated text is in the same section of the new file. If that section doesn't exist, just create it.
-In the translation files, sections roughly correspond to where the the text is in CoinOS. This can be useful if you need context for some text. Here are some of these associations (`A.B` means section `B` is located inside `A`):
+In the translation files, sections roughly correspond to where the the text is in coinos. This can be useful if you need context for some text. Here are some of these associations (`A.B` means section `B` is located inside `A`):
| Section | Location |
| ----------------- | ------------------------------------------------- |
@@ -87,10 +87,10 @@ In the translation files, sections roughly correspond to where the the text is i
Sometimes, you will see strange text surrounded with `<>` angle brackets. Every one of these "HTML tags" will be followed by another one starting with a slash. Here's an example:
```JSON
-"p1": "<strong>CoinOS</strong> is an <strong>open source</strong> bitcoin web wallet, point of sale, ecommerce marketplace and exchange platform. Development started in Vancouver in September 2012 as a way to provide local merchants with a convenient way to accept bitcoin payments.",
+"p1": "<strong>coinos</strong> is an <strong>open source</strong> bitcoin web wallet, point of sale, ecommerce marketplace and exchange platform. Development started in Vancouver in September 2012 as a way to provide local merchants with a convenient way to accept bitcoin payments.",
```
-These apply a certain style to the text between them. For example, the tags above will make "CoinOS" and "open source" bold, leaving the rest non-bold.
+These apply a certain style to the text between them. For example, the tags above will make "coinos" and "open source" bold, leaving the rest non-bold.
When translating strings containing tags, don't change the tags. Do translate the text between them, and don't be afraid to move them around - just make sure they contain the same part of the sentence, and that the one without the slash is always before the one with the slash. Not all of the localizable strings support HTML tags, so you shouldn't use them if they aren't in the original string you're translating.
@@ -103,7 +103,7 @@ Follow these steps to create a new translation. You will need a GitHub account t
![Creating a new translation in GitHub](./img/create_locale_github.png)
3. Copy the text from `en.json` into this new file.
4. Translate all of the pieces of text on the right. **Do not translate or alter in any way the pieces of text on the left, or any line that doesn't have two pieces of text!**
- _NOTE: "CoinOS" is a feminine noun in languages with grammatical gender._
+ _NOTE: "coinos" is a feminine noun in languages with grammatical gender._
![Translating in GitHub](./img/translate_github.png)
5. Scroll down and use the green button to commit the file.
6. Go to the `src` folder again, then `lib`, then `translations`, then `lang.json`.
@@ -121,7 +121,7 @@ Follow these steps to add to an existing translation. You will also need a GitHu
5. Use the pencil icon on the top-right to edit the file.
6. Add the whole line (both left and right parts) from step 3 to this file, in between the `{}` braces. Make sure the previous line has a comma at the end, and that it is in the same place as before (i.e. inside the same set of `{}` braces - if they don't exist, create them).
7. Translate the piece of text on the right, keeping the quotes surrounding it. **Do not translate or alter in any way the piece of text on the left, or any line that doesn't have two pieces of text!**
- _NOTE: "CoinOS" is a feminine noun in languages with grammatical gender._
+ _NOTE: "coinos" is a feminine noun in languages with grammatical gender._
8. Repeat steps 3-7 for every piece of text you want to translate (you should probably open `en.json` in another tab, so that your changes from step 6 aren't erased).
9. Scroll down and use the green button to commit the file.
@@ -134,4 +134,4 @@ There is also a program that helps you translate automatically - all you have to
The script also shows you the ID of each bit of text you are translating, so that you can know where it is. `A.B` means string `B` in section `A`, `A.B.C` means string `C` in subsection `B` in section `A`, etc.
-Clone the repository, then use the guided translation script (at `src/locales/guided_translation.py`) to update the translation files. You will need to pull before running, and commit/push your changes in order for them to be applied to CoinOS.
+Clone the repository, then use the guided translation script (at `src/locales/guided_translation.py`) to update the translation files. You will need to pull before running, and commit/push your changes in order for them to be applied to coinos.