<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY lokalize "Lokalize">
<!ENTITY kaider "Lokalize">
<!ENTITY kappname "Lokalize">
<!ENTITY package "kdesdk">
<!ENTITY % addindex "IGNORE">
<!ENTITY % French "INCLUDE">
]>
<book id="lokalize" lang="&language;">
<bookinfo>
<title
>Manuel de &lokalize;</title>
<authorgroup>
<author
><firstname
>Nick</firstname
> <surname
>Shaforostoff</surname
> <affiliation
><address
><email
>shaforostoff@kde.ru</email
></address
></affiliation>
</author>
&traducteurJoelleCornavin; 
</authorgroup>

<copyright>
<year
>2007-2009</year
><holder
>Nick Shaforostoff</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>09/05/2009</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&lokalize; est un système de traduction assistée par ordinateur axé sur la productivité et l'assurance de qualité. Offrant les composants habituels en matière d'outils de TAO : mémoire de traduction, glossaire, ainsi qu'une fonction de fusion (synchronisation) de traduction unique, &lokalize; est destiné à la traduction de logiciels et intègre également des outils externes de conversion pour la traduction de documents de bureau en indépendant. </para>
</abstract>

<keywordset>
<keyword
>&lokalize;</keyword>
<keyword
>localisation</keyword>
<keyword
>l10n</keyword>
<keyword
>internationalisation</keyword>
<keyword
>i18n</keyword>
<keyword
>traduction</keyword>
<keyword
>globalisation</keyword>
<keyword
>g11n</keyword>
<keyword
>XLIFF</keyword>
<keyword
>gettext</keyword>
<keyword
>OpenDocument</keyword>
<keyword
>KBabel</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduction</title>

<para
>Lorsque vous lancez &lokalize; la première fois, vous voyez un onglet <guilabel
>Vue d'ensemble du projet</guilabel
>. Le flux de travail de Lokalize impose de démarrer avec la création / l'ouverture d'un projet. </para>
<para
>Si vous travaillez en mode autonome, il est probable que vous allez traduire un fichier OpenDocument. Pour ce faire, cliquez sur <menuchoice
><guimenu
>Projet</guimenu
><guimenuitem
>Créer un nouveau projet</guimenuitem
></menuchoice
>. L'assistant va vous interroger à propos de votre document source, le convertir au format interne de &lokalize;, XLIFF et créer un projet en conséquence. Quand vous avez fini de traduire, cliquez sur <menuchoice
><guimenu
>Outils</guimenu
><guimenuitem
>Fusionner dans ODF</guimenuitem
></menuchoice
> pour intégrer votre traduction dans une copie du document source. </para>

<para
>Si vous faites des traductions pour KDE, soit vous avez déjà un fichier projet &lokalize; dans votre dossier de langues (habituellement dénommé <filename
>index.lokalize</filename
>), soit vous pouvez choisir <menuchoice
><guimenu
>Projet</guimenu
><guimenuitem
>Créer un nouveau projet</guimenuitem
></menuchoice
> : l'assistant télécharge les fichiers de traduction correspondant à votre langue et crée le projet à votre place. </para>

<para
>Les fichiers de traduction sont ouverts dans un onglet séparé, présentant deux grandes zones d'édition multilignes ainsi qu'une pléiade de <emphasis
>vues d'outils</emphasis
>. Ces vues peuvent être superposées (à l'instar d'onglets), affichées séparément ou masquées. Les fichiers de traduction sont composés de nombreuses paires anglais-langue_cible appelées <emphasis
>unités</emphasis
>. Une <emphasis
>unité</emphasis
> 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 montrer la traduction. Vous pouvez naviguer dans les <emphasis
>unités</emphasis
> par le biais de la vue <guilabel
>Unités de traduction</guilabel
> ou à l'aide des touches <keycap
>Page suivante</keycap
> et <keycap
>Page précédente</keycap
>. </para>

