<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kapp "&khangman;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title>Manuel de &khangman;</title>

<authorgroup>
<author>
<firstname>Anne-Marie</firstname>
<othername></othername>
<surname>Mahfouf</surname>
<affiliation>
<address><email>annma@kde.org</email></address>
</affiliation>
</author>
&traducteurLudovicGrossard;
&traducteurAnneMarieMahfouf;
</authorgroup>


<copyright>
<year>2001</year><year>2003</year>
<holder>Anne-Marie Mahfouf</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>


<date>22-04-2004</date>
<releaseinfo>1.4</releaseinfo>

<abstract>
<para>
&khangman; est le jeu classique du pendu pour les enfants, adapté pour &kde;.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdeedu</keyword>
<keyword>KHangMan (Le Pendu de KDE)</keyword>
<keyword>pendu</keyword>
<keyword>jeu</keyword>
<keyword>enfant</keyword>
<keyword>mots</keyword>
</keywordset>

</bookinfo>

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

<para>
&khangman; est un jeu basé sur le jeu bien connu du pendu. Il est destiné aux enfants de 6 ans et plus. Il présente quatre niveaux : Animaux (noms d'animaux), Facile, Moyen et Difficile. Un mot dont les lettres sont cachées est sélectionné de façon aléatoire, vous devez deviner le mot en essayant une lettre après l'autre. Chaque fois que vous devinez une lettre fausse, l'image d'un pendu est progressivement dessinée. Vous devez deviner le mot avant d'être pendu ! Vous avez 10 essais.
</para>

</chapter>

<chapter id="using-khangman">
<title>Utilisation de &khangman;</title>

<screenshot>
<screeninfo>Voici une copie d'écran de &khangman; lors du premier lancement.</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase>Copie d'écran de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>
Vous voyez ici &khangman; tel qu'à la première utilisation. Le niveau est réglé sur Animaux, la langue est à son réglage par défaut (ici le français), il n'y a pas de thème de fond et les images du pendu ne sont pas transparentes. Tout changement de niveau, de langue ou de thème de fond est enregistré dans le fichier de configuration et sera restauré lors de votre partie suivante.
</para>

<para>
Remarquez la facilité avec laquelle on change de niveau et de thème de fond en cliquant sur les listes déroulantes de la barre d'outils. L'obtention d'un nouveau mot et la sortie du jeu se font tout aussi facilement en cliquant sur les boutons correspondants de la barre d'outils.
</para>

<sect1 id="general-usage">
<title>Utilisation générale</title>

<!-- FIXME: A word can't really be displayed and hidden at the same time, -->
<!-- although I can't think of a better way to phrase this -->
<para>
Un mot est affiché, mais masqué : vous savez combien de lettres il comporte. Vous devez deviner quel est ce mot en essayant une lettre après l'autre. Le choix du mot est aléatoire mais deux mots consécutifs ne sont pas identiques.
</para>

<important><para>Tous les mots sont sont des noms propres (pas de verbes, d'adjectifs, &etc;).</para></important>

<para>
Il est sans importance que vous tapiez en minuscules ou majuscules. Le logiciel convertit automatiquement toute entrée en minuscules à l'exception des mots allemands, qui commencent par une majuscule.  Le programme fait cela automatiquement.
</para>

<para> 
Le niveau et la langue en cours sont affichés dans la barre d'état. 
</para>

<para>
Chaque fois que vous annoncez une lettre qui n'est pas dans le mot, l'image du pendu est partiellement complétée. Vous avez 10 essais pour deviner le mot, après quoi il est affiché.
</para>

<para>
Il y a quatre niveaux : facile, moyen, difficile et animaux, plus d'autres sujets pour certaines langues. Le logiciel recherche tous les fichiers de données disponibles pour toutes les langues.
 </para>
 
<para>
Le niveau facile, dont les mots sont tout-à-fait simples et reliés à la vie quotidienne, convient aux enfants de 6 à 9 ans. Le niveau des animaux contient seulement des noms d'animaux, si bien qu'ils sont plus faciles à trouver. Certains d'entre eux sont faciles, d'autres sont plus difficiles. Le niveau moyen, dont les mots sont plus longs et plus difficiles, convient aux plus de 9 ans. Le niveau difficile est... dur, &cad; que les mots sont difficiles à orthographier et pas très répandus. Un défi, même pour des adultes.
</para>

<para>Après qu'un mot a été deviné (ou que le pendu a été complété), vous êtes invité à poursuivre avec un autre mot et vous pouvez répondre oui ou non soit en saisissant 
<keycap>O</keycap> ou <keycap>N</keycap> au clavier soit en utilisant la souris. Si vous répondez <guilabel>Non</guilabel>, le jeu est fermé. Si vous répondez <guilabel>Oui</guilabel>, un autre mot vous est proposé.
</para>

<!-- FIXME: should we call it 'field' or 'text edit' or...? -->
<para>Vous tapez la lettre que vous souhaitez essayer (le curseur est déjà dans le bon champ) puis vous tapez la touche &Enter;. Si la lettre appartient au mot, elle y prend sa place autant de fois qu'elle doit y figurer. Si elle n'y appartient pas, elle va dans le champ des Ratés et une partie supplémentaire du pendu est dessinée sur la droite. Vous avez dix essais, après quoi vous perdez et le mot correct est affiché.
</para>

<para>Pendant la partie, vous pouvez choisir de démarrer une nouvelle partie en allant dans le menu <guimenu>Jeu</guimenu> et en choisissant <guimenuitem>Nouveau</guimenuitem>, ou en cliquant sur l'icône <guiicon>Nouveau</guiicon> dans la barre d'outils. Vous pouvez également changer le niveau avec le bouton de niveau de la barre d'outils (cela vous proposera en même temps un nouveau mot correspondant à ce niveau).</para>

<para>
Des améliorations futures vous permettront de créer vos propres fichiers de mots ou de charger un fichier différent des quatre déjà proposés.
</para>
</sect1>

<sect1 id="languages">
<title>Jouer dans différentes langues</title>
<para>
Vous pouvez jouer à &khangman; dans dix-neuf langues&nbsp;: brésilien portugais, catalan, tchèque, danois, néerlandais, anglais,
finlandais, français, allemand, hongrois, italien, norvégien (Bokm&#229;l), portugais, espagnol, serbe (latin et cyrillique), slovène, tadjik et suédois. 
</para>

<para>
Par défaut, après la première installation de &khangman; pour KDE 3.3, seuls l'anglais et votre langue pour &kde; si elle fait partie de la liste ci-dessus et si vous avez le paquetage kde-i18n correspondant seront installées. Par exemple, si vous êtes un utilisateur danois et si vous avez &kde; en danois, &khangman; <guimenu>Langues</guimenu> aura deux entrées&nbsp;: anglais et danois et danois sera le défaut.
</para>

<para>
Vous pouvez quand même jouer à &khangman; dans d'autres langues. Il est très facile d'ajouter de nouvelles données dans &khangman;. Tout ce dont vous avez besoin est une connexion internet qui fonctionne. 
Vous cliquez dans le menu <guimenu>Fichier</guimenu> puis sur <guimenu>Télécharger une nouvelle langue...</guimenu>. Une boîte de dialogue apparaît, comme celle-ci&nbsp;:
</para>

<screenshot>
<screeninfo>La boîte de dialogue Télécharger une nouvelle langue &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase> Copie d'écran Télécharger une nouvelle langue</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>
Cliquez sur le nom de la langue que vous voulez installer puis sur le bouton Installer. Une boîte de dialogue vous dira lorsque la langue est installée en affichant&nbsp;: Les nouveautés ont été installées avec succès. Vous cliquez sur OK pour fermer cette boîte de dialogue d'information puis sur Fermer pour fermer la boîte de dialogue de téléchargement (si vous voulez des données dans une autre langue, veuillez répéter ces étapes). La nouvelle langue est maintenant disponible&nbsp;!
</para>

<para>
Vous pouvez ensuite facilement changer la langue en allant dans le menu <guimenu>Langues</guimenu> et vous choisissez une langue disponible.
</para>

<para>
Veuillez noter que vous pouvez désormais saisir les caractères spéciaux d'une langue en affichant la <interface>Barre d'outils des Caractères spéciaux</interface>. Cette barre d'outils contient des boutons avec les icônes de chaque caractère spécial d'une langue donnée, comme par exemple le &eacute; en français. Cliquer sur l'un de ces boutons entraîne l'affichage de la lettre lui correspondant dans le champ de saisie, puis la validation se fait avec Entrée. Vous pouvez bien entendu aussi utiliser la disposition de clavier correspondant à la langue choisie. La barre d'outils peut être affichée ou cachée, réglage qui sera réutilisé à la prochaine utilisation de &khangman;.
</para>

<important><para>
Veuillez noter que vous devez avoir les polices Arial et URW Bookman pour afficher correctement les caractères spéciaux dans certaines langues. Si vous avez ces deux polices installées, &khangman; va automatiquement les utiliser. Si vous voyez des petits rectangles à la place de lettres, il est probable que l'une de ces deux polices manque.
</para></important>

</sect1>
<sect1 id="few-tips">
<title>Quelques astuces</title>
<para>
Essayez d'abord de deviner les voyelles. Testez ensuite les consonnes les plus courantes : s, r, t, n, l. 
</para>
<para>
Quand vous voyez <quote>io</quote>, essayez n après cela, en français comme en anglais. 
</para>
<para>
En catalan, espagnol, portugais et portugais du Brésil, les voyelles accentuées peuvent être découvertes en saisissant la voyelle non-accentuée correspondante. Par exemple, tous les <quote>a</quote> accentués du mot sont affichés quand vous tapez <quote>a</quote>. Cela est vrai lorsque <menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Taper les lettres accentuées</guimenuitem></menuchoice> n'est pas coché. Dans le cas où <menuchoice><guimenu>Configuration</guimenu> <guimenuitem>Taper les lettres accentuées</guimenuitem></menuchoice> est coché, vous devez saisir les lettres accentuées vous-même. Quand vous tapez <quote>a</quote
>, seul <quote>a</quote> est affiché et vous devez par exemple saisir &atilde; pour que cette lettre soit affichée.
</para>
<para>
Le saviez-vous ? En français, les lettres les plus utilisées sont e (17,2%), suivi par a (8,4%), puis s (8,1%), i (7,3%) et n (7,1%). 
</para>
</sect1>


</chapter>

<chapter id="menus">
<title>Barre de menu et barres d'outils</title>

<sect1 id="mainwindow">
<title>La fenêtre principale de &khangman;</title>

<para>Le menu <guimenu>Jeu</guimenu> a trois éléments : <guimenuitem>Nouveau</guimenuitem>, <guimenuitem>Télécharger une nouvelle langue...</guimenuitem> et <guimenuitem>Quitter</guimenuitem>.
</para>

<para><guimenuitem>Nouveau</guimenuitem> lance une nouvelle partie en vous proposant un nouveau mot à deviner dans le niveau en cours. <guimenuitem>Télécharger une nouvelle langue...</guimenuitem> va afficher la boîte de dialogue pour télécharger des données dans une nouvelle langue. <guimenuitem>Quitter</guimenuitem> termine le jeu en fermant la fenêtre principale et en écrivant les réglages courants dans le fichier de configuration.</para>

<para>Le menu <guimenu>Langues</guimenu> a une ou deux langues par défaut&nbsp;: l'anglais et la langue de votre &kde; si elle est disponible (si votre langue dans &kde; est l'une des dix-huit suivantes&nbsp;: tchèque, portugais du Brésil, catalan, danois, néerlandais, finlandais, français, allemand, hongrois, italien, norvégien (Bokm&#229;l), portugais, espagnol, slovène, serbe en latin, serbe en cyrillique, suédois et tadjik et si vous avez le paquetage i18n correspondant installé alors cette langue sera le défaut. Après votre premier jeu, la langue que vous avez choisie la dernière fois que vous avez utilisé  &khangman; sera restaurée.
</para>
<para>
Le menu <guimenuitem>Configuration</guimenuitem> vous permet de configurer &khangman; facilement. Tout d'abord, <guimenuitem>Barres d'outils</guimenuitem> et <guimenuitem>Afficher la barre d'état</guimenuitem> autorisent ou non l'affichage des barres d'outils et de la barre d'état. 
</para>

<para>Il y a deux barres d'outils : la principale qui est celle en haut avec les boutons et les listes déroulantes, et la barre d'outils <interface>Caractères</interface> qui est celle en bas lorsqu'elle est affichée. Cette dernière a des boutons avec les caractères spéciaux pour chaque langue : lettres accentuées et autres caractères spéciaux. Cela permet aux utilisateurs de jouer aisément dans une autre langue sans avoir à configurer une nouvelle disposition de clavier. Cliquer sur une lettre spéciale l'affiche en tant que lettre à essayer. Presser sur &Enter; valide alors l'essai de cette lettre par le logiciel. La barre d'outils peut être cachée si vous le souhaitez. Ce choix est enregistré dans le fichier de configuration donc il sera maintenu au prochain lancement de &khangman;. 
</para>
<tip>
<para>
Il est bien entendu possible de déplacer les barres d'outils. Pour cela, placez le curseur de la souris sur la petite poignée à gauche de la barre d'outils, pressez le &BGS; et amenez la barre à la position voulue sur l'écran. Si vous faites un clic droit de la souris sur l'une des barres, un menu contextuel apparaît et vous permet de sélectionner diverses options pour la barre d'outils. 
</para>
</tip>
<para>
<guimenuitem>Configurer les raccourcis clavier...</guimenuitem> est un réglage &kde; standard qui vous permet de choisir différentes touches de raccourcis pour différentes actions. Par exemple, <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> est le raccourci standard pour <guimenuitem>Quitter</guimenuitem>.</para>

<para><guimenuitem>Configurer les barres d'outils...</guimenuitem> est également un élément de menu standard de &kde;, qui vous permet d'ajouter ou de supprimer des éléments d'une barre d'outils. Quand <guimenuitem>Mode plein écran</guimenuitem> est sélectionné, vous passez en mode plein écran, avec seulement la barre d'outils en haut et tout le reste de l'écran occupé par &khangman;. Sur la barre d'outils principale, l'icône <guiicon>Retour à la taille normale</guiicon> vous permet de revenir du plein écran à la taille de fenêtre que vous aviez précédemment.</para>

<screenshot>
<screeninfo>Le thème bleu de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase>Le thème bleu de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para> Vous voyez ici &khangman; avec le thème bleu, des images de pendu transparentes, en catalan et avec le niveau Animaux. La barre d'outils <interface>Caractères</interface> est visible ici.</para>

<para>Le niveau est choisi avec une liste déroulante parmi : facile, moyen, difficile et animaux. Le niveau Facile porte sur des objets usuels connus d'un enfant de six ou sept ans. Le niveau Moyen concerne des noms un peu plus délicats, tandis que Difficile est assez ardu. Le niveau Animaux se restreint à des noms d'animaux. </para>

<para>Tous les mots sont des noms, jamais des verbes ou des adjectifs. Le niveau choisi est ensuite affiché sur la barre d'état.</para>
<para>Seules des lettres peuvent être tapées dans le champ de saisie.</para>
</sect1>

<sect1 id="settings">
<title>Configuration possible</title>
<sect2 id="normal-settings">
<title>Configuration normale</title>

<screenshot>
<screeninfo>Configuration normale de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="normalsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase>Configuration normale de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>
Une barre d'outils est fournie pour un accès rapide à certains réglages. Vous pouvez ainsi cliquer sur un bouton pour avoir un nouveau jeu (c'est à dire un nouveau mot), pour quitter le jeu ainsi que pour avoir le mode plein écran (ce mode est fourni pur des écrans à basse résolution et pour permettre de jouer à plusieurs personnes). Ce manuel d'utilisateur va aussi s'ouvrir si vous cliquez sur l'icône du manuel de &khangman;. Le niveau et l'image de fond peuvent facilement être changés à l'aide de deux boîtes à menu déroulant dans la barre d'outils.
</para>
<para>
Dans <guimenu>Configuration</guimenu>, <guimenu>Configurer &khangman;</guimenu> vous trouverez deux onglets. Le premier concerne la configuration normale. <guimenuitem>Images transparentes</guimenuitem> vous permet d'avoir des images transparentes ou non pour le pendu. <guimenuitem>Images de pendu plus douces</guimenuitem> Vous permet d'avoir des images de pendu plus douces. Les images plus douces signifient que le bonhomme n'est pas pendu par le cou mais il tient la corde avec sa main. Ceci est plus conseillé pour de jeunes enfants. Les images transparentes et plus douces sont les réglages par défaut.
</para>

<para>Veuillez noter que les images transparentes pour le pendu ne sont pas disponibles dans le mode
Pas de fond. La transparence n'est disponible que pour une image de fond. La transparence est fixée par défaut.
</para>

<para>
Vous pouvez avoir une configuration spéciale pour certaines langues. Ces réglages ne sont pas accessibles si ils ne sont pas disponibles pour la langue dans laquelle vous jouez. Le premier réglage, Saisir les lettres accentuées, est disponible pour le portugais et portugais du Brésil, le catalan et l'espagnol. Si vous cochez la case Saisir les lettres accentuées alors vous devrez taper toutes les voyelles accentuées (telles que &atilde;). Si cette case reste non cochée, lorsque vous tapez n'importe quelle voyelle, toutes les voyelles accentuées seront aussi affichées dans le mot à découvrir.
</para>
<para>
Certaines langues ont aussi des conseils pour vous permettre de mieux deviner le mot. Le conseil est affiché par un clic droit de la souris et vous donne une courte définition du mot à deviner. Si ce réglage est activé et si vous cochez cette option, vous pouvez avec un clic droit de la souris n'importe où sur le jeu afficher le conseil pendant quatre secondes. Ce conseil devrait vous aider à deviner le mot.
</para>

<para>
Dans la section Sons, si vous cochez <guimenu>Activer les sons</guimenu> alors un son sera joué à chaque nouveau jeu et un autre son sera joué lorsque vous gagnez un jeu. 
</para>
</sect2>
<sect2 id="advanced-settings">
<title>Configuration avancée</title>

<screenshot>
<screeninfo>La configuration avancée de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="advancedsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase>La configuration avancée de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>
Si cette case est cochée, <guimenu>Mode une lettre seulement</guimenu> va afficher seulement la première occurrence d'une lettre s'il y a plusieurs fois la même lettre dans le mot. Par exemple si le mot est 'pomme' et si vous saisissez 'm', alors seulement le premier 'm' sera affiché. Vous devrez saisir 'm' à nouveau pour afficher le second 'm' et un troisième 'm' ira dans les lettres ratées. Ceci augmente la difficulté du jeu.
</para>

<para>
Si vous cochez la case <guimenu>Ne pas afficher la boîte de dialogue 'Bravo. Vous avez gagné.'</guimenu> alors cette boîte de dialogue ne sera plus affichée lorsque vous gagnez un jeu. Le mot gagnant restera alors affiché pendant quatre secondes puis un nouveau jeu va immédiatement démarrer.
</para>

</sect2>
</sect1>

</chapter>

<chapter id="commands">
<title>Référence des commandes</title>

<sect1 id="khangman-mainwindow">
<title>Menus et touches de raccourci</title>

<sect2>
<title>Le menu <guimenu>Jeu</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guimenu>Jeu</guimenu>
<guimenuitem>Nouveau</guimenuitem>
</menuchoice></term>
<listitem><para><action>Nouveau</action> jeu (&cad; nouveau mot)</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
</shortcut>
<guimenu>Jeu</guimenu>
<guimenuitem>Télécharger une nouvelle langue...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche</action> la boîte de dialogue de téléchargement de nouvelles données qui vous donne une liste des langues disponibles. </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenu>Jeu</guimenu>
<guimenuitem>Quitter</guimenuitem>
</menuchoice></term>
<listitem><para><action>Quitter</action> &khangman;</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>Le menu <guimenu>Langues</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Langues</guimenu>
<guimenuitem>Langues</guimenuitem>
</menuchoice></term>
<listitem><para><action>Choisir</action> la langue pour les mots</para></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>Le menu <guimenu>Configuration</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Barres d'outils</guimenuitem>
<guimenuitem>Principale (KHangMan)</guimenuitem>
</menuchoice></term>
<listitem><para><action>Activer</action> la barre d'outils principale</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Barres d'outils</guimenuitem>
<guimenuitem>Caractères</guimenuitem>
</menuchoice></term>
<listitem><para><action>Activer</action> la barre d'outils Caractères</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>

<guimenu>Configuration</guimenu>
<guimenuitem>Afficher la barre d'état</guimenuitem>
</menuchoice></term>
<listitem><para><action>Activer</action> la barre d'état</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Maj;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Configuration</guimenu>
<guimenuitem>Mode plein écran</guimenuitem>
</menuchoice></term>
<listitem><para><action>Activer</action> le mode plein écran
</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Configurer les raccourcis clavier...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configurer</action> les touches à utiliser pour accéder aux différentes actions</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Configurer les barres d'outils...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Configurer</action> les éléments que vous voulez mettre dans la barre d'outils
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Configurer &khangman;...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Afficher</action> la boîte de dialogue de configuration de &khangman; 
</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>Le menu <guimenu>Aide</guimenu></title>
&help.menu.documentation;
</sect2>
</sect1>
</chapter>

<chapter id="developers">
<title>Guide du développeur de &khangman;</title>

<sect1 id="changing-words">
<title>Comment ajouter au jeu des mots dans une nouvelle langue</title>

<para>Grâce à Stefan Asserhäll, il est très facile d'ajouter une nouvelle langue au jeu. La procédure décrite ici peut aussi être trouvée
dans le répertoire source de <filename class="directory">khangman</filename> dans le fichier <filename>README.languages</filename>. Merci de suivre cette procédure et de m'envoyer les fichiers compressés dans une archive tar.gz à annemarie.mahfouf@free.fr.
</para>

<para>Téléchargez la dernière version CVS de &khangman;. Les mots sont stockés dans quatre fichiers, un par niveau. Les fichiers se trouvent dans
<filename class="directory">/khangman/data/code_de_langue</filename>. Le fichier
<filename>easy.txt</filename> est pour le niveau facile, le fichier
<filename>medium.txt</filename> est pour le niveau moyen, le fichier
<filename>animals.txt</filename> est pour le niveau animaux et le fichier
<filename>hard.txt</filename> est pour le niveau difficile.</para>

<procedure>
<step><para>Saisissez les commandes suivantes dans une &konsole; pour créer le dossier et les fichiers de la nouvelle langue :</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen><userinput><command>./add_language <replaceable>code_de_langue</replaceable></command></userinput></screen>
<para>Vous devez ici remplacer <replaceable>code_de_langue</replaceable>
avec votre code de langue.</para>
</step>
<step>
<para>Éditez tous les fichiers textes indiqués dans le nouveau dossier avec un éditeur de texte et remplacez chaque mot avec un mot traduit. Il n'est guère important que le sens exact soit préservé, néanmoins essayez de conserver une longueur et un niveau de difficulté similaires.</para> 

<para>Vous pouvez simplement traduire les mots, mais vous pouvez également les adapter selon leur niveau, ainsi qu'ajouter de nouveaux mots si vous le souhaitez. Par exemple, <quote>table</quote> est en niveau facile en anglais mais dans votre langue il pourrait être dans le niveau moyen. N'hésitez pas à adapter les fichiers aux spécificités de votre langue. Le nombre de mots dans un fichier est sans importance, vous pouvez en ajouter.</para>

<para>Rappellez vous que tous les mots doivent être des noms.</para>

<para> Notez que vous devez utiliser l'encodage UTF-8 quand vous éditez les fichiers. Si votre éditeur ne le permet pas, essayez &kwrite; ou &kate;. À l'ouverture d'un fichier dans &kwrite; ou &kate;, vous pouvez sélectionner l'encodage UTF-8 dans la liste déroulante en haut de la boîte de dialogue d'ouverture de fichier.</para>

<para>Veuillez conserver les noms de fichiers anglais dans votre dossier
<replaceable>code_de_langue</replaceable>.</para>
</step>

<step>
<para>Saisissez les commandes suivantes pour installer les nouveaux fichiers de données :</para>
<screen><userinput><command>make</command></userinput>
<userinput><command>make install</command></userinput></screen>

<para>Vous pouvez avoir besoin de devenir <systemitem
class="username">l'utilisateur root</systemitem> pour exécuter <command>make
install</command>, selon la configuration de votre installation.</para>
</step>
<step>
<para>Lancez le jeu et vérifiez que votre langue a bien été ajoutée.</para>
<screen><userinput><command>khangman</command></userinput></screen>
</step>
<step><para>Veuillez ensuite compresser les fichiers et les envoyer afin que je puisse les ajouter sur le serveur de téléchargement ainsi que dans le module correspondant i18n dans cvs.</para>
</step>
</procedure>

<para>Si vous souhaitez fournir des astuces dans la nouvelle langue, vous aurez davantage de travail à fournir. Il vous faudra utiliser le format kvtml et la meilleure chose à faire est de jeter un coup d'oeil aux données françaises ou italiennes. Les balises <sgmltag class="starttag">o</sgmltag> et <sgmltag class="starttag">t</sgmltag> sont respectivement pour le mot et pour l'astuce. Essayez de faire correspondre l'astuce avec le niveau de difficulté. Le niveau <quote>Facile</quote> va de pair avec une astuce explicite tandis que le niveau <quote>Difficile</quote> requière la définition du dictionnaire. Essayez de ne pas utiliser de mots de la même famille dans l'astuce, sans quoi le mot sera trop facilement trouvé !</para>

<para>Voici un exemple de fichier kvtml :</para>
<programlisting><markup>
&lt;?xml version="1.0"?&gt; 
&lt;!DOCTYPE kvtml SYSTEM "kvoctrain.dtd"&gt; 
&lt;kvtml&gt; 
&lt;e&gt; 
&lt;o&gt;cane&lt;/o&gt; 
&lt;t&gt;&egrave; il tuo animale domestico preferito&lt;/t&gt; 
&lt;/e&gt; 
...
...
&lt;/kvtml&gt;
</markup></programlisting>


</sect1>
<sect1 id="internal">
<title>Ce qui est stocké par &khangman; et où</title>
<para>
Lorsque vous installez une nouvelle langue avec  <guimenu>Fichier </guimenu> ->  <guimenu>Télécharger une nouvelle langue ...</guimenu>, les données pour la nouvelle langue sont stockées dans<filename
class="directory">$~/.kde/share/apps/khangman/data</filename> dans le répertoire du code de la la nouevelle langue. Les noms de répertoire des langues disponibles sont écrits dans le fichier de configuration de &khangman; qui est <filename>~/.kde/share/config/khangmanrc</filename>.
</para>
<para>
Le nom du fournisseur (&cad; l'adresse du site web où télécharger de nouvelles langues) est stockée dans <filename>$KDEDIR/share/apps/khangman/khangmanrc</filename>.
</para>
<para>
Les données en anglais (défaut) et la langue de l'utilisateur provenant de son paquetage i18n (si disponible) sont stockées dans le répertoire <filename class="directory">$KDEDIR/share/apps/khangman</filename>.
</para>
<para>
Dans le fichier de configuration, stocké pour chaque utilisateur dans <filename>~/.kde/share/config/khangmanrc</filename> sont enregistrés tous les réglages du jeu comme l'image de fond, le dernier niveau joué,... ainsi que les fichiers téléchargés grâce à la boîte de dialogue de téléchargement de nouvelles langues. 
</para>
</sect1>
<sect1 id="planned-features">
<title>Fonctionnalités futures de &khangman;</title>
<para>
Une fonctionnalité future est d'essayer d;avoir de nouvelles langues pour les mots ainsi que des conseils dans toutes les langues. Vous pouvez le faire dans votre propre langue si ce n'est pas déjà fait. Merci de me contacter si vous désirez le faire, il s'agit essentiellement de traduire les mots anglais dans votre langue (voir <link linkend="changing-words">Comment ajouter au jeu des mots dans une nouvelle langue</link>).
</para>
<para>
Il est également envisageable d'utiliser d'autres fichiers kvtml comme ceux présents sur le site web KDE-Edu pour jouer à &khangman;. Par exemple, supposez que vous jouiez avec les capitales du monde, alors l'astuce vous indiquera le pays dont vous devez deviner la capitale. Ou bien encore, en jouant dans une langue qui n'est pas la vôtre, l'astuce pourrait être le mot que vous devez deviner, mais indiqué dans votre langue. 
</para>
</sect1>
</chapter>

<chapter id="faq">
<title>Questions et réponses</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para>J'ai un message d'erreur me disant que les images ne peuvent être trouvées.</para>
</question>
<answer>
<para>Le jeu est installé par défaut dans <filename class="directory">/usr/local/kde</filename> donc ajoutez <filename class="directory">/usr/local/kde/bin</filename> dans votre chemin d'exécution et réglez la variable d'environnement <envar>KDEDIR</envar
> à <filename class="directory">/usr/local/kde</filename> avant de lancer le jeu. Un moyen facile est de configurer &khangman; avec l'option <option>--prefix</option>=$<envar>KDEDIR</envar>, où $<envar>KDEDIR</envar> est le dossier d'installation de &kde;. Ce dossier peut varier, suivant votre distribution ou votre système d'exploitation.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para>&khangman; ne démarre pas correctement après que j'ai fait une mise à jour vers l'une des versions 3.3 de &kde;.</para>
</question>
<answer>
<para>
Il pourrait y avoir un problème suite aux changements dans le fichier de configuration. Veuillez retirer le fichier <filename
>khangmanrc</filename> de votre dossier <filename class="directory">$HOME/.kde/share/config</filename>.
</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title>Remerciements et licence</title>

<para>
&khangman;
</para>
<para>
Programme copyright 2001-2004 Anne-Marie Mahfouf <email>annma AT kde DOT org</email>
</para>
<para>
Collaborateurs : 
<itemizedlist>
<listitem><para>Graphismes: Renaud Blanchard
<email>kisukuma AT chez DOT com</email></para> </listitem>
<listitem><para>Sons : Ludovic Grossard
<email>ludovic.grossard AT libertysurf DOT fr</email></para> </listitem>
<listitem><para>Thème de fond bleu, icônes et code :  Primoz Anzur
<email>zerokode AT yahoo DOT com</email></para> </listitem>
<listitem><para>Fichiers de données suédois, aide au codage, images transparentes et corrections dans l'internationalisation : Stefan Asserhäll
<email>stefan DOT asserhall AT telia DOT com
</email></para> </listitem>
<listitem><para>Thème nature : Joe Bolin
<email>jbolin AT users DOT sourceforge DOT net</email></para> </listitem>
<listitem><para>Images de pendu plus douces : Matt Howe
<email>mdhowe AT bigfoot DOT com</email></para> </listitem>
<listitem><para>Fichiers de données espagnols : eXParTaKus
<email>expartakus AT expartakus DOT com
</email></para> </listitem>
<listitem><para>Fichiers de données danois : Erik Kjaer Pedersen
<email>erik AT mpim-bonn DOT mpg DOT de
</email></para> </listitem>
<listitem><para>Fichiers de données finnois : Niko Lewman
<email>niko DOT lewman AT edu DOT hel DOT fi
</email></para> </listitem>
<listitem><para>Fichiers de données portugais (Brésil) : João Sebastião de Oliveira Bueno
<email>gwidion AT mpc DOT com DOT br
</email></para> </listitem>
<listitem><para>Fichiers de données catalans : Antoni Bella
<email>bella5 AT teleline DOT es
</email></para> </listitem>
<listitem><para>Fichiers de données italiens : Giovanni Venturi
<email>jumpyj AT tiscali DOT it
</email></para> </listitem>
<listitem><para>Fichiers de données hollandais : Rinse
<email>rinse AT kde DOT nl
</email></para> </listitem>
<listitem><para>Fichiers de données portugais : Pedro Morais
<email>morais AT kde DOT org
</email></para> </listitem>
<listitem><para>Fichiers de données serbes (cyrillique et latin) : Chusslove Illich
<email>chaslav AT sezampro DOT yu
</email></para> </listitem>
<listitem><para>Fichiers de données slovènes : Jure Repinc
<email>jlp AT holodeck1 DOT com
</email></para> </listitem>
<listitem><para>Fichiers de données tchèques : Luk&aacute;&scaron; Tinkl
<email>lukas AT kde DOT org
</email></para> </listitem>
<listitem><para>Fichiers de données tadjik : Roger Kovacs
<email>rkovacs AT khujand DOT org
</email></para> </listitem>
<listitem><para>Fichiers de données norvégiens (Bokm&#229;l) : Torger &#197;ge Sinnes
<email>torg-a-s AT online DOT no
</email></para> </listitem>
<listitem><para>Fichiers de données hongrois : Tamas Szanto
<email>tszanto@mol.hu
</email></para> </listitem>
<listitem><para>Aide au codage : Robert Gogolok
<email>robertgogolok AT gmx DOT de</email></para> </listitem>
<listitem><para>Aide au codage : Benjamin Meyer
<email>ben AT meyerhome DOT net</email></para> </listitem>
<listitem><para>Corrections du code : Lubos Lun&agrave;k
<email>l.lunak AT kde DOT org</email></para> </listitem>
<listitem><para>Corrections du code : Albert Astals Cid
<email>tsdgeos AT terra DOT es</email></para> </listitem>
</itemizedlist>
</para>

<para>
Documentation copyright 2001-2004 Anne-Marie Mahfouf <email>annma AT kde DOT org</email>
</para>
<para>
Traduction française par &LudovicGrossard; et &AnneMarieMahfouf;.
</para>
&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->

</chapter>

<appendix id="installation">
<title>Installation</title>

<sect1 id="getting-khangman">
<title>Comment obtenir  &khangman;</title>

&install.intro.documentation;

</sect1>

<sect1 id="compilation">
<title>Compilation et installation</title>

&install.compile.documentation;

</sect1>
</appendix>

&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:
-->
