&traducteurPatrickMichelon;

# Utilisation de &kbabel;

## Introduction

D'habitude, les messages de programme et la documentation sont écrits en anglais. Cependant, puisque l'on utilise une structure composée d'une collection d'outils et de librairies, il a été possible d'avoir les programmes favoris dans votre langue native autre que l'anglais. Le processus d'adaptation à une langue spécifique est appelé localisation. Ceci inclut la traduction de l'interface des programmes ainsi que leur documentation dans les langues dont ont besoin les utilisateurs et de faire en sorte que les entrées et les sorties répondent à des conventions particulières dans certains pays ou régions. &kbabel; est un outil qui permet de vous assister lors d'un processus d'internationalisation permettant de faire en sorte que l'interface d'une application soit disponible en plusieurs langues.

Chaque programme orienté localisation rend disponible pour la localisation un ou plusieurs fichiers de catalogue de messages. L'extension de ces fichiers est `.pot`. POT est un acronyme de Portable Object Template.

Chaque traducteur prend une copie d'un fichier POT et commence a traduire les messages. Ce fichier deviendra un fichier PO, Portable Object et représente une seule langue.

Chaque traducteur prend une copie de l'un de ces gabarits POT et commence a remplir les blancs : chaque message est traduit dans la langue désirée. Le fichier contenant le texte traduit est le fichier PO (Portable Object).

Une fois que tous les messages ont été traduits, le fichier PO est compilé dans un format de fichier binaire lisible par la machine, connu sous le nom de fichier MO (Machine Object). Ces fichiers, qui seront stockés avec l'extension `.mo`, agissent comme une base de données pour minimiser le temps pris par les applications pour rechercher chaque message traduit.

Ceci suggère une question : devons nous savoir ce qu'il y a dans un fichier PO même si nous avons &kbabel; ? La réponse est sans aucun doute oui. Il y a des situations ou un catalogue de message peut être corrompu et doit être réparé manuellement. La plupart de ces problèmes sont les très hais conflitsCVS qui surviennent quand un processus de traduction est coordonné par un système de version concourant ( voir la documentationCVS). &kbabel; ne peut pas vous aider beaucoup si un problème comme ceci survient, alors un éditeur de texte et quelques connaissances des fichiers PO sont demandées. Regardons comme un fichier PO est construit.

Les fichiers PO consistent de paires de messages— un msgid et un msgstr. Le msgid est le texte en anglais et le msgstr est le texte traduit dans la langue appropriée. Le texte qui accompagne chaque msgid et msgstr est compris dans des doubles guillemets. Un exemple pris d'un fichier PO pour &noatun;, est `msgid "Ouvrir une liste"`

Les lignes vides et celles commençant par `#` sont ignorées. Les lignes commençant avec un # représentent des commentaires et sont un moyen utile de fournir une note détaillant dans quel fichier ce message sera utilisé et dans le cas de développeurs, de fournir des commentaires additionnels pour faciliter la traduction. &kbabel; affiche ces lignes de commentaires pour chaque message.

Dans de nombreux cas la première paire msgid-msgstr dans un fichier PO est une fausse entrée (agissant comme une en-tête de fichier PO) qui contient diverses informations à propos du fichierPO traduit, comme le nom de l'application, la date de traduction, le nom du traducteur etc.

Les versions récentes de &GNU; gettext ont ajouté une autre fonction utile de i18n appelée formes plurielles. L'anglais utilise seulement le singulier et une forme plurielle des noms, &pex; 1 fichier et10 fichiers. Ceci conduit beaucoup de développeurs à l'idée que le monde est simple et qu'ils peuvent utiliser des messages tels que Voulez-vous supprimer %1 fichier(s), ou`%1` dénote un nombre de fichiers a être supprimés. Mais cela est fondamentalement faux. Pour la traduction Slovaque, il faut trois différentes formes du message. CE nombre est différent pour différentes langues et même quand c'est le même, &pex; le Tchèque utilise aussi trois formes, la règle d'emploi pour utiliser quelle forme peut être très différente.

Les formes plurielles dans les fichiers PO sont ici pour aider. Malheureusement, les développeurs &kde; n'aiment pas les implémentations des formes plurielles dans &GNU; gettext et ils ont introduit leur propre format et gestion pour elles.

## Éditeur

Voici une copie écran de &kbabel;. Pour faciliter son usage, &kbabel; a des barres d'outils pour accélérer beaucoup d'opérations et pour les utilisateurs très occupés, il y a beaucoup de raccourcis clavier. La fenêtre principale est divisée en quatre parties.

