<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kapman;">
  <!ENTITY package "kdegames">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>Le manuel de &kapman;</title>

<authorgroup>
<author
><personname
> <firstname
>Thomas</firstname
> <surname
>Gallinari</surname
> </personname
> <email
>tg8187@yahoo.fr</email
> </author>
&traducteurQuentinHarbulot; &relecteurLudovicGrossard; 
</authorgroup>

<copyright>
<year
>2008</year>
<holder
>Thomas Gallinari</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2008-09-30</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&kapman; est un clone du célèbre jeu <application
>Pac-Man</application
>.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>Kapman</keyword>
<keyword
>arcade</keyword>
<keyword
>un joueur</keyword>
<keyword
>pac-man</keyword>
<keyword
>pacman</keyword>
<keyword
>fantôme</keyword>
<keyword
>bille</keyword>
<keyword
>boule d'énergie</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduction</title>
<note
><title
>Type de jeu : </title
><para
>Arcade</para
></note>
<note
><title
>Nombre de joueurs posible : </title
><para
>Un</para
></note>
<para
>&kapman; est un clone du célèbre jeu <application
>Pac-Man</application
>.Vous devez échapper aux fantômes dans un labyrinthe pour passer de niveau en niveau. Vous perdez une vie quand un fantôme vous mange, mais vous pouvez aussi faire de même pendant quelques secondes après avoir mangé une boule d'énergie. Vous gagnez des points lorsque vous mangez des billes, boules d'énergie, bonus, et vous gagnez une vie supplémentaire tous les 10000 points gagnés. Lorsque vous aurez mangé toutes les billes et boules d'énergie d'un niveau, vous passez au niveau suivant, et la vitesse du joueur et des fantômes augmente. Le jeu se termine lorsque vous avez perdu toutes vos vies. </para>
<screenshot>
<screeninfo
>Une capture d'écran de &kapman;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kapman.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Une capture d'écran de &kapman;</phrase>
</textobject>
</mediaobject>
</screenshot>
</chapter>

<chapter id="howto">
<title
>Comment jouer</title>
<note
><title
>Objectif : </title
><para
>Passer de niveau en niveau en mangeant toutes les billes et boules d'énergie.</para
></note>
<para
>&kapman; charge le premier niveau lorsque vous lancez le jeu. Pour démarrer la partie, appuyez sur une touche fléchée. Vous vous déplacez automatiquement vers l'avant sans appuyer sur aucune touche. Pour tourner, appuyez sur une touche fléchée. Vous ne devriez pas tourner au dernier moment, mais plutôt anticiper ce qui vous permettra de tourner le plus tôt possible. Pour manger une bille, une boule d'énergie, un bonus, ou même un fantôme, vous devez toucher l'objet désiré. Quand toutes les billes et boules d'énergie ont été mangées, vous passez au niveau suivant. </para>
</chapter>

