# Manuel utilisateur de &lokalize;

Nick
Shaforostoff

    shaforostoff@kde.ru

&traducteurJoelleCornavin;
2007-2009
Nick Shaforostoff
&FDLNotice;
20/02/2012
1.5

&lokalize; est un système de traduction assistée par ordinateur axé sur la productivité et l'assurance qualité. Offrant les composants habituellement inclus dans les outils de TAO comme une mémoire de traduction, un glossaire et une fonction unique de fusion (synchronisation) de traduction, &lokalize; est destiné à la traduction de logiciels et intègre également des outils de conversion externe pour la traduction de documents de bureau en indépendant.

&lokalize;
localisation
l10n
internationalisation
i18n
traduction
globalisation
g11n
XLIFF
gettext
OpenDocument
KBabel

## Introduction

Habituellement, les messages et la documentation des programmes sont écrits en anglais. Grâce à une infrastructure composée d'un ensemble d'outils et de bibliothèques, il est possible d'obtenir que vos applications favorites soient traduites dans votre langue maternelle autre que l'anglais. Ce processus consistant à adapter une application à une langue spécifique est dénommé localisation. Le processus de localisation inclut la traduction des interfaces et de la documentation du programme en diverses langues dont les utilisateurs ont besoin et, dans certains pays ou régions, rend les entrées et les sorties conformes à des conventions particulières. &lokalize; est un outil qui vous assistera lors du processus de localisation à faire en sorte que l'interface d'une application soit disponible dans de nombreuses langues.

Chaque programme susceptible d'être internationalisé rend disponible à la traduction un ou plusieurs fichiers de catalogues de messages. L'extension de ces fichiers est `.pot`. POT est l'acronyme de Portable Object Template (modèle d'objet portable). &lokalize; est un éditeur de fichiers PO (catalogues de messages gettext de &GNU;) sophistiqué et facile à utiliser. C'est un système de traduction assistée par ordinateur destiné aux traducteurs, écrit ex nihilo à l'aide de l'infrastructure Platform 4 de &kde;. À part l'édition simple de fichiers PO comportant des détails auxiliaires ingénieux, il intègre la prise en charge d'un glossaire, d'une mémoire de traduction, de modes d'affichage des différences pour l'assurance qualité, la gestion de projets, &etc; &lokalize; offre de nombreuses fonctionnalités comme un système de navigation complet, une fonctionnalité d'édition complète, des fonctions de recherche, la vérification syntaxique ainsi que des fonctions statistiques.

Fichiers .po (Portable Object) : chaque traducteur prend une copie d'un de ces modèles POT et commence à remplir les blancs. Chaque message est traduit dans la langue souhaitée. Le fichier contenant le texte traduit est dénommé fichier PO (Portable Object).

## Éditeur

### Fenêtre principale

Par défaut, la fenêtre principale comporte six parties. La partie supérieure droite est en lecture seule et contient le champ msgid actuel (texte source) provenant du fichier PO ouvert. La zone d'édition juste au-dessous contient le champ msgstr (texte cible) lié à la chaîne msgid où vous pouvez y saisir ou modifier le texte traduit.

La fenêtre principale par défaut de &lokalize;
Celle-ci affiche la fenêtre par défaut lorsqu'un fichier est ouvert.

La partie supérieure gauche de la fenêtre principale affiche les Unités de traduction. Au-dessous, se trouve la section Métadonnées des unités contenant les commentaires relatifs au texte source actuellement affiché. Dans la partie inférieure gauche, il existe une section Mémoire de traduction présentant les traductions suggérées, issues de la base de données de traduction pour l'élément de texte source actuel. Dans le coin inférieur droit de la fenêtre, la section Glossaire est affichée.

