📝(i18n) add details about translation process
Propose a way to check if every is ok before upload on crowdin Add information about crowdin api token
This commit is contained in:
31
docs/i18n.md
31
docs/i18n.md
@@ -13,14 +13,41 @@ setup your local environment with the following environment variables:
|
|||||||
cp ./env.d/development/crowdin.dist ./env.d/development/crowdin
|
cp ./env.d/development/crowdin.dist ./env.d/development/crowdin
|
||||||
```
|
```
|
||||||
|
|
||||||
Then fill in the `CROWDIN_API_TOKEN` and `CROWDIN_PROJECT_ID` variables in the
|
Then fill "CROWDIN_API_TOKEN" with your token and "CROWDIN_PROJECT_ID" with the project id
|
||||||
`./env.d/development/crowdin` file.
|
in the `./env.d/development/crowdin` file.
|
||||||
|
|
||||||
|
NB: If you don't have a personal Crowdin API token, go to Crowdin interface to generate it:
|
||||||
|
Settings -> API -> Personal Access Tokens -> New token
|
||||||
|
|
||||||
This configuration file will be loaded by the crowdin docker instance.
|
This configuration file will be loaded by the crowdin docker instance.
|
||||||
|
|
||||||
|
|
||||||
## How to update the translations
|
## How to update the translations
|
||||||
|
|
||||||
|
### First way (safe way)
|
||||||
|
|
||||||
|
1/ Generate the translation files for both frontend and backend
|
||||||
|
```bash
|
||||||
|
make i18n-generate
|
||||||
|
```
|
||||||
|
Check locally everything is ok before uploading the files to the translation platform.
|
||||||
|
|
||||||
|
2/ Upload the files to the translation platform (crowdin):
|
||||||
|
```bash
|
||||||
|
make crowdin-upload
|
||||||
|
```
|
||||||
|
|
||||||
|
3/ Fill the missing translations on the translation platform:
|
||||||
|
|
||||||
|
=> [https://crowdin.com/project/lasuite-people](https://crowdin.com/project/lasuite-people)
|
||||||
|
|
||||||
|
4/ Download the translated files from the translation platform and compile them:
|
||||||
|
```bash
|
||||||
|
make i18n-download-and-compile
|
||||||
|
```
|
||||||
|
|
||||||
|
### Second way (faster way)
|
||||||
|
|
||||||
1/ Generate the translation files for both frontend and backend and upload them to the translation platform (crowdin):
|
1/ Generate the translation files for both frontend and backend and upload them to the translation platform (crowdin):
|
||||||
```bash
|
```bash
|
||||||
make i18n-generate-and-upload
|
make i18n-generate-and-upload
|
||||||
|
|||||||
Reference in New Issue
Block a user