La boîte d'éditionsupérieure gaucheest en lecture seule et elle contient le champ du msgid courant du fichier PO ouvert et son texte anglais.

La boîte d'éditioninférieure gauche contient le champ du msgstr relatif au msgid affiché et vous pouvez éditer ici le texte traduit.

La partiesupérieure droite de la fenêtre est un panneau de commentaires dans lequel vous pouvez voir les commentaires ajoutés pour l'entrée en cours d'édition.

Il peut être utilisé pour :

- trouver comment le message courant est traité par l'application (formaté en c ou simple)

- dans certains cas, pour lire des commentaires utiles ajoutés par le développeur de l'application pour aider les traducteurs dans leur travail, par exemple, il peut y avoir des astuces techniques (utilisées avec beaucoup d'effet dans le projetLyX).

- quand vous avez besoin de connaître a quel fichier appartient un message parce que vous voulez rapporter une erreur d'orthographe dans le texte original anglais.

Capture d'écran de &kbabel;
Capture d'écran de &kbabel;

La fenêtre d'édition dans la partie inférieure droite est la plus sophistiquée. Sa taille peut être ajustée au moyen de la ligne séparatrice lui longe l'espace entre elle et le panneau de commentaires. Elle est multifonctionnelle et comporte deux panneaux à onglets : Chercher et Contexte. L'onglet Contexte contient une vue avec barre de défilement montrant les quatre entrées précédentes et les quatre entrées suivantes de l'entrée actuelle. C'est comme si vous pouviez voir un instantané du fichier PO édité. Que cela apporte-t-il ? Il est très courant lorsque vous traduisez que beaucoup de chaînes soient en rapport à la fois avant et après, de sorte que vous puissiez y jeter un oeil si vous n'avez aucun indice sur la meilleure façon de traduire l'entrée actuelle. La traduction d'interfaces de dialogue est un bon exemple, où les éléments graphiques ont avec eux un texte associé et une aide rapide "Qu'est-ce que c'est ?".

### Plus de fonctions de &kbabel;

une entrée msgid peut être dans trois états :

non traduit

  il n'y a pas de texte traduit associé avec msgstr

fuzzy

  `msgmerge` a essayé de trouver une meilleure chaîne traduite dans le reste des entrées du fichier PO. Ceci ne fonctionne pas parfaitement et vous devez éditer le texte traduit pour qu'il corresponde au texte anglais actuel.

traduit

  le msgid est la forme complètement traduite du msgstr

L'état de l'entrée courante est indiquée par deux LED. Selon votre configuration, elles peuvent se trouver dans la barre d'état ou au-dessus de la boîte d'édition de chaîne traduite. Toutes les deux ont une couleur personnalisable pour s'adapter à vos exigences ou vos goûts visuels. Veuillez lire la section Préférences pour voir comment vous pouvez ajuster ces paramètres.

## Traduction avancée

Maintenant vous avez une idée sur la traduction d'un fichier PO. Dans cette section nous suivrons la manière standard pour traduire un nouveau fichier PO en utilisant les fonctions avancées de &kbabel;. Nous supposons que vous avez déjà ouvert un fichier gabarit POT et l'avez enregistré en fichier PO

### Navigation dans un fichier PO

&kbabel; vous permet de naviguer facilement a travers le fichier en fonction de l'état de leur traduction. L'état non traduit/fuzzy a déjà été introduit. Un message peut être marqué comme "en erreur "comme résultat d'une vérification de validation ou de la validation faite par `msgfmt` Évidemment, &kbabel; gère la navigation dans l'historique des messages visités avec Avant/Arrière, comme dans &konqueror;.

Toutes les commandes pour la navigation sont dans le menu Aller

Page précédente | va au message précédent
Page suivante | va au message suivant.
&Ctrl;Page précédente | Va à la première entrée fuzzy précédente
&Ctrl;Page suivante | va au prochain message fuzzy
&Alt;Page précédente | Va à la première entrée non traduite précédente.
&Alt;Page suivante | va au prochain message non traduit
&Maj;Page précédente | va au message d'erreur précédent
&Maj;Page suivante | va au message d'erreur suivant
&Ctrl;&Maj;Page précédente | va au messageFuzzy ou non traduit précédent
&Ctrl;&Maj;Page suivante | va au message Fuzzy ou non traduit suivant

### éditer malin

éditer malin signifie que l'éditeur vous aidera a éditer aisément la traduction tout en prenant en compte les particularités du format PO. Iléchappera quand cela est nécessaire.