<tip>
<para
>Pour une productivité accrue, il est recommandé de s'habituer aux raccourcis clavier plutôt qu'aux menus et aux barres d'outils. Par exemple, utilisez la combinaison <keycombo
>&Ctrl;<keycap
>L</keycap
></keycombo
> pour mettre le focus sur la ligne de saisie <guilabel
>Recherche rapide</guilabel
>, pour filtrer la liste des unités dans la vue <guilabel
>Unités de traduction</guilabel
>. Une fois que vous avez terminé, appuyez sur <keycap
>Page suivante</keycap
> pour vous déplacer dans la liste filtrée. </para>
</tip>

<para
>Une unité peut être <emphasis
>traduite</emphasis
> ou <emphasis
>non traduite</emphasis
>. La traduction d'une unité traduite peut être <emphasis
>prête</emphasis
> ou <emphasis
>non prête</emphasis
> (également appelée parfois <emphasis
>à mettre à jour</emphasis
>). 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. Reportez-vous au menu <guilabel
>Aller</guilabel
> pour voir les raccourcis disponibles. Lorsque vous naviguez dans le fichier, les unités non traduites sont considérées comme <quote
>non prêtes</quote
>. De plus, vous pouvez utiliser la fonctionnalité de filtrage de la vue des outils <guilabel
>Unités de traduction</guilabel
>. Appuyer sur <keycap
>Page suivante</keycap
> vous amène effectivement à la prochaine unité dans la liste filtrée / triée de cette vue des outils. </para>

<para
>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 (<emphasis
>nouveau</emphasis
>, <emphasis
>nécessite une révision</emphasis
>, <emphasis
>approuvé</emphasis
>, etc.). Vous pouvez les sélectionner dans le menu déroulant du bouton <guilabel
>Approuvé</guilabel
> dans la barre d'outils. La classification de l'état comme <emphasis
>prêt</emphasis
> ou <emphasis
>non prêt</emphasis
> dépend de la phase actuelle de <emphasis
>flux de travail</emphasis
> (<emphasis
>traduction</emphasis
>, <emphasis
>révision</emphasis
>, <emphasis
>approbation</emphasis
>). Pour vous, une phase par défaut repose sur votre <emphasis
>rôle</emphasis
> 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. </para>

</chapter>

<chapter id="projects">
<title
>Projets</title>

<para
>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 qu'il y ait un projet chargé, il recherche un fichier de projet dans les dossiers parents (jusqu'à quatre niveaux). Sinon, vous pouvez indiquer le fichier de projet à l'aide du drapeau <userinput
>--project</userinput
> en démarrant &lokalize; depuis la ligne de commande. </para>

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

<note>
<para
>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, elles peuvent employées lorsque d'autres projets sont ouverts. </para>
</note>

<sect1 id="project-view">
<title
>Onglet <quote
>Vue d'ensemble du projet</quote
></title>

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

</sect1>

</chapter>

<chapter id="glossary">
<title
>Glossaire</title>

<para
>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 <guilabel
>Glossaire</guilabel
>, puis à l'insérer à l'aide d'un raccourci. </para>

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

<screenshot>
<screeninfo
>La vue <quote
>Glossaire</quote
> dans le coin inférieur droit affiche des entrées de glossaire appropriées pour l'unité actuelle</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="glossary.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>La vue <quote
>Glossaire</quote
> dans le coin inférieur droit affiche les entrées de glossaire appropriées pour l'unité actuelle</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>

<chapter id="tm">
<title
>Mémoire de traduction</title>

<para
>La vue <guilabel
>Mémoire de traduction</guilabel
> permet de glisser-et-déposer dans la vue un dossier contenant des fichiers de traduction à partir de Dolphin, par exemple, 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 <keycombo
><keycap
>&Ctrl;</keycap
><keycap
>1</keycap
></keycombo
>, <keycombo
><keycap
>&Ctrl;</keycap
><keycap
>2</keycap
></keycombo
> et ainsi de suite, en fonction du numéro de la suggestion. </para>