<chapter id="rules_and_tips"
><title
>Règles, Stratégies et Astuces</title>
<sect1 id="rules">
<title
>Règles</title>
<para>
<itemizedlist>
<listitem
><para
>Pour arriver au niveau suivant, vous devez manger toutes les billes et boules d'énergie du labyrinthe.</para
></listitem>
<listitem
><para
>Un bonus apparaît lorsque vous avez mangé 1/3 et 2/3 des billes et boules d'énergie. Il disparaît après quelques secondes (10 secondes au premier niveau, mais ce temps diminue au fur et à mesure des niveaux) si vous ne l'avez pas mangé.</para
></listitem>
<listitem
><para
>Au fur et à mesure des niveaux, votre vitesse et celle des fantômes augmentent. Cependant, les fantômes seront plus et plus rapides que vous.</para
></listitem>
<listitem
><para
>Si vous touchez un fantôme, vous perdez une vie, et le niveau actuel recommence (les billes et énergies déjà mangées ne réapparaissent pas)</para
></listitem>
<listitem
><para
>SI vous êtes dans la ligne de mire d'un fantôme (c'est-à-dire qu'il n'y a aucun mur entre lui et vous et que vous allez tous les deux dans la même direction), le fantôme vous poursuivra. Autrement, les fantômes ont des déplacements aléatoires.</para
></listitem>
<listitem
><para
>Lorsque vous mangez une boule d'énergie, les fantômes vont moins vite et vous pouvez les manger. Si vous mangez un fantôme, il retourne chez lui et retrouve son comportement habituel. Après quelques secondes (10 secondes pour le premier niveau, mais ce temps diminue au fur et à mesure que vous progressez), les fantômes qui n'ont pas été mangés reprennent leurs comportements normaux.</para
></listitem>
<listitem
><para
>Vous gagnez des points lorsque vous mangez un objet : </para>
<table>
<title
>Valeur de l'objet</title>
<tgroup cols="2">
<tbody>
<row>
<entry
>Bille</entry>
<entry
>10 points</entry>
</row>
<row>
<entry
>Boule d'énergie</entry>
<entry
>20 points</entry>
</row>
<row>
<entry
>Bonus</entry>
<entry
>Niveau actuel * 100 points</entry>
</row>
<row>
<entry
>Fantôme</entry>
<entry
>Cela dépend du nombre de fantômes que vous avez mangez depuis que la dernière boule d'énergie a été mangée :  <itemizedlist>
<listitem
><para
>1er fantôme : 100 points</para
></listitem>
<listitem
><para
>2ème fantôme : 200 points</para
></listitem>
<listitem
><para
>3ème fantôme : 400 points</para
></listitem>
<listitem
><para
>4ème fantôme : 800 points</para
></listitem>
</itemizedlist>
</entry>
</row>
</tbody>
</tgroup>
</table>
</listitem>
<listitem
><para
>Vous obtenez une vie supplémentaire tous les 10 000 points gagnés.</para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="tips">
<title
>Stratégies et Astuces</title>
<para>
<itemizedlist>
<listitem
><para
>Pour manger un objet, vous devez toucher son centre, pas seulement quelques pixels. Soyez donc sûrs que vous avez réellement mangé ce que vous vouliez avant de faire demi-tour ;</para
></listitem>
<listitem
><para
>Dans les premiers niveaux, les bonus ne donnent pas beaucoup de points et les fantômes ne vont pas très vite, vous devriez donc vous concentrer pour manger le plus de fantômes possible ;</para
></listitem>
<listitem
><para
>Après environ dix niveaux, les fantômes vont plus vite et les bonus donnent plus de points, vous devriez donc essayer de manger le plus de bonus possible. N'hésitez pas à manger une boule d'énergie quand vous apercevez un bonus, pour ne pas être dérangé par les fantômes ;</para
></listitem>
<listitem
><para
>De la même manière, vous devriez essayer de manger une boule d'énergie avant d'aller dans des endroits dangereux (par exemple près du repère des fantômes) ;</para
></listitem>
<listitem
><para
>Quand les fantômes sont trop rapides, vous devriez éviter de les manger près de leur repère. Ils pourraient revenir plus vite que vous le pensez ;</para
></listitem>
<listitem
><para
>N'hésitez pas à rester au même endroit pendant un instant, en attendant que les fantômes libèrent l'endroit où vous voulez aller ;</para
></listitem>
<listitem
><para
>Vous pouvez trouver des codes de triche dans le code source du jeu. Mais attention : si vous réalisez un nouveau score en ayant triché, votre score ne sera pas sauvé ;</para
></listitem>
<listitem
><para
>Et enfin : bon jeu ! </para
></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="interface"
><title
>Aperçu de l'interface</title>
<sect1 id="menubar">
<title
>Barre de menus</title>
<sect2>
<title
>Le menu <guimenu
>Jeu</guimenu
></title>
<para>
<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
>Démarre une nouvelle partie.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Jeu</guimenu
><guimenuitem
>Afficher les meilleurs scores</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Afficher la fenêtre des meilleurs scores.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Jeu</guimenu
><guimenuitem
>Changer de niveau</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Afficher la fenêtre de sélection de niveau. Attention : en changeant de niveau, vous serez considéré par le jeu comme un tricheur, vous ne serez donc pas en mesure d'éditer la table des meilleurs scores.</action
></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
> &kapman;.</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Le menu de <guimenu
>Configuration</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Activer les sons</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activer les sons ou non.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Afficher la barre d'état</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche ou cache la barre d'état.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Difficulté</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Ajuste la difficulté de la partie.</action
></para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Difficulté</guisubmenu
><guimenuitem
>Facile</guimenuitem
> </menuchoice
></term>
<listitem
><para
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Difficulté</guisubmenu
><guimenuitem
>Moyen</guimenuitem
> </menuchoice
></term>
<listitem
><para
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Difficulté</guisubmenu
><guimenuitem
>Difficile</guimenuitem
> </menuchoice
></term>
<listitem
><para
></para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer les raccourcis clavier...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche l'utilitaire de configuration des raccourcis.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer les barres d'outils...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche l'utilitaire de configuration des barres d'outils.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer Kapman...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Affiche l'utilitaire de configuration de &kapman;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Le Menu d'<guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
<sect1 id="keybindings">
<title
>Touches par défaut</title>
<para>
<itemizedlist>
<listitem
><para
><action
>Monter</action
> - <keysym
>Flèche vers le haut</keysym
></para
></listitem>
<listitem
><para
><action
>Descendre</action
> - <keysym
>Flèche vers le bas</keysym
></para
></listitem>
<listitem
><para
><action
>Tourner à droite</action
> - <keysym
>Flèche vers la droite</keysym
></para
></listitem>
<listitem
><para
><action
>Tourner à gauche</action
> - <keysym
>Flèche vers la gauche</keysym
></para
></listitem>
<listitem
><para
><action
>Pause</action
> - <keycap
>P</keycap
> ou <keycap
>Échap</keycap
></para
></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Questions et Réponses</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Je veux changer l'apparence de ce jeu. Est-ce possible ?</para>
</question>
<answer>
<para
>Vous pouvez sélectionner le thème de &kapman; dans la fenêtre <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer Kapman...</guimenuitem
></menuchoice
>. Reportez-vous au chapitre <link linkend="configuration"
>Configuration du jeu</link
> pour plus de détails.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Puis-je sauter des niveaux ?</para>
</question>
<answer>
<para
>Il y a deux façons de changer de niveau. Dans les deux cas, vous serez considéré comme un tricheur et ne serez pas en mesure d'éditer la liste des meilleurs scores. La première façon est d'utiliser un code de triche. Je vous laisse le soin de le trouver. L'autre astuce est de sélectionner le niveau que vous voulez charger dans la fenêtre <menuchoice
><guimenu
>Jeu</guimenu
><guimenuitem
>Changer de niveau</guimenuitem
></menuchoice
>. Reportez-vous à la section <link linkend="menubar"
>Barre de menus</link
> pour plus de détails.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Puis-je changer les raccourcis claviers par défaut ?</para>
</question>
<answer>
<para
>C'est impossible pour l'instant. Mais il sera possible de le faire dans la prochaine version de &kapman;. Reportez-vous à la section <link linkend="keybindings"
>Raccourcis Clavier Par Défaut</link
> pour plus de détails.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Je dois quitter le jeu maintenant, mais je n'ai pas terminé. Puis-je sauver ma progression ?</para>
</question>
<answer>
<para
>Vous ne pouvez pas, cela est justement fait exprès. Nous pensons que le jeu serait trop simple si vous pouviez enregistrer le jeu et le relancer à chaque fois que vous perdez des vies.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Comment obtenir plus de vies ?</para>
</question>
<answer>
<para
>Il y a deux façons d'obtenir des vies supplémentaires. La première est en utilisant un code de triche. Je vous laisse le soin de le trouver. L'autre est en gagnant des points. Tous les 10 000 points, vous gagnez une vie supplémentaire. Reportez vous à la section <link linkend="rules"
>Règles</link
> pour plus de détails.</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="configuration"
><title
>Configuration du jeu</title>
<para
>Vous pouvez sélectionner le thème avec lequel vous voulez jouer à &kapman;. Pour cela, sélectionnez <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
> Configurer Kapman...</guimenuitem
></menuchoice
>. La boîte de dialogue de configuration de &kapman; (voir plus bas) apparaît alors et vous pouvez choisir le thème. Celui-ci est immédiatement changé dès lors que vous aurez validé votre choix, il n'est pas nécessaire de relancer le jeu. Vous pouvez cliquer sur le bouton <guibutton
>Réglages par défaut</guibutton
> pour restaurer le thème par défaut. </para>
<screenshot>
<screeninfo
>La fenêtre de configuration de &kapman;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="config.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>La fenêtre de configuration de &kapman;</phrase>
</textobject>
</mediaobject>
</screenshot>
</chapter>

<chapter id="credits"
><title
>Remerciements et licence</title>
<para
>&kapman; </para>
<para
>Programme copyright 2008 Thomas Gallinari <email
>tg8187@yahoo.fr</email
> </para>
<para
>Programme copyright 2008 Pierre-Benoit Besse <email
>besse.pb@gmail.com</email
> </para>
<para
>Programme copyright 2008 Alexandre Galinier <email
>blluetroy@hotmail.com</email
> </para>
<para
>Programme copyright 2008 Nathalie Liesse <email
>nathalie.liesse@gmail.com</email
> </para>
<para
>Graphiques copyright 2008 Thomas Gallinari <email
>tg8187@yahoo.fr</email
> </para>
<para
>Documentation copyright 2008 Thomas Gallinari <email
>tg8187@yahoo.fr</email
> </para>
<para
>Traduction française par &QuentinHarbulot;. Relecture par &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>

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

&install.intro.documentation;

<sect1 id="Compilation">
<title
>Compilation et Installation</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;

</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->