blob: 68e0bc15d7d21cb0ae3b3c5e2d097ccb62b8bdd2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
This is a folder with gettext translations for Mullvad VPN app.
## Adding new translations
1. Create a new sub-folder under `gui/locales`, use the locale identifier for the folder name.
The complete list of supported locale identifiers can be found at:
https://electronjs.org/docs/api/locales
1. Add a new language on Crowdin under Settings -> Translations -> Target languages menu.
By default the file structure is configured to produce folders with translations using two-letter
language code (defined under Settings -> Files -> <FILE> -> ... [ellipsis] -> Settings).
If you wish to add a dialect (i.e: `pt-BR`), you have to provide a custom mapping
to tell Crowdin to output Portuguese (Brazil) as `pt-BR` instead of `pt`.
In order to add a language mapping, go to Settings -> General Settings -> Language mapping
(three faders icon on the left hand side of the "Translations" menu).
1. Follow the procedure as described in `gui/scripts/README.md`.
1. Optional: Upload the automatically translated `<NEW_LOCALE>/relay-locations.po` to
Crowdin.
*Note: Replace `<NEW_LOCALE>` with the identifier of a newly added language.*
1. ZIP file with the following command:
```
cd gui/locales
zip payload.zip <NEW_LOCALE>/relay-locations.po
```
1. Upload `payload.zip` to Crowdin via web interface (Settings -> Translations -> Upload
translations).
1. Add the language to `SUPPORTED_LOCALE_LIST` in `app.tsx`.
## Updating translations template
### messages.pot
Run `npm run update-translations` to extract the new translations from the source
code.
#### Android translations
The Android app uses translation strings stored in a different format, but which can be generated
from the translations in this directory. For more information, see [here](../../android/README.md).
### relay-locations.pot
To update the countries and cities you have to run the geo data scripts. Follow the instructions
in [`gui/scripts/README.md`](../scripts/README.md).
## Uploading translations template to Crowdin
After updating the translations template (POT) locally, make sure to upload it to Crowdin:
```
CROWDIN_API_KEY=$YOUR_CROWDIN_KEY ./gui/scripts/crowdin.sh upload
```
Triggering Crowdin to start translating has to be done manually. Speak to the project owner
## Downloading translations from Crowdin
Before downloading from Crowdin the project must be "built" first. When you
later download you will receive the translations from the last point in time when it was built.
In order to make a fresh build with translations, use the following command:
```
CROWDIN_API_KEY=$YOUR_CROWDIN_KEY ./gui/scripts/crowdin.sh export
```
In order to download and integrate the new translations from Crowdin into the app, use the following
command:
```
CROWDIN_API_KEY=$YOUR_CROWDIN_KEY ./gui/scripts/crowdin.sh download
```
|
