Home Wiki > Equipe de traduction
Sign up | Login

(Redirigé depuis Traduire opensuse)

Equipe de traduction

tagline: De openSUSE

Cette page a pour but de vous guider dans la traduction des applications d'openSUSE (YaST, etc...) et de la documentation et non dans la traduction du wiki. Si vous souhaitez traduire le wiki, rendez-vous sur la page : Equipe du wiki.


Rejoindre l'équipe de traduction francophone


Pour rejoindre l'équipe de traduction francophone, il faut lire et comprendre l'anglais et écrire correctement le français (orthographe, grammaire, conjugaison, ...).

Weblate

Il faut commencer par se créer un compte sur notre outil en ligne Weblate : l10n.opensuse.org et envoyer son identifiant au coordinateur de l'équipe de traduction via La liste de discussion générale francophone (voir ci-dessous: #Listes de diffusion).

Weblate permet de traduire en ligne directement ou de télécharger les fichiers au format PO pour une traduction hors ligne, par exemple.

Listes de diffusion

Enfin, il faut vous inscrire sur les listes de diffusions suivantes :

  • opensuse-fr@opensuse.org - La liste de discussion générale francophone
S'inscrire | Se désinscrire | Aide | Archives
  • opensuse-translation@opensuse.org - La liste des équipes de traduction - Attention, anglais uniquement !
S'inscrire | Se désinscrire | Aide | Archives


Une fois vos inscriptions effectuées, envoyez un mail à la liste opensuse-fr et signalez que vous souhaitez rejoindre l'équipe de traduction francophone. Donnez votre identifiant pour que le coordinateur puisse vous ajouter directement à la liste des traducteurs.


Forum

Il est préférable d'utiliser la liste de diffusion opensuse-fr car il y a plus de membres de l'équipe de traduction qui peuvent vous aider que sur les forums.

Comment traduire : principes généraux


Généralités

Pour traduire les logiciels de la distribution ou la documentation, le principe est le même. Toutes les chaînes à traduire ainsi que leur éventuelle traduction sont consignées dans des fichiers qui portent l'extension .po. À partir de ces fichiers, les développeurs de logiciels et les gestionnaires de la documentation sont à même de réinjecter les traductions dans leur logiciel.

Traduire en ligne avec Weblate

Pour commencer, il faut s'inscrire sur http://l10n.opensuse.org

Ensuite, il faut sélectionner un fichier, sa langue (le français) et commencer à suggérer des traductions pour les traductions manquantes ou approximatives.

Télécharger les fichiers PO à traduire

Tous les fichiers PO utilisés pour la traduction sont disponibles sur différents serveurs. Vous pouvez les récupérer facilement par Weblate.


Pour la traduction de la documentation

La traduction de la documentation se fait maintenant via active doc, sur : http://activedoc.opensuse.org/ Il suffit de se créer un compte et de commencer à traduire.

Il est possible (et conseillé) de récupérer les traductions faites dans les versions précédentes de la documentation (infos ci-dessous).

Attention Les informations ci-dessous concernent l'ancienne méthode de traduction est ne doivent servir que de sources pour la nouvelle méthode activedoc.


