aboutsummaryrefslogtreecommitdiffhomepage
path: root/support/doc/development/localization.md
blob: 3cf797516c4a6c1c2eaf2aa32d034a83071cc525 (plain) (blame)
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
# Application localization documentation

Source files are in `client/src/locale/source` and translated files pulled from [Zanata](https://trad.framasoft.org/zanata/iteration/view/peertube/develop/languages/fr?dswid=-1605) in `client/src/locale/target`.

## Generation

Will generate XLIFF files for Angular and escape inner elements in `source` tag because Zanata does not support them.

This script will create `player_en_US.xml` XLIFF file using custom strings (VideoJS plugins) and strings from `videojs_en_US.json` file.

It will also create `server_en_US.xml` XLIFF file using custom strings (defined inside the script, we did not find a way to extract them from TypeScript server files).

```
$ npm run i18n:generate
```

## Upload on Zanata

Push source source files (en-US) on Zanata:

```
$ zanata-cli push
```

## Pull translation

Pull XLIFF files from Zanata, and unescape them (so we retrieve inner elements in `source` tag, used by Angular).
A hook converts `player` and `server` translation files to JSON (needed by Video.JS, and our application to have efficient runtime translation).

```
$ zanata-cli pull
```