# Manuel utilisateur de &lokalize;

## 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.

Une unité peut être traduite ou non traduite. La traduction d'une unité traduite peut être prête ou non prête (également appelée à mettre à jour parfois). Si l'unité n'est pas prête, sa traduction est rendue en italique. &lokalize; permet de parcourir facilement le fichier, en fonction de l'état de sa traduction. Passez dans le menu Aller pour voir les raccourcis disponibles. La barre d'état au bas de la fenêtre affiche le numéro de la chaîne actuelle, le nombre total de chaînes, le nombre total de chaînes non traduites, le nombre total de chaînes non prêtes (à mettre à jour) et l'état de la chaîne en cours de traduction, respectivement. Lorsqu'on navigue dans le fichier, les unités non traduites sont considérées comme non prêtes. De plus, on peut utiliser la fonctionnalité de filtrage de la vue des outils Unités de traduction. Appuyer sur Page suiv vous amène en réalité à l'unité suivante dans la liste filtrée / triée de cette vue des outils.

Pour faciliter la traduction des applications de console où les espaces dans les messages sont importants, vous pouvez vérifier l'élément Visualiser les séparateurs commes les espaces, les tabulations et les retours à la ligne dans l'élément d'édition sur la page Édition de la fenetre de configuration, pouvant être ouverte par la sélection du menu principale Configuration Configurer &lokalize;....

Si vous n'avez aucun accès au fichier de la traduction originale (c'est une pratique commune à des projets commerciaux de traduction), alors vous pouvez utiliser le fichier de traduction à partir du langage concerné. Veuillez juste choisir l'élément de menu Fichier Effacer toutes les entrées de traduction ou utiliser le raccourci &Ctrl;&Alt;D pour effacer toutes les unités de traduction.

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 les barres d'outils Vous pouvez configurer ici les barres d'outils.

Pour plus d'informations, référez-vous à la section sur les barres d'outils sur les Fondamentaux de &kde;.

### 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.

Pour plus d'informations, référez-vous à la section sur les raccourcis sur les Fondamentaux de &kde;.

### 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.

Il est possible de définir un mode de retour à la ligne pour tout le projet. Veuillez juste utiliser l'élément de menu Projet Configurer le projet... puis ensuite aller sur la page Avancée.

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;.

Vous pouvez filtrer les fichiers totalement traduits à partir de Vue d'ensemble du projet en utilisant le bouton Cacher les éléments traduits dans la barre principale d'outils ou par le raccourci par défaut &Ctrl;T.

Quand vous démarrez &lokalize; une autre fois, le dernier fichier ouvert vous sera proposé par défaut. Vous pouvez changer ce comportement avec l'élément Restaurer les fichiers précédemment ouverts à l'ouverture de &lokalize; sur la page Général de la fenêtre de configuration dont l'ouverture se fait par la sélection de l'élément du menu principal Configuration Configurer &lokalize;.... La même page peut être utilisée pour configurer le comportement de &lokalize; quand vous naviguez entre les onglets. Il est possible de naviguer dans la liste des onglets selon les positions des onglets ou selon leur ordre d'activation.

## 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.

Les entrées obsolètes du mémoire de traduction seront supprimées de la mémoire de traduction de &lokalize; sur un re-balayage ou grâce à un clic sur une entrée manquantes si vous cochez sur l'élément Supprimer les fichiers manquants de la mémoire de traduction grâce à un re-balayage ou un clic sur l'entrée manquante sur la page Mémoire de traduction de la fenêtre de configuration. Celle-ci peut être ouverte par la sélection de l'élément de menu principal Configuration Configurer &lokalize;...

&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 les traductions de &kde; vous pouvez extraire la version « trunk » à `/home/xx/hacking/kde/trunk/l10n-kf5/YOUR_LANG` et la version « branch » `/home/xx/hacking/kde/branches/stable/l10n-kf5/YOUR_LANG`. Créer votre &lokalize; projet : `/home/xx/hacking/kde/trunk/l10n-kf5/YOUR_LANG/project.lokalize` et définir `BranchDir=../../../branches/stable/l10n-kf5/YOUR_LANG`. Vous pouvez ensuite travailler grâce à ce projet et diffuser vos modifications à la fois dans les dossiers pour les versions « 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.

Lorsqu'on traduit des logiciels, on utilise habituellement des outils gettext pour préparer les fichiers de traduction. Quand le texte original change, les outils gettext actualisent les fichiers de traduction et marquent les éléments dont le texte original a changé comme à mettre à jour (ou non prêt dans une autre terminologie). Ils mémorisent le texte original précédent pour que les traducteurs puissent voir quels changements ont été apportés exactement. &lokalize; simplifie la vie du traducteur et surligne les parties du texte original qui ont changé dans la vue Traductions secondaires.

&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 pas, en principe, à 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 kf5-l10n (c'est-à-dire non spécifique à votre langue).

Des exemples de fichiers « .rc » peuvent se trouver dans le dossier d'installation de &lokalize; (habituellement `/usr/share/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. Ceci de fait grâce à une option spécial das le fichier « .rc ». 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

### Pology

Une des applications avec les meilleures capacités de scripts est l'utilisation de Pology dans &lokalize;.

L'interaction avec Pology peut être configuré en utilisant la page Pology de la fenêtre de configuration dont l'ouverture peut être faite par la sélection de l'élément de menu principal Configuration Configurer &lokalize;....

Pour plus d'informations, veuillez consulter la page d'accueil de Pology.

### LanguageTool

LanguageTool propose la vérification orthographique et grammatical de vos unités de traduction.

Vous pouvez configurer votre serveur personnalisé LanguageTool en utilisant la page LanguageTool de la fenêtre de configuration. Celle-ci peut être ouverte par la sélection de l'élément principal de menu Configuration Configurer &lokalize;....

Pour utiliser les capacités de vérification de LanguageTool en utilisant l'élément de menu Modifier Vérifier cette unité avec LanguageTool ou le raccourci &Ctrl;J.

Pour plus d'informations, veuillez consulter la page d'accueil de LanguageTool.

## Remerciements et licence

&lokalize;

Programme sous copyright © 2007-2015, 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; et &OlivierDelaune;

&underFDL; &underGPL;
&documentation.index;