Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.

{{tag>tutoriel}}

====== Traduction de programmes avec des fichiers *.po (internationalisation) ======

Les fichiers de traduction utilisent des fichiers *.po ou *.mo.

Il suffit donc de récupérer le fichier original et de l'éditer.

===== Pré-requis =====

  * Installez le paquet **[[apt>Gtranslator]]** ou en ligne de commande :<cli>$ sudo apt install Gtranslator</cli>
  * Installez le paquet **[[apt>spellutils]]**<cli>$ sudo apt install spellutils</cli>
  * Installez le paquet **[[apt>aspell]]** ou en ligne de commande :<cli>$ sudo apt install aspell</cli>
<WRAP center round info 60%>
Pour installer le français,

  * Allez sur [[https://ftp.gnu.org/gnu/aspell/dict/0index.html]]
  * Téléchargez et décompressez le dictionnaire français dans un répertoire de travail
  * Si Aspell et Pspell sont installés et que aspell, word-list-compress et pspell-config sont dans le path, commencez par :<cli prompt='$ ' comment='#'>$ ./configure
Finding Dictionary file location ... /usr/lib/aspell
Finding Data file location ... /usr/lib/aspell</cli>
  * Construisez le paquet avec:<cli prompt='$ ' comment='#'>$ sudo make</cli>
  * installez-le avec :<cli prompt='$ ' comment='#'>$ sudo make install</cli>
  * Pour nettoyer après la construction :<cli prompt='$ ' comment='#'>$ sudo make clean</cli>
  * Pour désinstaller les fichiers :<cli prompt='$ ' comment='#'>$ sudo make uninstall</cli>

Une fois les listes de mots installées, vous pouvez exécuter aspell avec l'option --language-tag=fr.  Vous pouvez aussi choisir le dictionnaire l'option -d ou --master d'Aspell.

Vous pouvez choisir un des dictionnaires suivants :
  * fr_CH-40
  * fr_CH-60
  * fr_CH-80
  * fr_FR-40
  * fr_FR-60
  * fr_FR-80
</WRAP>

===== Première étape : charger le fichier *.po ou *.pot fourni par le programmeur =====

***.po** est le fichier en cours de traduction, ***.pot** est un modèle vide à remplir.

<WRAP center round info 60%>
Par exemple, pour **gnome-recipes** :
  * allez sur la page gnome de gnome-recipes [[https://wiki.gnome.org/Apps/Recipes]]
  * cliquez sur le lien __Development Resources__ :{{ tutoriel:programmation:internationaliser:traduction-01.png?400 |}}
  * cliquez sur le lien __Translations__ :{{ tutoriel:programmation:internationaliser:traduction-02.png?400 |}}
  * cliquez sur le lien de la traduction à travailler :{{ tutoriel:programmation:internationaliser:traduction-03.png?400 |}}
  * un clic droit sur le bouton du fichier po :{{ tutoriel:programmation:internationaliser:traduction-04.png?400 |}}
  * choisissez Enregistrer la cible du lien sous et enregistrez le fichier po dans un répertoire de travail.
</WRAP>

===== Autres étapes =====

==== Démarrage ====

Ouvrez le fichier ***.po** dans **Gtranslator** :
{{ tutoriel:programmation:internationaliser:traduction-05.png?400 |}}

==== Traduire ====

Traduisez les phrases.

<WRAP center round important 60%>
Attention :
Cette traduction automatique peut être assez approximative ! D'ailleurs, le résultat est marqué comme tel, sur fond jaune ! Il convient donc de tout vérifier ! Démonstration :

  list -> liste add gallery -> Ajouter une langue Directory to scan -> répondre à ce commentaire
  * 1e ligne : Traduction correcte : Faites <Alt+U> ou allez dans "Edition/La traduction est approximative" pour valider. La traduction est désormais sur fond blanc.
  * 2e ligne : Traduction partiellement correcte : Il faut corriger dans la partie dédiée en bas et à gauche.
  * 3e ligne : Traduction totalement fantaisiste à modifier entièrement.
</WRAP>

<WRAP center round tip 60%>
Quelques astuces :
  * Sur fond bleu : à traduire entièrement
  * Sur fond jaune : traduction à vérifier
  * Sur fond blanc : traduction validée
</WRAP>

<WRAP center round important 60%>
Tout n'est pas à traduire ! Certaines parties contiennent des variables de programmation à respecter !
  * Les variables sont précédées du signe "%" qui doit être maintenu. Ainsi &Update #1%s sera traduit par &Mettre à &jour #1%s.
  * Le caractère "&" est utilisé pour indiquer le soulignement du caractère qui suit immédiatement. Ainsi &Fichier donnera Fichier. (Pour rappel, un tel soulignement d'une lettre indique le raccourci clavier à utiliser avec la touche <key>ALT</key>.)
</WRAP>

Pour sauvegarder, passez par "enregistrer sous" en nommant votre fichier fr_FR.po.

Vous pouvez faire également des copies de sécurité pour reprendre votre travail en cas de corruption du fichier *.po.

==== Vérifier l'orthographe du fichier .po ====

Le paquet **spellutils** contient un outil appelé **pospell** qui permet de vérifier l'orthographe d'un fichier .po, en utilisant un correcteur orthographique tel que **aspell** :
<cli prompt='$ ' comment='#'>$ pospell -n logiciel.po -p aspell check %f</cli>

==== Valider un fichier .po ====

La commande **msgfmt** du paquet gettext produit une version binaire ***.mo** du fichier *.po, utilisable pour traduire le logiciel, mais aussi valide son format :
<cli prompt='$ ' comment='#'>$ msgfmt -c -o logiciel.mo logiciel.po</cli>

==== Mettre en place la localisation ====

<WRAP center round info 60%>
C'est un fichier *.mo qui assure la localisation qui est généralement enregistré dans :
  /usr/share/locale/fr/LC_MESSAGES/nom_de_logiciel.mo
ou
  /usr/share/locale/fr_FR/LC_MESSAGES/nom_de_logiciel.mo
</WRAP>

<cli prompt='$ ' comment='#'>$ sudo cp nom_de_logiciel.mo /usr/share/locale/fr_FR/LC-MESSAGES/nom_de_logiciel.mo</cli>

Lancez ou relancez l'application pour vérifier le résultat.

===== Conclusion =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(fr)** [[https://traduc.org/L%27adaptation_des_logiciels/Exemple%20d%27utilisation%20de%20Gettext]]
  * Traduire un logiciel open-source (poEdit) : [[https://www.commentcamarche.net/faq/6326-traduire-un-logiciel-open-source-poedit]]
  * comment traduire un logiciel open source mais a partir de zero quand il est encore monolanguage :[[https://openclassrooms.com/forum/sujet/comment-traduire-un-logiciel-open-source-23537]]
  * [[https://www.commentcamarche.net/faq/6326-traduire-un-logiciel-open-source-poedit]]

----
//Basé sur << [[http://|Article]] >> par Auteur.//

Piste : • Comment déboguer un script bash ? • Jitsi Meet : comment organiser des réunions en ligne rapidement et simplement • Grsync • Raspberry Pi : connexion USB d'un disque dur externe ou d'une clé USB • Win32diskimager : écriture d'un fichier .img sur une carte SD (en mode graphique) • De Nginx à Apache : remplacer Nginx par Apache sans perdre les données du site Web et avec le minimum de temps d'arrêt • Synchronisation : Fullsync • Créer un disque internet avec accès webDAV • Traduction de programmes avec des fichiers *.po (internationalisation) • Comment remplacer Apache par Lighttpd

Documentation du Dr FRAPPE

Recherche

Navigation

Imprimer/exporter

Outils

QR Code