X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=support%2Fdoc%2Fdevelopment%2Flocalization.md;h=3021d36597ad5975c31761e497038e7b411106a5;hb=7a4fd56ccd86518a6b14c407fc977c7904337448;hp=1664532fe0af61faa7149a1bc672a9ca077c21bc;hpb=2888c12b3b8ffe2306df2211efa0f7a12a1285bb;p=github%2FChocobozzz%2FPeerTube.git diff --git a/support/doc/development/localization.md b/support/doc/development/localization.md index 1664532fe..3021d3659 100644 --- a/support/doc/development/localization.md +++ b/support/doc/development/localization.md @@ -1,40 +1,35 @@ # 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`. +Source files are in `client/src/locale` and translated files merged from [Weblate](https://weblate.framasoft.org/translate/peertube). -## 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. +## Generation -It will also create `server_en_US.xml` and `iso639_en_US.xml` XLIFF file using server strings and custom strings (defined inside the script, we did not find a way to extract them from TypeScript server files). +Will generate XLIFF base files for Angular (`angular.xlf`) and JSON files for the player (`player.en-US.json`) and the server (`server.en-US.json`). +Then, it will merge new translation keys into localized Angular files (`angular.fr-FR.xlf` etc). ``` -$ npm run i18n:generate +$ npm run i18n:update ``` -## Upload on Zanata -Push source source files (en-US) on Zanata: +## Upload on Weblate + +Nothing to do here, Github will automatically send a webhook to Weblate that will pull changes. -``` -$ 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`, `iso639` translation files to JSON (needed by Video.JS, and our application to have efficient runtime translation). -Then, `iso639` files will be merged in `server` files (so we have only one JSON file to serve server translations). + * First, save translations on Weblate so it commits changes. + * Then, fetch these commits: `git fetch weblate && git merge weblate/develop` -``` -$ zanata-cli pull -``` ## Support a new language * Add it to [/shared/models/i18n/i18n.ts](/shared/models/i18n/i18n.ts) * Add it to [/scripts/build/client.sh](/scripts/build/client.sh) - * Pull using zanata (that will execute hooks to correctly generate files of this new language) + * Add it to [/client/angular.json](/client/angular.json) + * Add it to [/scripts/i18n/update.sh](/scripts/i18n/update.sh) + * Lock [weblate project](https://weblate.framasoft.org/projects/peertube) + * Run `npm run i18n:update` * Build the application and check the new language correctly works