PeerTube/support/doc/translation.md

61 lines
2.2 KiB
Markdown
Raw Normal View History

2018-06-21 14:07:53 +02:00
# Translation
2019-11-13 09:45:27 +01:00
We use [Weblate](https://weblate.org) as translation platform.
Please do not edit translation files directly from Git, you have to use Weblate!
2018-06-21 14:07:53 +02:00
2019-11-13 09:45:27 +01:00
If you don't see your locale in the platform you can add it directly in the Weblate interface.
Then, if you think there are enough translated strings, please [create an issue](https://github.com/Chocobozzz/PeerTube/issues) so we add the new locale in PeerTube!
2018-06-21 14:07:53 +02:00
## How to
2019-11-13 09:45:27 +01:00
* Create an account: https://weblate.framasoft.org/accounts/register/
* Validate your email and follow the link sent
* Create your password (keep the `Current password` field empty) and setup your account
* Go to the PeerTube page https://weblate.framasoft.org/projects/peertube/
* Choose the file and the locale you want to translate
2023-02-22 10:40:11 +01:00
2018-06-21 14:07:53 +02:00
## Files
There are 4 files:
* **angular**: contains client strings
2023-02-22 10:40:11 +01:00
* **player**: contains player strings.
Most of the strings come from VideoJS, so you can help yourself by using [video.js JSON files](https://github.com/videojs/video.js/tree/master/lang)
2019-11-13 09:45:27 +01:00
* **server**: contains server strings (privacies, licences...) and iso639 (languages) strings used by PeerTube to describe the audio language of a particular video.
2018-06-21 15:21:02 +02:00
It's the reason why these strings should be translated too. There are many strings so do not hesitate to translate only main audio languages.
2018-06-27 08:28:43 +02:00
2019-11-13 09:45:27 +01:00
2018-06-27 08:28:43 +02:00
## Tips
### Special tags
2018-06-27 08:28:43 +02:00
You must not translate special tags like `<x id="INTERPOLATION" ... />`.
2023-02-22 10:40:11 +01:00
For example:
```
<x id="INTERPOLATION" equiv-text="{{ video.publishedAt | myFromNow }}"/> - <x id="INTERPOLATION_1" equiv-text="{{ video.views | myNumberFormatter }}"/> views
```
2018-06-27 08:28:43 +02:00
2023-02-22 10:40:11 +01:00
should be in french
```
<x id="INTERPOLATION" equiv-text="{{ video.publishedAt | myFromNow }}"/> - <x id="INTERPOLATION_1" equiv-text="{{ video.views | myNumberFormatter }}"/> vues
```
### Singular/plural
2019-11-13 09:45:27 +01:00
For singular/plural translations, you must translate values inside `{` and `}`. **Please don't translate the word *other***
For example:
2023-02-22 10:40:11 +01:00
```
{VAR_PLURAL, plural, =0 {No videos} =1 {1 video} other {<x id="INTERPOLATION" equiv-text="{{ playlist.videosLength }}"/> videos} }
```
2023-02-22 10:40:11 +01:00
should be in french
2023-02-22 10:40:11 +01:00
```
{VAR_PLURAL, plural, =0 {Aucune vidéo} =1 {1 vidéo} other {<x id="INTERPOLATION" equiv-text="{{ playlist.videosLength }}"/> vidéos} }
```