Il gère plus d'un mode pour l'insertion des fins de ligne. Ceci est très utile à cause de la manière dont gettext gère les fins de lignes. Il les ignore simplement. (vous pouvez imaginer que tout le texte dans le msgstr est une ligne unique). Si vous voulez insérer une véritable fin de ligne, vous devez insérer un `\n`. Mais la plupart des traducteurs ne réalisent pas qu'une nouvelle ligne dans un msgstrn'ajoute aucun espace entre les lignes. Ceci peut être aisément résolu en ajoutant un espace à la fin de chaque ligne, mais vous pouvez facilement oublier, la fonction éditer malin le fait automatiquement pour vous.

Le tableau ci-dessous récapitule les fonctions d'éditer malin

Tab | Insérer \t
" | Insérer \"
Entrée | Si le dernier caractère avant le curseur n'est pas un espace, insère un espace, puis débute une nouvelle ligne.
&Ctrl;Entrée | Débute une nouvelle ligne sans logique additionnelle.
&Maj;Entrée | Insère un \n et débute une nouvelle ligne

Si vous voulez voir ou sont les espaces, vous pouvez activer Surligner le fond et/ou Marquer les espaces avec des points dans la boîte de dialogue préférences de l'onglet Édition Apparence.

### traduction automatique

Comme première étape lors d'une nouvelle traduction, &kbabel; fournit une fonction pour remplir automatiquement les messages avec d'anciennes traductions. ChoisissezOutils Débrouillage des traductions et &kbabel; présentera la boîte de dialogue suivante :

boîte de dialogue débrouillage des traductions

Dans la boîte de dialogue, vous devez spécifier que traduire et choisir les sources pour les anciennes traductions

En haut de la fenêtreQue traduire il y a trois cases a cocher (Entrées non traduites, Fuzzy entries , Entrées traduites pour spécifier le genre de messages que vous voulez traduire. Les entrées fuzzy et non traduites sont des choix naturels pour la traduction automatique mais vous pouvez aussi changer les messages déjà traduits).

La concordance exacte des msgid est toujours utilisée pour le débrouillage de la traduction. Cependant, vous pouvez ajouter plus de stratégies, par exemple autoriser la traduction fuzzy (lent) et autoriser la traduction de mot unique. Ces deux stratégies additionnelles doivent être gérées par les sources utilisées (voir ci-dessous). Il n'y a pas d'explication sur ce que fait traduction fuzzy , mais le but est assez évident. traduction de mot unique est adaptée a seulement certaines langues. &kbabel; essaie de traduire chaque mot dans le msgid séparément puis mettre les mots traduits (ou groupes de mots) dans le même ordre dans le msgstr .

Comme source pour le débrouillage, n'importe quel module de dictionnaire peut être utilise. Il existe une liste des modules a ne pas utiliser et a utiliser. Le premier module est interroge pour la traduction, s'il n'est pas trouve, le module suivant dans la liste est interroge et ainsi de suite. Vous pouvez utiliser les boutons avec les flèches pour déplacer les modules entre les listes. N'oubliez pas de changer l'ordre pour l'adapter a vos besoins en utilisant les boutonsDéplacer vers le haut et Déplacer vers le bas

Normalement &kbabel; marque chaque message débrouillé en tant que fuzzy parce qu'il considère que toute traduction automatique doit être vérifiée par un traducteur. Si vous êtes a 100 % certain que la traduction automatique est correcte ou que vous allez vérifier de toute manière la traductionMarquer les entrées modifiées comme fuzzy vous permet de désactiver ce marquage fuzzy automatique, mais vous devrez confirmer ceci.

Si vous avez réglé toutes les options pour répondre à vos besoins, appuyez sur le bouton Démarrer pour traduire automatiquement les messages. Vous pouvez suivre la barre de progression et au cas ou, il y a toujours le bouton Arrêt.

### Valider votre traduction

Tout le monde fait des erreurs, par conséquent &kbabel; gère plusieurs vérifications pour les problèmes typiques dans les traductions. Ces vérifications (pas la vérification de syntaxe)peut être conduites de deux manières.

Les vérifications peuvent être faites a chaque changement du texte traduit. Ceux-ci sont appelés vérifications automatiques et peuvent être activées dans la boîte de dialogue configuration de &kbabel; . La vérification automatique de la syntaxe est possible a chaque enregistrement du fichier.

Les vérifications automatiques peuvent ralentir &kbabel;. Si vous avez un ordinateur lent, vous pouvez désactiver les vérifications automatiques et utiliser seulement la deuxième possibilité. Vous pouvez invoquer toutes les vérifications a partir deOutils Validation. Alors la vérification est faite pour tous les messages dans le fichier et ceux comportant des erreurs sont marqués comme erreurs.

