Traductions¶

Bien que l’Anglais soit la langue de base officielle pour tous les projets menés par UBports, nous pensons que vous avez le droit de les utiliser dans toutes les langues que vous souhaitez.

Nous travaillons dur pour atteindre cet objectif et vous pouvez également nous aider. Vous décidez du temps à investir dans la traduction. De quelques minutes à plusieurs heures, toutes les contributions comptent.

Comment un texte est-il traduit (informations techniques)¶

La plupart des applications fonctionnant sur Ubuntu Touch utilisent GNU gettext pour les traductions. Un fichier modèle .pot contient les chaînes de caractères d’une application. Un fichier .po individuel est dérivé de ce modèle pour chaque langue. Ces fichiers .po contiennent les traductions réelles. Pour ajouter une nouvelle langue, un nouveau fichier .po doit être créé. Pour traduire une chaîne, le fichier .po doit être édité. À côté de la chaîne originale (en anglais dans la plupart des cas), la traduction appropriée doit être saisie en suivant la syntaxe du fichier gettext .po. Certaines applications utilisent QtLinguist pour la traduction. Elles suivent les mêmes principes en utilisant uniquement les fichiers .ts pour les traductions avec une autre syntaxe. Un fichier .ts est utilisé comme modèle.

Dans une application, les chaînes sont marquées soit de cette façon i18n.tr("string") lorsqu’on utilise gettext, soit comme ceci tr("string") lorsqu’on utilise QtLinguist. Lorsque l’application est construite, ces chaînes traduisibles sont extraites et écrites dans les fichiers modèles .pot ou .ts. Les fichiers de langue .po et .ts doivent ensuite être mis à jour à partir de leur modèle.

Une fois que les chaînes ont été traduites, elles sont mises à la disposition des utilisateurs/trices avec une nouvelle version d’une application.

Les méthodes de traduction¶

Il existe trois façons habituelles de traduire une application :

Weblate : un outil de traduction sur internet. Les applications d’UBports utilisant Weblate peuvent être traduites ici et là. Il y a un transfert automatique des nouvelles chaînes de caractères du dépôt d’une application vers Weblate. Les chaînes traduites sont renvoyées dans le dépôt par Weblate en tant que validations.
Éditeur : la traduction se fait en changeant les fichiers .po avec l’éditeur de votre choix et un compte GitHub/GitLab. Les fichiers .po/.ts de chaque projet se trouvent dans leur dépôt sur notre projet GitLab ou sur notre projet GitHub. Après la traduction, les nouvelles traductions sont envoyées à un dépôt d’applications, généralement en ouvrant une demande de fusion.
Equipe de traduction : nous avons également un Forum de traduction pour discuter de la traduction d’Ubuntu Touch et de ses applications principales. Certains projets utilisent également Telegram ou des groupes Matrix et certaines équipes utilisent encore Ubuntu Launchpad.

Les applications de base et certaines applications communautaires comme Dekko ou TELEports utilisent généralement Weblate pour la traduction. C’est la méthode de traduction préférée et elle ne nécessite aucune compétence en programmation. Veuillez consulter les projets de traduction de UBports et https://hosted.weblate.org/projects/lomiri/. Lorsque vous utilisez Weblate, ne modifiez pas les fichiers .po manuellement. La publication de fichiers .po modifiés peut interrompre le processus de traduction automatique.

La plupart des applications maintenues par les développeurs/euses utilisent principalement des fichiers .pot/.po pour la traduction. Ceux-ci doivent généralement être modifiés manuellement et envoyés au dépôt de l’application.

Tutoriels¶

Le Weblate d’UBports¶

Vous pouvez accéder au Weblate d’UBports ou Weblate Lomiri, cliquer sur le bouton « Tableau de bord », choisir un projet et commencer à faire des suggestions de manière anonyme sans avoir à vous enregistrer. Si vous souhaitez enregistrer vos traductions, vous devez être connecté.

Pour cela, rendez-vous dans le Weblate d’UBports et cliquez sur le bouton « S’inscrire ». Une fois dans la page « Inscription », vous aurez deux options :