Les fichiers de traduction sont ouverts dans des onglets séparés, avec deux grandes zones d'édition multilignes ainsi qu'une pléiade de vues d'outils. Ces vues peuvent être superposées (à l'instar d'onglets), affichées séparément ou cachées. Les fichiers de traduction sont composés de nombreuses paires anglais-langue_cible appelées unités. Une unité correspond généralement à une seule chaîne dans l'interface utilisateur ou à un paragraphe dans la documentation. Le but de la première zone d'édition multiligne est d'afficher la partie originale de la paire, celui de la seconde zone d'édition est de présenter la traduction. On peut naviguer parmi les unités par le biais de la vue Unités de traduction ou à l'aide des touches Page suiv et Page préc.

A unit may be translated or untranslated. A translation of a translated unit may be ready or not ready (also called fuzzy sometimes). If the unit is not ready, its translation is rendered in italics. &lokalize; allows you to easily navigate through the file according to the state of their translation. See Go menu for the shortcuts. The status bar at the bottom of the window shows the current string number, total number of strings, total untranslated strings, total not ready (fuzzy) strings and status of the current string respectively. When navigating, untranslated units are treated as not ready. Also, you may use the filtering feature of Translation Units toolview. Pressing Page Down actually takes you to the next unit in filtered/sorted list of that tool view.

Dans la fenêtre principale, on peut ajouter beaucoup d'autres sections, comme les traductions secondaires, la synchronisation principale, la synchronisation secondaire, les unités binaires à l'aide de la section Configuration Vue des outils depuis le menu principal.

### Barres d'outils

On peut ajouter ou supprimer des actions dans la barre d'outils à l'aide de Configuration Configurer les barres d'outils... depuis le menu principal.

Configurer la barre d'outils
Vous pouvez configurer ici la barre d'outils.

For more information read the section about Toolbars of the &kde; Fundamentals.

### Touches de raccourci

On peut gagner du temps en utilisant les touches de raccourcis pendant la traduction. Pour configurer les touches de raccourcis; cliquez sur Configuration Configurer les raccourcis... depuis le menu principal.

Configurer les raccourcis
Vous pouvez configurer ici les touches de raccourcis.

For more information read the section about Shortcuts of the &kde; Fundamentals.

### Astuces générales

Si vous faites des traductions pour &kde;, soit vous avez déjà un fichier projet &lokalize; dans votre dossier de langues (habituellement dénommé `index.lokalize`), soit vous pouvez cliquer sur Projet Créer un nouveau projet, et l'assistant va télécharger les fichiers de traduction correspondant à votre langue et créer le projet à votre place.

Pour une productivité accrue, il est recommandé de s'habituer à utiliser les raccourcis clavier plutôt que les menus et les barres d'outils. Par exemple, utilisez la combinaison &Ctrl;L pour placer le focus sur la ligne de saisie Recherche rapide, afin de filtrer la liste des unités dans la vue Unités de traduction. Une fois que vous avez terminé, appuyez sur Page suiv pour vous déplacer dans la liste filtrée.

Si vous travaillez avec des fichiers de traduction au format XLIFF (ce qui est tout à fait le cas quand on traduit un fichier OpenDocument), des états étendus sont disponibles (nouveau, nécessite une révision, approuvé, etc.). Vous pouvez les sélectionner dans le menu déroulant du bouton Approuvé dans la barre d'outils. La classification de l'état comme prêt ou non prêt dépend de la phase actuelle de flux de production (traduction, révision, approbation). Pour vous, une phase par défaut repose sur votre rôle dans le projet (défini dans les paramètres de projet). Chaque unité contient habituellement des informations sur la phase où elle a été modifiée la dernière fois et, pour chaque phase, son propriétaire est enregistré dans le fichier.

## Projets

### Remarques générales

Les projets constituent l'un des principaux concepts de &lokalize;. Un projet est représenté par un fichier contenant des emplacements, des dossiers avec des traductions, des modèles et d'autres fichiers : un fichier de glossaire, des scripts d'automatisation, des mémoires de traduction. À chaque fois que &lokalize; ouvre un fichier sans un projet chargé, il cherche un fichier de projet dans les dossiers parents (jusqu'à quatre niveaux). Sinon, vous pouvez spécifier le fichier de projet à l'aide du drapeau `--project` en démarrant &lokalize; depuis la ligne de commande.