<para
>En appuyant sur <keycombo
><keycap
>F7</keycap
></keycombo
>, on ouvre l'onglet <guilabel
>Mémoire de traduction</guilabel
> permettant d'effectuer une recherche libre dans la MT. Un clic sur un résultat de recherche ouvre 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 <guilabel
>Vue d'ensemble du projet</guilabel
>, saisissez simplement son nom dans le champ <guilabel
>Masque de fichier</guilabel
> suivi de <quote
>*</quote
>. </para>

<para
>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é <quote
>Rechercher dans les fichiers</quote
> qui nécessitait l'analyse de chaque fichier du projet chaque fois qu'on faisait une recherche. </para>

<screenshot>
<screeninfo
>&lokalize; affichant les résultats de la recherche dans la mémoire de traduction pour l'unité actuelle</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tmview.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; affichant les résultats de la recherche dans la mémoire de traduction pour l'unité actuelle</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>


<chapter id="sync">
<title
>Fonctions de synchronisation de la traduction</title>

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

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

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

<sect1 id="file-merge">
<title
>Fusion</title>
<para
>Une fonction du <guilabel
>Mode sync</guilabel
> consiste à réviser les modifications apportées par les (nouveaux) contributeurs, quand vous ne pouvez être sûr de la qualité du travail effectué. </para>
<para
>Ouvrez un fichier de base, puis glissez sa version modifiée dans la vue <guilabel
>Sync principale</guilabel
>, suivi de la combinaison <keycombo
><keycap
>&Alt;</keycap
><keycap
>Page suivante</keycap
></keycombo
> ou <keycombo
><keycap
>&Alt;</keycap
> <keycap
>Page précédente</keycap
></keycombo
> (n'oubliez pas que les raccourcis peuvent être modifiés de la manière habituelle pour les toutes les applications &kde;) pour naviguer parmi les éléments présentant des différences. </para>
<screenshot>
<screeninfo
>&lokalize; utilisé pour fusionner des modifications dans une traduction</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sync.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; utilisé pour fusionner des modifications dans une traduction</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</sect1>

<sect1 id="file-sync">
<title
>Réplication</title>
<para
>Le <guilabel
>Mode sync</guilabel
> permet également d'apporter des modifications à une traduction dans deux branches simultanément. Associez l'emplacement du <guilabel
>Dossier de la branche</guilabel
>, dans les options de votre projet, à l'emplacement correspondant au dossier de base de la branche, et la vue <guilabel
>Sync secondaire</guilabel
> ouvre 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). </para>
<para
>Par exemple, si vous travaillez sur une traduction KDE, vous pouvez extraire <quote
>trunk</quote
> dans <filename class="directory"
>/home/xx/hacking/kde/trunk/l10n-kde4/VOTRE_LANGUE</filename
> <quote
>branch</quote
> dans <filename class="directory"
>/home/xx/travail/kde/branches/stable/l10n-kde4/VOTRE_LANGUE</filename
>. Créez un projet &lokalize; : <filename
>/home/xx/travail/kde/trunk/l10n-kde4/VOTRE_LANGUE/project.lokalize</filename
> et définissez <filename class="directory"
>BranchDir=../../../branches/stable/l10n-kde4/VOTRE_LANGUE</filename
>, puis travaillez dans ce projet et validez les modifications à la fois dans les dossiers <quote
>trunk</quote
> et <quote
>branch</quote
>. </para>
</sect1>


<sect1 id="alt-trans">
<title
>Traductions secondaires</title>

<para
>Chaque unité peut présenter plusieurs <emphasis
>traductions secondaires</emphasis
> 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 avec son (ancienne) source est déplacée dans les traductions secondaires, ainsi elles ne sont pas perdues. </para>
<para
>Lorsqu'on traduit des logiciels, on utilise habituellement des outils gettext pour préparer les fichiers de traduction. Lorsque le texte original change, les outils gettext actualisent les fichiers de traduction et marquent les éléments dont le texte original a changé comme <emphasis
>à mettre à jour</emphasis
> (ou <emphasis
>non prêt</emphasis
> dans une autre terminologie). Ils enregistrent 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 met en surbrillance les parties du texte original qui ont été modifiées dans la vue <guilabel
>Traductions secondaires</guilabel
>. </para>