Vérification de syntaxe

  Ceci invoque `msgfmt` pour vérifier la validité du fichier PO comme étant vu par le paquet gettext. Il affiche le résultat de la commande et marque les erreurs.

Vérification des arguments

  Des traductions incorrectes peuvent provoquer des erreurs dans l'application. La partie la plus dangereuse d'une traduction est représentée par les arguments, par exemple pour les fonctions de type printf. Cette vérification compare le nombre et le type des arguments dans le msgid et le msgstr. Ils doivent correspondre.

Vérification des accélérateurs

  Les interfaces utilisateurs graphiques contiennent communément des accélérateurs, par exemple des lettres qui peuvent être utilisées pour un accès rapide aux éléments de l'interface graphique par le clavier. Ils sont notés par les caractères spéciaux &pex; & dans &kde;. Une exigence typique de la traduction est que le texte traduit doit aussi contenir les accélérateurs. Cette vérification remarque ce problème pour vous. Le caractère accélérateur peut être spécifié dans Préférences sur l'onglet Divers.

Recherche d'informations de contexte de traduction

  Vous aurez besoin de ceci seulement pour des traductions &kde;. Certains textes sont trop communs et ils doivent être traduits différemment dans différents contextes. Dans &kde;, le contexte est décrit au début du msgid après la séquence spéciale `:_`. Mais certains traducteurs ne sont pas conscients de cette convention et ils peuvent essayer de traduire aussi le contexte d'information. Cette vérification s'occupe de cela. Si la vérification trouve des informations de contexte traduites, vous devez les enlever.

Vérification des formes plurielles

  Si le msgid est spécifié comme une forme plurielle, la traduction doit contenir le nombre correct de traductions séparées par des `\n`. Le nombre correct dépend de la langue de traduction et est spécifié dans l'onglet Identité de la boîte de dialogue Préférences. Ceci est implémenté seulement pour &kde; à l'heure actuelle.