Chaque fichier XML a un fichier PO correspondant. Les fichiers XML/PO sont répartis en plusieurs catégories (classés par ordre de priorité pour la traduction) :

  • COMMONS (contient divers fichiers communs comme les introductions utilisées dans presque tous les livres)
  • STARTUP (un livre pour les "newbies" sur l'installation, kde, gnome, LibreOffice, la réparation de systèmes, etc...)
  • REFERENCE/SECURITY/TUNNING/VIRTUALIZATION (livres très longs avec plus de données techniques. Certains articles sont néanmoins très utiles.)
Pour télécharger tous les fichiers nécessaires :
 svn checkout  https://svn.opensuse.org/svn/opensuse-doc/trunk/documents/distribution/fr

Puis pour mettre à jour, se placer dans le dossier, puis faire :

 svn up


La répartition des fichiers XML/PO en fonction des livres se trouve sur: Equipe_de_traduction/Documentation.

Les logiciels pour traduire les fichiers PO

Une fois le fichier assigné et téléchargé, il faut traduire ce fichier PO.

Un simple éditeur de texte suffirait puisqu'un fichier PO est un simple fichier texte avec une syntaxe particulière. Néanmoins, il existe des logiciels pour ce type de traduction qui sont beaucoup plus confortables, tels que :

Le plus simple d'utilisation est poEdit et le plus puissant est Lokalize.

Information sur les fichiers PO

Comme dit précédemment, un fichier PO est une fichier texte avec une syntaxe particulière. Il est déconseillé de l'éditer avec un simple fichier texte, à cause de cette syntaxe. Le fichier PO contient la phrase originale, en anglais, ainsi que sa traduction, lorsque celle-ci a été traduite. Trois états de traduction existent :

  • Non traduit : aucune chaîne en français n'est présente pour la phrase originale en anglais donc aucune traduction de cette phrase ne sera présente dans le logiciel final.
  • Brouillon, aussi appelé Fuzzy ou en encore Traduction approximative : Une traduction est présente mais elle n'est pas finie, approximative, ou encore insatisfaisante. Cet état peut être forcé par le logiciel de traduction. Cela peut aussi se produire lorsqu'une chaîne a été traduite précédemment mais que la phrase originale a été légèrement modifiée. La traduction donnée ne sera alors pas présente dans le logiciel final.
  • Traduit : La phrase a été traduite et sera présente dans le logiciel final.

Attention, si vous trouvez une erreur dans la phrase original (en anglais), il ne faut surtout pas la modifier ! Il faut utiliser Bugzilla pour rapporter l'erreur. Ainsi, la correction sera apportée au fichier source, un nouveau fichier POT sera généré et automatiquement fusionné avec votre fichier.

Veuillez lire ENTIÈREMENT la page Les_fichiers_PO_et_POT. Elle contient des informations importantes et nécessaires sur les fichiers PO (structure du fichier, les raccourcis, les variables, les chaînes de formats ou encore les pluriels). Si quelque chose vous échappe dans cette page, posez vos questions sur opensuse-fr@opensuse.org ou sur le forum : Rubrique développez

Statistiques

Vous trouverez des informations sur l'avancement de la traduction d'opensuse sur ces pages en anglais :

Vertaal donne également les statistiques d'avancement des fichiers.

Organisation

Des informations sur l'organisation (fichiers prioritaires, etc.) sont disponibles sur cette page : Equipe_de_traduction/Organisation


Pour aller plus loin

Les informations de cette partie ne sont pas essentielles à la traduction mais peuvent être intéressantes pour certains.


Des outils en ligne de commande très pratiques pour une gestion avancée des fichiers : Les outils gettext

Cette catégorie est utile pour le coordinateur de l'équipe de traduction ainsi que pour ceux qui veulent mettre les mains dans le cambouis. ;)

msgmerge

La commande msgmerge permet de fusionner deux versions de fichiers. Elle est très utiles lorsque l'on a traduit un fichier et que entre temps, le fichier a été mis à jour sur le serveur ! La commande s'utilise alors comme suit :

msgmerge mon_fichier_traduit.fr.po le_fichier_du_serveur.fr.po > fichier_fusion.fr.po

Cela va créer le fichier fichier_fusion.fr.po qui résulte de la fusion des deux précédents.

Sinon, il est possible de mettre directement à jour son fichier :

msgmerge --update mon_fichier_traduit.fr.po le_fichier_du_serveur.fr.po

mon_fichier_traduit.fr.po intégrera alors les modifications de le_fichier_du_serveur.fr.po

Bien faire la fusion dans ce sens, c'est à dire ne pas inverser les deux noms de fichiers.


msgfmt

msgfmt est utile entre autre pour vérifier la bonne structure du fichier par :

msgfmt -C mon_fichier.fr.po

Mais aussi pour calculer les statistiques de traduction :

msgfmt --stat mon_fichier.fr.po


Et d'autres...

D'autres outils gettext existent pour créer, manipuler et utiliser les fichiers PO. Pour plus d'informations, voir : http://www.gnu.org/software/gettext/manual/gettext.html

Tester les traductions...

... de la distribution

À venir...

... de la documentation

Il suffit de regarder la version activedoc sur : http://activedoc.opensuse.org/fr


Pour mémoire, des informations sur l'ancienne méthode :

L'original en anglais est disponible sur : http://doc.opensuse.org/

Une version traduite est mise à jour régulièrement (en fonction de l'avancement des traductions) :

Pour tester les traductions de la documentation, cela est assez simple. Pour commencer, il faut installer les outils nécessaires puis vérifier que l'on est capable de régénérer la documentation en anglais depuis les sources. Ensuite, il fait générer les fichiers XML traduits à partir du fichier PO traduit et du fichier XML de base. Enfin, il faut intégrer le fichier XML traduit à la documentation et générer la documentation en HTML, PDF, etc.

Installer les outils nécessaires

Ajouter le dépôt suivant, qui contient les dernières versions des outils nécessaires, selon votre version d'openSUSE :

Installer avec YaST ou zypper les paquets suivants (éventuellement à compléter) :

 daps xml2po

Télécharger les sources nécessaires

Il faut tout d'abord télécharger les sources et les outils. Pour le "trunk" (fr+en):

svn checkout  https://svn.opensuse.org/svn/opensuse-doc/trunk/documents/distribution/en
svn checkout  https://svn.opensuse.org/svn/opensuse-doc/trunk/documents/distribution/fr
svn checkout  https://svn.opensuse.org/svn/opensuse-doc/trunk/documents/distribution/50-tools
svn checkout  https://svn.opensuse.org/svn/opensuse-doc/trunk/documents/distribution/50-pot
Les sources anglaises (dossier en) sont nécessaires pour les mises à jour (POT, PO et XML) uniquement.


Mise à jour

Mettre à jour les fichiers POT et PO

Dans le dossier fr, lancer les commandes suivantes :

 ../50-tools/generate_POT.sh
 ../50-tools/update_PO.sh fr

Mettre à jour les fichiers XML traduits

Dans le dossier fr, lancer la commande suivante :

 ../50-tools/generate_localized_xml.sh fr

Génération de la documentation traduite en HTML, PDF, etc.

Dans le dossier fr, lancer la génération de la documentation en HTML :

 daps --envfile=ENV-opensuse-all dist-html


Ou en PDF :

 daps --envfile=ENV-opensuse-all color-pdf

Liens utiles