<screenshot>
<screeninfo
>&lokalize; mettant en surbrillance des parties de texte original qui ont changé depuis la dernière révision de la traduction</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="original-diff.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; mettant en surbrillance des parties de texte original qui ont changé depuis la dernière révision de la traduction</phrase>
    </textobject>
  </mediaobject>
</screenshot>


</sect1>

</chapter>

<chapter id="scripting">
<title
>Scriptage sous &lokalize;</title>

<para
>&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 <quote
>.rc</quote
>. Dans chaque projet ouvert, &lokalize; analyse le dossier <filename
>PROJECTDIR/lokalize-scripts</filename
> pour rechercher les fichiers <quote
>.rc</quote
> et les ajoute à un fichier <emphasis
>cache</emphasis
>appelé <filename
>PROJECTDIR/lokalize-scripts/scripts.rc</filename
> (ainsi, vous n'aurez en principe pas à l'ajouter au système de contrôle de versions du projet). Les fichiers <quote
>.rc</quote
> contiennent également des emplacements de scripts pouvant être relatifs au dossier de fichiers <quote
>.rc</quote
> ou à un dossier de scripts système - les deux sont essayés (en fait, ils <emphasis
>devraient</emphasis
> être relatifs si vous voulez partager un fichier <quote
>.rc</quote
> avec d'autres collaborateurs dans votre projet). Donc vous pouvez, par exemple, spécifier <filename
>../../scripts/lokalize/opensrc.py</filename
> pour charger un script à partir du <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>dossier de scripts global kde-l10n4</ulink
> (c'est-à-dire non spécifique à votre langue). </para>
<para
>Des exemples de fichiers <quote
>.rc</quote
> se trouvent dans le dossier d'installation de &lokalize; (habituellement <filename
>/usr/share/kde4/apps/lokalize/scripts/</filename
>) et le <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>dépôt de KDE</ulink
>. Vous trouverez <ulink url="http://websvn.kde.org/trunk/l10n-kde4/ru/lokalize-scripts/"
>ici</ulink
> davantage d'exemples de scripts, dont <filename
>check-gui.js</filename
> fondé sur JavaScript, qui s'exécute automatiquement à chaque enregistrement de fichier. Si vous connaissez Python ou JavaScript, le code devrait être suffisamment explicite. </para>
<para
>Voici des liens renvoyant aux références de l'API. Tout ce qui est marqué comme <emphasis
>Q_SCRIPTABLE</emphasis
> peut être utilisé à partir des scripts. </para>

<itemizedlist>
<listitem>
<para
>La référence de l'API de l'objet <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classEditorTab.html"
>Éditeur</ulink
> </para>
</listitem>
<listitem>
<para
>La référence de l'API de l'objet <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classLokalizeMainWindow.html"
>Lokalize</ulink
> </para>
</listitem>
<listitem>
<para
>La référence de l'API de l'objet <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classProjectTab.html"
>Projet</ulink
> </para>
</listitem>
</itemizedlist>


</chapter>

<chapter id="credits">
<title
>Remerciements et licence</title>

<para
>&lokalize; </para>

<para
>Programme sous copyright &copy; 2007-2009, Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Une partie du code est tirée de &kbabel;, le prédécesseur de &lokalize;. </para>

<para
>Documentation sous copyright &copy; 2007-2009 Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Auteur : <itemizedlist
> <listitem
> <para
>Nick Shaforostoff <email
>shaforostoff AT kde.ru</email
> </para>
</listitem>
</itemizedlist>
</para>

<para
>Consultez la <ulink url="http://userbase.kde.org/lokalize"
>page d'accueil de &lokalize;</ulink
> pour plus de détails.</para>

<para
>Traduction française par &JoelleCornavin;</para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->