Vérifier les équations

  Les équations sont un format spécial de msgid typiquement utilisé dans les fichiers .desktop. Et parce que vos traductions sont fusionnées avec ces fichiers, le msgstr doit utiliser ce format aussi. Cela signifie que la traduction doit commencer (jusqu'à la première occurrence de `=` avec le même texte que le message original, par exemple `Nom=`.

### Vérification orthographique de la traduction

Comme toujours, il est très important de vérifier l'orthographe de votre traduction avant de l'utiliser. De cette manière vous pouvez trouver des fautes de frappe et d'autres problèmes dans votre traduction. &kbabel; utilise les librairies &kde; standard pour la vérification d'orthographe et ses réglages standards peuvent être trouvés dans la boîte de dialogue configuration de &kbabel;. La vérification d'orthographe elle-même peut être trouvée dans le sous menu Outils Orthographe. Vous pouvez utiliser plusieurs modes pour la vérification d'orthographe.

Vérification orthographique

  Ceci est l'invocation générique d'une boîte de dialogue dans laquelle vous pouvez choisir le mode de vérification et régler un mode par défaut. Ceci est invoqué par &Ctrl;I .

Tout vérifier

  Vérification orthographique de tous les messages dans le fichier

Commence la vérification orthographique depuis la position actuelle du curseur.

  Commence la vérification orthographique dans le message courant et progresse vers la fin du fichier

Vérifier le message courant

  Vérification orthographique du message courant seulement.

Vérifier le texte sélectionné...

  S'il y a du texte sélectionné dans l'éditeur du msgstr, cette option est disponible et la vérification a lieu sur le texte sélectionné seulement.

### Traduire du &XML;, HTML, &etc;

Les langages de balisage sont de plus en plus utilisés dans les interfaces graphiques. Le projet &kde; utilise aussi des fichiers PO pour traduire des fichiers de documentation DocBook (qui est aussi un langage de balisage). &kbabel; contient un bon nombre de fonctionnalités pour gérer cette tendance.

Nous allons décrire ici seulement les fonctions relatives aux balises utilisées pour le balisage en lui-même. L'autre problème introduit par l'utilisation de langages de balisage est la traduction de textes longs. Ce sujet est traité par la fonction diff décrite dans lasection suivante

La version actuelle de &kbabel; est capable de trouver quelles sont les balises utilisées dans le msgid et de fournir un accès aisé vers elles en utilisant les actions suivantes du menu Édition :

Insérer la balise suivante

  Ceci insère la prochaine balise trouvée dans le msgid dans la traduction. &kbabel; trouve la balise devant être insérée en comptant le nombre de balises à partir du début de la traduction

Édition Insérer la balise

  Ce sous-menu contient toutes les balises trouvées dans le texte original anglais. En sélectionnant une balise vous pouvez l'insérer à la position courante du curseur dans le texte traduit.

### Montrer la différence

Comme il a déjà été expliqué, les applications actuelles, en essayant d'être faciles d'utilisation contiennent beaucoup de long textes descriptifs, y compris du balisage. Si un développeur change une partie du texte, le système &GNU; gettext va dans le meilleur des cas garder l'ancienne traduction et la marquer comme fuzzy. (Dans le pire des cas vous perdrez la traduction complète, en fonction de la taille des changements de texte). Ceci fonctionne correctement si un msgid est court, parce que vous pouvez trouver les changements rapidement. Mais si le texte est assez long, vous allez devoir lutter pour trouver ce qui a été changé. (par exemple, cela peut être un changement d'article réalisé par une équipe de relecteurs.

Pour aider, &kbabel; peut être paramétré pour chercher dans le msgid original et de montrer les différences. Les changements sont affichés graphiquement dans la fenêtre Texte original. La manière exacte peut être paramétrée dans la boîte de dialogue configuration de &kbabel;. Outils Différences Montrer les différences affichera les différences trouvées. Pour voir le texte actuel sans le mélange du le texte original avec les différences, utilisez Outils Diff Afficher le texte original.

Vous pouvez activer et désactiver la recherche automatique de différences en choisissant Outils Différences Mode différences

Comme toujours, vous pouvez utiliser différentes sources pour trouver la vieille version du texte, tout étant paramétré dans la boîte de dialogue configuration de &kbabel; :

Base de données des traductions

  Vous pouvez utiliser la base de donnée des traductions pour la recherche des différences. Il est fortement recommandé d'activer le stockage automatique des messages nouvellement traduits dans la base de données dans laboîte de dialogue configuration de la base de données des traductions . Ce mode peut être activé par Utiliser les messages de la base de données des traductions.

Arbre des anciens fichiers

  Ceci est utilisé seulement si la recherche dans la base de données est désactivée. En paramétrant dossier de base pour les fichiers différences vous pouvez naviguer dans &kbabel;, et indiquer quel fichier utiliser pour les différences. Il prend le chemin relatif du fichier ouvert et utilise ce chemin relatif dans le dossier spécifié ici. Si il y a un fichier correspondant, il sera utilisé. Pour utiliser ce mode vous devez faire une copie des anciens fichiers avant chaque mise à jour.

Fichier choisi manuellement

  Si la méthode précédente ne fonctionne pas correctement, vous pouvez toujours paramétrer le fichier de différence manuellement en choisissant Outils Différences Ouvrir le fichier pour les différences.

La recherche de différence n'est pas toujours précise, parce que le fichier PO ne contient pas de référence au message original.

## Formes plurielles

Parce que les formes plurielles sont un sujet plutôt complexe, une section spéciale est consacrée a leur gestion dans &kbabel;.

&kbabel; peut lire les formes plurielles &GNU; mais ne peut pas les éditer. Il ne gère à l'heure actuelle que les versions des formes plurielles &kde;.

Chaque langue dans laquelle &kde; est traduite doit avoir paramétré un nombre correct de formes plurielles. Ceci est effectué en traduisant une entrée dans `kdelibs.po`. Le nombre est choisi en sélectionnant le nom d'une langue, qui utilise le même nombre et les même règles pour trouver la forme de pluriel correcte. La liste à jour des valeurs possibles peut être trouvée dans le code source de kdelibs, dans le fichier `kdecore/klocale.cpp`.

Les formes plurielles de &kde; sont notées par un commentaire `_:` contenant l'argument `%n`. Cet argument est ensuite utilisé dans le message lui-même et il contrôle quelle forme plurielle de votre langue doit être utilisée en fonction des règles de votre langue.

La traduction d'un message de forme plurielle doit avoir un format spécial. Il doit contenir le nombre correct de traductions (une pour chaque forme plurielle) séparée par une fin de ligne `\n`. Par exemple, Fichiers%n choisis, traduit en slovaque est rendu par :

    Vybraný %n súbor\n
    Vybrané %n súbory\n
    Vybraných %n súborov

Pour vérifier que votre traduction comporte le nombre correct de formes plurielles, utilisez le menu Outils Validation Vérifier les formes plurielles (KDE seulement) .