Pour chaque projet, choisissez votre rôle (traducteur, réviseur, approbateur), lequel, à son tour, affecte une phase de flux de production que &lokalize; détermine automatiquement pour les fichiers que vous modifiez.

Les mémoires de traduction (contrairement aux fichiers de projets, au glossaire et aux scripts) ne sont pas partagées entre les membres des équipes de traduction, puisqu'elles sont créées et enregistrées dans le dossier personnel de l'utilisateur. Cela signifie que les mémoires de traduction de tous les projets sont enregistrées dans le même dossier et ainsi, on peut les employer lorsque d'autres projets sont ouverts.

### Onglet Vue d'ensemble du projet

Lorsque vous démarrez &lokalize; pour la première fois, vous voyez un onglet vide Vue d'ensemble d'un projet. La vue d'ensemble d'un projet est une vue du gestionnaire de fichiers qui vous permet de conserver un aperçu de vos fichiers PO. La suite &lokalize; vous aide à traduire rapidement et aussi à maintenir des traductions cohérentes. Le flux de production de &lokalize; avec lequel vous travaillez impose que vous commenciez en créant ou en ouvrant un projet. L'onglet Vue d'ensemble affiche une arborescence de fichiers comportant des statistiques concernant le projet en cours, tel que le pourcentage des unités entièrement traduites ainsi que le nom du dernier traducteur. Il permet d'ouvrir un fichier sélectionné dans un onglet de la fenêtre actuelle de &lokalize;.

Pour créer un nouveau projet, cliquez sur Projet Créer un nouveau projet. Cette fonction vous guidera tout au long des étapes de création d'un nouveau projet. Dans le menu Projet, on peut également trouver des options comme Vue d'ensemble d'un projet, Configurer un projet, Ouvrir un projet et Ouvrir un projet récent.

Onglet Vue d'ensemble du projet Vous pouvez configurer ici le projet.

L'onglet Vue d'ensemble d'un projet affiche une arborescence de fichiers comportant des statistiques concernant un projet en cours, comme le pourcentage d'unités entièrement traduites ainsi que le nom du dernier traducteur. Il permet d'ouvrir un fichier sélectionné dans un nouvel onglet de la fenêtre actuelle de &lokalize;.

## Glossaire

Vous êtes-vous jamais lassé de saisir la même longue séquence de texte plusieurs fois, simplement parce qu'il faudrait plus de temps pour chercher sa traduction pour en faire un copier-coller ? Désormais, vous n'aurez qu'à chercher la séquence de mots (fréquente) dans la vue Glossaire, puis à l'insérer à l'aide d'un raccourci.

Naturellement, le glossaire devra au préalable être rempli de séquences de mots. &lokalize; comporte un éditeur de glossaire pratique pour effectuer une recherche explicite dans l'ensemble du glossaire.

La vue Glossaire dans le coin inférieur droit affiche des entrées de glossaire appropriées pour l'unité actuelle
La vue Glossaire dans le coin inférieur droit affiche les entrées de glossaire appropriées pour l'unité actuelle

## Mémoire de traduction

La vue Mémoire de traduction permet de glisser-déposer un dossier contenant des fichiers de traduction depuis &dolphin;, par exemple, dans la vue puis en l'espace de quelques minutes, des suggestions de traduction s'affichent automatiquement sur la zone d'édition des unités. Pour insérer les suggestions de traduction dans le fichier, cliquez sur &Ctrl;1, &Ctrl;2 et ainsi de suite, en fonction du numéro de la suggestion.

