<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&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>
</authorgroup>


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

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2003-10-15</date>
<releaseinfo
>1.3</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
>hangman</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, Facile, Moyen et Difficile. Un mot dont les lettres sont cachées est sélectionné de façon aléatoire, et 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>
<para
>Mon fils Joachim, alors âgé de 9 ans et demi, m'a donné l'idée de ce jeu en juin 2000. </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 Facile, 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.</para>

<important
><para
>Tous les mots sont des noms (pas de verbes, pas 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. </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 dur 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>

<para
>You can play &khangman; in thirteen languages: Brazilian Portuguese, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Italian, Portuguese, Spanish and Swedish. You can easily change the Language by going in the <guimenu
>Languages</guimenu
> menu and choosing another language. </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
>Please note that for Czech special characters you will need a font that supports these characters so you can see them displayed. Choosing Arial in KDE Control Center as a general font and adjusting all fonts will work fine. </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 deux éléments : <guimenuitem
>Nouveau</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
>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
>The <guimenu
>Languages</guimenu
> menu has thirteen menu items: <guimenuitem
>Brazilian Portuguese</guimenuitem
>, <guimenuitem
>Catalan</guimenuitem
>, <guimenuitem
>Czech</guimenuitem
>, <guimenuitem
>Danish</guimenuitem
>, <guimenuitem
>Dutch</guimenuitem
>, <guimenuitem
>English</guimenuitem
>, <guimenuitem
>Finnish</guimenuitem
>, <guimenuitem
>French</guimenuitem
>, <guimenuitem
>German</guimenuitem
>, <guimenuitem
>Italian</guimenuitem
>, <guimenuitem
>Portuguese</guimenuitem
>, <guimenuitem
>Spanish</guimenuitem
> and <guimenuitem
>Swedish</guimenuitem
>. As default, if your &kde; language is one of those thirteen, then it is set as default otherwise English is chosen. After your first game, the language you set up the last time you used &khangman; is restored. </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>

<para
><guimenuitem
>Images transparentes</guimenuitem
> vous permet de choisir entre des images de pendu transparentes ou non, selon qu'il est sélectionné ou pas.</para>

<para
><guimenuitem
>Images de pendu plus douces</guimenuitem
> vous permet d'activer une version douce de la dernière des images de pendu. Cela veut dire que l'homme n'est pas pendu mais tient la corde dans sa main, ce qui convient davantage à de jeunes enfants.</para>

<para
><guimenuitem
>Taper les lettres accentuées</guimenuitem
> est un mode disponible seulement en catalan, espagnol et portugais (Brésil). S'il est sélectionné, l'utilisateur doit saisir les lettres accentuées comme &atilde; pour les voir s'afficher dans le mot. Dans le cas contraire, une voyelle usuelle révélera toutes celles accentuées, par exemple essayer <quote
>a</quote
> révélera &atilde; et les autres a accentués présents dans le mot.</para>

<para
><guimenuitem
>Activer les conseils</guimenuitem
> est disponible seulement en français et en italien. Si vous sélectionnez cette option pour l'une de ces langues, vous pouvez faire un clic droit n'importe où dans la fenêtre de jeu pour obtenir l'affichage d'une astuce pendant quatre secondes. Cette astuce devrait vous aider à deviner le mot.</para>

<para
>Notez que les images transparentes pour le pendu ne sont pas activées en l'absence d'un thème de fond. La transparence n'est disponible qu'avec une image de fond, et est activée par défaut.</para>

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

<para
>Vous avez ici &khangman; avec le thème de fond bleu, des images transparentes du pendu, en catalan et en niveau Facile. 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>
</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
>Nouvelle</action
> partie (&cad; nouveau mot)</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
>Afficher Barre principale</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
>Afficher 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;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Configuration</guimenu
> <guimenuitem
>Images transparentes</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activer</action
> la transparence pour les images du pendu </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Configuration</guimenu
> <guimenuitem
>Images de pendu plus douces</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activer</action
> les images de pendu plus douces </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Configuration</guimenu
> <guimenuitem
>Taper les lettres accentuées</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Autoriser l'entrée explicite des lettres accentuées (en catalan, espagnol, portugais et portugais du Brésil) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Configuration</guimenu
> <guimenuitem
>Activer les conseils</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Autoriser l'affichage d'une astuce lors d'un clic droit (seulement en français et en italien). </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>

</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
>Thanks to Stefan Asserhäll, it is very easy to add a new language directly to the game. The procedure described here can also be found in the <filename class="directory"
>khangman</filename
> source folder in the file <filename
>README.languages</filename
>. However, as there are already thirteen languages, it will be difficult to add others as the menu will be too long. So please follow the procedure below but instead of committing your files you send them to me tarred and gzipped. That way I'll make your language available on the &khangman; web page. Next &khangman; release (with &kde; 3.3) will have a wizard to easily download and install new languages. </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_code</filename
>. Les fichiers <filename
>easy.txt</filename
>, <filename
>medium.txt</filename
>, <filename
>animals.txt</filename
> et <filename
>hard.txt</filename
> correspondent aux quatre niveaux standard.</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 par 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
>Rappelez-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
>Validez sur le serveur CVS les nouveaux fichiers de langue avec la commande suivante :</para>
<screen
><userinput
><command
>cvs commit -m "Added new language <replaceable
>nom_de_votre_langue</replaceable
>"</command
></userinput
></screen>
</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
> requiert 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="planned-features">
<title
>Fonctionnalités futures de &khangman;</title>

<para
>Le nombre de langues pour les fichiers de données allant croissant, il sera nécessaire de cesser de les intégrer au logiciel. Nous prévoyons de ne fournir &khangman; qu'avec quelques langues comme l'allemand, l'anglais, l'espagnol et le français, tandis que les autres langues seront disponibles dans le module d'internationalisation et par téléchargement. &khangman; fera appel à la classe <classname
>KNewStuff</classname
> afin de disposer d'un assistant permettant à l'utilisateur de télécharger et d'installer facilement des langues additionnelles. Cela sera également fait pour &klettres; et &kstars; car nous ne souhaitons pas augmenter la taille du module &package;. </para>
<para
>Bien entendu, une autre fonctionnalité future est de disposer d'astuces dans chaque langue. </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.2 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-2003 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
>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-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
&underFDL; &underGPL; </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:
-->
