2.8 KiB
+++ title="Traduction" description="Traduire le plugin" weight=20 chapter=false +++
Vous pouvez contribuer à la traduction de ce plugin Peertube. Les traductions sont gérées par le logiciel Weblate, via l'instance Weblate de Framasoft.
{{% notice warning %}}
Ne modifiez jamais directement les fichiers dans le dossier languages du plugin,
vous risqueriez de créer des conflits.
{{% /notice %}}
Comment faire
- Créez-vous un compte: https://weblate.framasoft.org/accounts/register/
- Validez votre email en cliquant sur le lien reçu
- Choisissez votre mot de passe, et configurez votre compte
- Allez sur le projet du plugin de tchat: https://weblate.framasoft.org/projects/peertube-livechat/peertube-plugin-livechat/
- Choisissez la langue que vous voulez traduire
- Il ne vous reste plus qu'à ajouter les traductions manquantes, ou corriger celles qui vous semblent erronées.
{{% notice warning %}} Il peut y avoir des chaînes «assez techniques». Si vous n'êtes pas sûr⋅e à 100% du sens, ou de la traduction, il vaut mieux ne pas la traduire du tout ; ainsi la version anglaise s'affichera. {{% /notice %}}
Traduction de la documentation
Pour l'instant, cela n'est pas encore géré dans Weblate. Je suis encore à la recherche de la bonne solution technique.
Voir la page de documentation dédiée à la documentation.
Ajout d'une nouvelle langue
Si la langue qui vous intéresse n'est pas présente, assurez-vous d'abord qu'elle est bien supportée par Peertube. Si c'est le cas, vous pouvez ouvrir un ticket pour en demander l'ajout.
Ajout de nouveau segment / utilisation dans le code
Si vous travaillez sur une nouvelle fonctionnalité, et que vous avez besoin de nouveaux segments, créez les directement dans Weblate. La version anglaise est obligatoire, commencez par celle-ci.
Chaque segment est lié à une clé (par exemple use_chat).
Choisissez une clé en anglais, suffisamment explicite.
Pour utiliser un segment coté front-end, il faut (pour l'instant), appeler peertubeHelpers.translate
avec la version anglaise du texte. Attention, cela veut-dire qu'il faut éviter de changer un segment anglais
existant.
Cette solution n'est pas optimale, mais devrais bientôt changer.
Coté backend, le seul endroit (pour l'instant) qui a besoin de localiser des choses, est la déclaration
des settings du plugin.
Il y a pour cela une fonction loc dédiée dans server/lib/settings.ts à appeler en lui fournissant
la clé de la phrase à utiliser.
Si vous avez besoin de tester vos localisations sans attendre la fusion venant de Weblate,
vous pouvez modifier les fichiers languages/*.yml, mais évitez de les commit
(pour minimiser le risque de conflits).