Cliquez sur Outils Gérer les mémoires de traduction pour ajouter / gérer des projets dans votre mémoire de traduction. Il est également possible ici d'importer ou d'exporter des données provenant d'un format de fichier `tmx`.

Appuyer sur F7 ouvrira l'onglet Mémoire de traduction pour effectuer une recherche librement dans la mémoire de traduction (MT). Un clic sur un résultat de recherche ouvrira un fichier correspondant sur l'unité correspondante. Si vous voulez ouvrir rapidement un fichier quelconque dans le projet (et il est ajouté à la MT), alors au lieu de parcourir Vue d'ensemble d'un projet, saisissez simplement son nom dans le champ Masque de fichier suivi de *.

Le moteur de MT indexe tous les éléments, y compris ceux qui ne sont pas prêts et non traduits. Cette commande permet de remplacer complètement la fonctionnalité Rechercher dans les fichiers qui nécessitait l'analyse de chaque fichier du projet chaque fois qu'on faisait une recherche.

&lokalize; affichant les résultats de la recherche dans la mémoire de traduction pour l'unité actuelle
&lokalize; affichant les résultats de la recherche dans la mémoire de traduction pour l'unité actuelle

Traduction par lots :

  Pour insérer automatiquement la suggestion correspondant exactement depuis la base de données de la mémoire de traduction, cliquez sur Outils Insérer toutes les suggestions exactes OU Insérer toutes les suggestions exactes et marquer comme à mettre à jour. Cette fonctionnalité est similaire au débrouillage des traductions dans &kbabel;.

## Fonctions de synchronisation de la traduction

Le Mode sync (précédemment dénommé Mode de fusion) fait gagner beaucoup de temps aux éditeurs ainsi que dans les cas où deux traducteurs ou plus travaillent simultanément sur le même fichier ou encore quand il s'agit de maintenir des traductions pour plusieurs branches logicielles.

&lokalize; permet de naviguer rapidement dans les unités présentant des différences et affiche ces différences mot par mot. De plus, &lokalize; comporte deux vues de synchronisation - Sync principale et Sync secondaire. Elles sont identiques, mais la première sert habituellement à fusionner les traductions et la seconde à maintenir les traductions synchronisées pour deux branches logicielles.

