e1193bc26d
Propose a way to check if every is ok before upload on crowdin Add information about crowdin api token
64 lines
1.9 KiB
Markdown
64 lines
1.9 KiB
Markdown
# Internationalization (i18n)
|
|
|
|
The backend and the frontend of the application are internationalized.
|
|
This means that the application can be translated into different languages.
|
|
The application is currently available in English and French.
|
|
|
|
## Local setup
|
|
|
|
To be able to upload/retrieve translation files to/from Crowdin you need to
|
|
setup your local environment with the following environment variables:
|
|
|
|
```bash
|
|
cp ./env.d/development/crowdin.dist ./env.d/development/crowdin
|
|
```
|
|
|
|
Then fill "CROWDIN_API_TOKEN" with your token and "CROWDIN_PROJECT_ID" with the project id
|
|
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.
|
|
|
|
|
|
## 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):
|
|
```bash
|
|
make i18n-generate-and-upload
|
|
```
|
|
|
|
2/ Fill the missing translations on the translation platform:
|
|
|
|
=> [https://crowdin.com/project/lasuite-people](https://crowdin.com/project/lasuite-people)
|
|
|
|
3/ Download the translated files from the translation platform and compile them:
|
|
```bash
|
|
make i18n-download-and-compile
|
|
```
|