Inscrivez-vous en utilisant une adresse courriel valide, un nom d’utilisateur et votre nom complet. Vous devrez aussi résoudre une question de contrôle facile.
Inscrivez-vous en utilisant un service d’inscription tiers. Le système prend actuellement en charge openSUSE, GitHub, Fedora et Ubuntu.

Une fois que vous serez connecté, le site est explicite et vous y trouverez toutes les options et personnalisations à votre disposition.

Maintenant, continuez. La première étape consiste à rechercher si votre langue existe déjà dans le projet de votre choix. Si votre langue n’est pas disponible pour un projet spécifique, vous pouvez l’ajouter vous-même.

Éditeurs de fichier .po/.ts¶

Si vous voulez travailler directement avec des fichiers .po/.ts, vous devez être sûr de ce que vous faites. La première chose que vous devez toujours vous rappeler est la suivante :

Avertissement

Ne jamais modifier des fichiers .po sur des projets traduits par Weblate. Cela pourrait casser tout le processus d’échange de traduction avec Weblate.

Comme expliqué précédemment, vous aurez besoin d’un éditeur de votre choix et d’un compte sur GitHub/GitLab pour traduire directement les fichiers .po/.ts. L’idéal serait que vous disposiez de clickable et que vous sachiez comment générer une application.

Il existe des éditeurs gettext de fichiers .po en ligne et des que vous pouvez installer sur votre ordinateur. Vous pouvez choisir l’éditeur que vous voulez, mais nous préférons travailler uniquement avec des logiciels libres. Il existe trop d’éditeurs de texte simple et d’outils pour vous aider à traduire les fichiers .po/.ts pour en dresser la liste ici.

Note

Pour des traductions de qualité, il est recommandé de suivre toutes les étapes indiquées ci-dessous. Toutefois, si vous n’êtes pas familier/ère avec la création d’applications à l’aide de « clickable », passez les étapes 4. à 6. Il se peut toutefois que vous ne puissiez pas traduire les dernières chaînes de caractères. Et vous ne saurez pas si les chaînes s’intègrent dans la mise en page de l’application.

Comment procéder :

Copiez le dépôt de l’application sur votre compte GitHub ou GitLab
Clonez le dépôt localement ou utilisez l’éditeur en ligne de GitLab
Facultatif : créez une nouvelle branche pour la traduction
Générez l’application en utilisant clickable pour obtenir des fichiers modèles .pot/.ts à jour
Mettez à jour le(s) fichier(s) de langue .po/.ts souhaité(s) à partir du modèle
Traduisez toutes les chaînes
Générez et installez l’application sur votre appareil puis testez les traductions
Facultatif : répétez les étapes 6. et 7. jusqu’à ce que vous soyez satisfait/e de votre travail
Publiez le(s) fichier(s) .po/.ts traduit(s) vers votre dépôt cloné [ne pas envoyer les fichiers modèles .pot/.ts]
Ouvrez une demande de fusion de votre version au dépôt de l’application

Communication de l’équipe de traduction¶

Vous pouvez parler à d’autres personnes du sujet des traductions en utilisant la catégorie de forum qu’UBports fournit pour cette tâche. Pour l’utiliser, vous devez vous inscrire, ou vous connecter si vous êtes déjà inscrit/e.

La seule obligation est de commencer votre publication en mettant entre crochets votre langue dans le champ « Saisissez le titre de votre sujet ici ». Par exemple, [French] How to translate whatever? ([Français] Comment traduire n’importe quoi ? »)

Dans vos interactions avec votre équipe, vous trouverez la meilleure façon de coordonner vos traductions.

Licence¶

Tous les projets de traduction et toutes vos contributions à ce projet sont placés sous une licence Creative Commons Attribution-Partage à l’identique 4.0 International (CC BY-SA 4.0) que vous acceptez explicitement en contribuant à ce projet.

Visitez ce site pour apprendre ce que cela signifie exactement.