Après avoir copié la traduction depuis un fichier auxiliaire (l'avoir synchronisé), toute modification ultérieure apportée à cette unité sera répliquée en conséquence dans le fichier auxiliaire.

### Fusion

Une fonction du Mode sync consiste à réviser les modifications apportées par de (nouveaux) contributeurs, quand vous ne pouvez être sûr de la qualité du travail effectué.

Ouvrez un fichier de base, puis glissez sa version modifiée dans la vue Sync principale, suivi de la combinaison &Alt;Page suiv ou &Alt; Page préc (n'oubliez pas qu'il est possible de modifier les raccourcis de la manière habituelle pour les toutes les applications &kde;) pour naviguer parmi les éléments présentant des différences.

&lokalize; utilisé pour fusionner des modifications dans une traduction
&lokalize; utilisé pour fusionner des modifications dans une traduction

### Réplication

Le Mode sync permet également d'apporter des modifications à une traduction pour deux branches simultanément. Fixez l'emplacement du Dossier de la branche, dans les options de votre projet, à l'emplacement correspondant au dossier de base de la branche, et la vue Sync secondaire ouvrira automatiquement les fichiers provenant de la branche. Ensuite, chaque fois que vous effectuerez des changements dans les fichiers de votre branche principale, ils seront automatiquement répliqués dans la branche (si, naturellement, elle contient la même chaîne en anglais).

Par exemple, si vous travaillez sur une traduction &kde;, vous pouvez extraire trunk dans `/home/xx/hacking/kde/trunk/l10n-kde4/VOTRE_LANGUE` branch dans `/home/xx/travail/kde/branches/stable/l10n-kde4/VOTRE_LANGUE`. Créez un projet &lokalize; : `/home/xx/travail/kde/trunk/l10n-kde4/VOTRE_LANGUE/project.lokalize` et définissez `BranchDir=../../../branches/stable/l10n-kde4/VOTRE_LANGUE`, puis travaillez dans ce projet et validez les modifications à la fois dans les dossiers trunk et branch.

### Traductions secondaires

Chaque unité peut présenter plusieurs traductions secondaires qui lui sont associées. De telles traductions peuvent apparaître pendant la mise à jour des fichiers, lorsque la chaîne source est légèrement modifiée. Dans ce cas, l'ancienne traduction ainsi que son (ancienne) source sont déplacées dans la liste des traductions secondaires, de sorte qu'elles ne sont pas perdues.

When translating software, usually gettext tools are used to prepare translation files. When original text changes, gettext tools update translation files and mark entries with changed original text as fuzzy (or non-ready in other terminology). They store previous original text so that translators could see what changes exactly were made. &lokalize; simplifies the life of the translator and highlights parts of the original text that were changed in the Alternate Translations view.

&lokalize; surlignant des parties de texte original qui ont changé depuis la dernière révision de la traduction
&lokalize; surlignant des parties de texte original qui ont changé depuis la dernière révision de la traduction

## Scriptage sous &lokalize;

&lokalize; peut être étendu grâce à des scripts créés dans plusieurs langages interprétés, dont Python et JavaScript. Les scripts sont d'ordinaire intégrés dans l'interface graphique de &lokalize; sous la forme d'actions de menus (auxquelles vous pouvez affecter un raccourci clavier). L'emplacement et le nom de l'élément de menu du script sont définis dans son fichier d'accompagnement .rc. Dans chaque projet ouvert, &lokalize; analyse le dossier `PROJECTDIR/lokalize-scripts`pour chercher les fichiers .rc et les ajoute à un fichier cache appelé `PROJECTDIR/lokalize-scripts/scripts.rc` (ainsi, vous n'aurez en principe pas à l'ajouter au système de contrôle de versions du projet). Les fichiers .rc contiennent également des emplacements de scripts pouvant être relatifs au dossier de fichiers .rc ou à un dossier de scripts système - les deux sont essayés (en fait, ils devraient être conservés dans un emplacement relatif si vous voulez les partager avec d'autres collaborateurs dans votre projet). Par exemple, vous pouvez spécifier `../../scripts/lokalize/opensrc.py` pour charger un script à partir du dossier de scripts global kde-l10n4 (c'est-à-dire non spécifique à votre langue).

Des exemples de fichiers .rc se trouvent dans le dossier d'installation de &lokalize; (habituellement `/usr/share/kde4/apps/lokalize/scripts/`) et le dépôt de KDE. Vous trouverez icidavantage d'exemples de scripts, dont `check-gui.js` fondé sur JavaScript, qui s'exécute automatiquement à chaque enregistrement de fichier. Si vous connaissez Python ou JavaScript, le code devrait être suffisamment explicite.

Voici des liens renvoyant aux références de l'API. Tout ce qui est marqué comme Q_SCRIPTABLE peut être utilisé à partir des scripts.

- La référence de l'API de l'objet Éditeur

- La référence de l'API d'objet de &lokalize;

- La référence de l'API d'objet du projet

## Remerciements et licence

&lokalize;

Programme sous copyright © 2007-2009, Nick Shaforostoff shaforostoff@kde.ru

Une partie du code provient de &kbabel;, le prédécesseur de &lokalize;.

Documentation sous copyright © 2007-2009 Nick Shaforostoff shaforostoff@kde.ru

Auteur :

- Nick Shaforostoff shaforostoff AT kde.ru; Shankar Prasad svenkate AT redhat.com; Sweta Kothari swkothar AT redhat.com

Consultez la page d'accueil de &lokalize; pour plus de détails.

Traduction française par &JoelleCornavin;

&underFDL; &underGPL;

&documentation.index;