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

<book lang="&language;">

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

<authorgroup>
<author
><firstname
>Nicolas</firstname
> <surname
>Hadacek</surname
> <affiliation
> <address
><email
>hadacek@kde.org</email
></address>
</affiliation>
</author>
<author
><firstname
>Michael</firstname
> <surname
>McBride</surname
> <affiliation
><address
><email
>mmcbride@ematic.org</email
></address
></affiliation>
</author>
<othercredit role="developer"
><firstname
>Nicolas</firstname
> <surname
>Hadacek</surname
> <affiliation
> <address
><email
>hadacek@kde.org</email
></address>
</affiliation>
<contrib
>Développeur</contrib>
</othercredit>
<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Relecteur</contrib>
</othercredit>
&traducteurAnneMarieMahfouf; &traducteurYvesDessertine; &traducteurGerardDelafond; 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Nicolas Hadacek, Michael McBride</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2004-01-12</date>
<releaseinfo
>2.1.8</releaseinfo>

<abstract
><para
>&kmines; est la version pour &kde; du classique jeu de détection de mines.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>jeu</keyword>
<keyword
>démineur</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmines; is the classic Minesweeper game. You must uncover all the empty squares without blowing up a mine.</para>

<para
>When you uncover a square, a number appears: it indicates how many mines surround this square. If there is no number the neighboring squares are automatically uncovered. When you find a square that you are sure contains a mine, it is <emphasis
>very</emphasis
> useful to put a flag on it (by right-clicking).</para>

</chapter>

<chapter id="how-to-play">
<title
>Comment jouer</title>

<para
>You have to use the mouse and its three buttons to uncover or to flag the squares (with two-buttoned mice, clicking the <mousebutton
>middle</mousebutton
> button is generally achieved by simultaneously pressing the <mousebutton
>left</mousebutton
> and the <mousebutton
>right</mousebutton
> buttons). Here are the details:</para>

<itemizedlist>
<listitem
><para
>The <mousebutton
>left</mousebutton
> button will uncover a square. If there is a bomb below that square, the bomb will explode, and the game will be over.</para>
<para
>If there is not a bomb under the square, a number will appear. That is the number of neighboring squares that contain bombs. <quote
>Which ones?</quote
> you ask: That's the point of the game.</para>
<para
>For each square (excluding edge and corner squares), there are 8 neighboring squares.</para>
<para
>If none of the neighboring squares has a bomb, then a blank will be shown under the square, and all neighboring squares will be automatically uncovered.</para>
<note
><para
><mousebutton
>Left</mousebutton
> clicking a flagged square is safe and does nothing.</para
></note
></listitem>
<listitem
><para
>The <mousebutton
>right</mousebutton
> button will mark a square as containing a mine (by drawing a red flag on it) or, if the option is set, as being uncertain (by drawing a question mark on it). The uncertain tag can be useful when you are puzzled about the positions of mines.</para
></listitem>
<listitem
><para
>The <mousebutton
>middle</mousebutton
> button will clear the surrounding squares if the right number of squares is already flagged. It is very useful since it is much quicker than uncovering all individual squares.</para>
<warning
><para
>If your flags are not properly positioned, you will explode a bomb.</para
></warning
></listitem>
<listitem
><para
>Cliquer sur l'icône jaune représentant <guiicon
>une figure souriante</guiicon
> démarrera un nouveau jeu.</para
></listitem>
</itemizedlist>

<note
><para
>Ce sont les paramètres par défaut. Les boutons de la souris peuvent être reprogrammés. Pour plus d'informations, voir la section intitulée <link linkend="prefs"
>Options du jeu</link
>.</para
></note>

<sect1 id="screen"
><title
>L'interface de &kmines;</title>

<screenshot>
<screeninfo
>L'interface de &kmines;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="kmines1.png"
	     format="PNG"/></imageobject>
<textobject
><phrase
>L'interface de &kmines;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>L'interface de &kmines; est constituée par :</para>

<itemizedlist>
<listitem
><para
>Une zone vous montrant le nombre de mines restantes non marquées. Chaque fois que vous mettez un drapeau sur une case avec une bombe, ce nombre décroît de un.</para>
<note
><para
>Cette zone ne détermine pas si vous avez raison ou tort mais seulement combien de mines vous devez théoriquement marquer avant d'avoir fini ce jeu.</para
></note>
<para
>Dans cet exemple, il reste 10 mines à marquer.</para
></listitem>
<listitem
><para
>Une figure souriante jaune. Cliquer dessus va démarrer une nouvelle partie. Si vous perdez la partie, elle se changera en figure mécontente.</para
></listitem>
<listitem
><para
>The box on the right shows how much time this round has taken. The shortest time for each level is listed as the high score.</para
></listitem>
<listitem
><para
>The playing area. This will vary in size depending on the difficulty level of the game. In this example, it consists of 64 squares. This is where you play the game.</para
></listitem>
<!-- This doesn't seem to be there any more.
<listitem
><para
>A status line at the bottom of the window.  In this example, it
simply says <guilabel
>Game stopped</guilabel
>.</para
></listitem>
-->
</itemizedlist>
</sect1>
</chapter>

<chapter id="prefs"
><title
>Options du jeu</title>
<para
>Les options de &kmines; sont fixées en sélectionnant <menuchoice
> <guimenu
>Configuration</guimenu
><guimenuitem
>Configurer &kmines;</guimenuitem
> </menuchoice
> dans la barre de menus. Cela va faire apparaître une boîte de dialogue.</para>

<screenshot>
<screeninfo
>Préférences de &kmines;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="kmines2.png" format="PNG"/></imageobject>
<textobject
><phrase
>Préférences de &kmines;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Cette boîte de dialogue est divisée en trois onglets.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Jeu</guilabel
></term>
<listitem>
<para
>The first option, labeled <guilabel
>Enable ? Mark</guilabel
>, determines whether you can mark squares as <quote
>questionable</quote
>. If this option is checked, then right clicking the mouse will first cause a square to be flagged. If you right click again on the same square, the flag will change to a <guiicon
>?</guiicon
>, to indicate you don't know if there is a bomb there or not. If you click again, the square will change back to blank.</para>

<para
>If there is not a mark in front of this option, the first <mousebutton
>right</mousebutton
> mouse click will change the square to a red flag. The second will make it blank again, thus skipping the <guiicon
>?</guiicon
> symbol.</para>

<para
>The next option down, labeled <guilabel
>Enable keyboard</guilabel
>, determines if the keyboard shortcuts will work while playing the game. The default keyboard shortcuts are given in <xref linkend="keys"/>, and can be changed by selecting <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
>.</para>

<note
><para
>The only keyboard shortcuts affected are those responsible for playing the game. Keyboard commands such as <guimenuitem
>New Game</guimenuitem
> and <guimenuitem
>Quit</guimenuitem
>, still work, regardless of this option.</para
></note>

<para
>The <guilabel
>Pause if windows lose focus</guilabel
> option will automatically pause the game if the &kmines; window loses focus. When the game is paused, the gameboard disappears, so you can't use pausing the game as a way to cheat!</para>

<para
>The <guilabel
>"Magic" reveal</guilabel
> option switches on <quote
>Magic reveal</quote
> mode. In this mode, &kmines; does most of the gameplay for you: If you have uncovered enough squares to be able to tell with certainty that a square contains a mine, &kmines; will automatically mark it as a mine, and perform an autoreveal on squares for which it has marked the correct number of mines. Note that when you have this mode switched on, your scores do not count as highscores.</para>


<para
>The last section of this tab allows you to change the action of each of the three mouse buttons. Your options are:</para>

<variablelist>
<varlistentry>
<term
>Révéler</term>
<listitem
><para
>This will reveal the contents of the square. If there is no bomb, then a number will appear. If there is a bomb under that square, then the bomb will explode, and the game will be over.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Changer la marque</term>
<listitem
><para
>Clicking with this button on a square will mark/unmark with a red flag.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Révéler automatiquement</term>
<listitem
><para
>Clicking on a square with this button will automatically reveal all neighboring squares that are not marked with red flags. If one of those neighboring squares has a bomb under it, the bomb will explode, and the game will be over.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Inverser le drapeau</term>
<listitem
><para
>Clicking with this button on a square will cycle through blank, red flag, and question mark.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Inverser la marque « ? »</term>
<listitem
><para
>Clicking with this button on a square will mark/unmark with a question mark.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Apparence</guilabel
></term>
<listitem>
<para
>The top option, entitled <guilabel
>case size</guilabel
>, determines the size of each of the squares in the playing area. By default, they are set small. You may want to increase the size if you are working on a very high resolution monitor.</para>

<para
>Le reste de cette page concerne les couleurs. Pour les ajuster, il suffit de cliquer sur le bouton de choix de la couleur en face d'une des descriptions, et de choisir la nouvelle couleur.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Partie personnalisée</guilabel
></term>
<listitem>
<para
>Pour finir, si vous ne trouvez pas les parties proposées suffisamment attractives, vous pouvez définir une partie personnalisée ici. Utilisez les glissières pour changer la <guilabel
>largeur</guilabel
>, la <guilabel
>hauteur</guilabel
> et le pourcentage du terrain de jeu infesté de <guilabel
>Mines</guilabel
>. La partie par défaut a 20 pour cent du terrain infesté, vous avez donc beaucoup de marge pour rendre le jeu plus difficile.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Enregistrer vos changements</term>
<listitem
><para
>Once your changes are complete, click <guibutton
>OK</guibutton
> to make them permanent.</para>

<para
>Si vous voulez abandonner vos modifications, cliquez sur <guibutton
>Annuler</guibutton
> pour annuler les changements.</para>

<para
>If you click on <guilabel
>Default</guilabel
>, the default settings will be restored. Click <guilabel
>OK</guilabel
> to make these default changes permanent, or edit the settings some more.</para>
</listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="command">
<title
>Raccourcis clavier pour les commandes</title>

<para
>Les chapitres suivants décrivent brièvement chaque option de la barre de menus.</para>

<sect1 id="game-menu">
<title
>Le menu <guimenu
>Jeu</guimenu
></title>

<para
>Le menu <guimenu
>Jeu</guimenu
> comporte 5 options.</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
>Débute une nouvelle partie.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>P</keycap
> </shortcut
> <guimenu
>Jeu</guimenu
><guimenuitem
>Pause</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Met le jeu en pause. Cela va cacher le tableau (pas de triche) et afficher un bouton à presser lorsque vous voulez continuer ce jeu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Jeu</guimenu
><guimenuitem
>Meilleurs scores</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cela vous montre le score le plus haut (le temps le plus court) pour chaque niveau de difficulté.</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
>Quitte</action
> &kmines;</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="move-menu"
><title
>Le menu <guimenu
>Déplacement</guimenu
></title>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>H</keycap
> </shortcut
><guimenu
>Déplacement</guimenu
><guimenuitem
>Conseil</guimenuitem
> </menuchoice
></term>
<listitem
><para
>If you use this item, you will get a hint about where you should click next. If you do that your score will not be added to the high-scores.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Résoudre</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément essaye de résoudre la partie en cours.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Calcul du taux de résolution...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément affiche une boîte de dialogue qui calcule le taux de résolution pour le type de jeu en cours.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Voir le journal</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément affiche une boîte de dialogue avec le journal de la dernière partie.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Rejouer le journal</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément rejoue la dernière partie enregistrée en journal.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Enregistrer le journal...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément affiche une boîte de dialogue pour enregistrer le journal actuel.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Déplacement</guimenu
><guimenuitem
>Charger un journal...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cet élément affiche une boîte de dialogue pour charger une partie enregistrée en journal.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="settings-menu"
><title
>Le menu <guimenu
>Configuration</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Afficher la barre de menus</guimenuitem
> </menuchoice
></term>
<listitem
><para
>S'il y a un coche à côté de cette option, la barre de menus sera alors visible. Enlever la coche cachera la barre de menus.</para>
<note
><para
>Pour retrouver une barre de menus cachée, cliquez hors de la zone de jeu avec le bouton droit de la souris. Cela va ouvrir un petit sous-menu. Sélectionnez simplement <guimenuitem
>Afficher la barre de menus</guimenuitem
> dans ce sous-menu et la barre de menus sera à nouveau visible.</para
></note
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guisubmenu
>Choisir le type de partie</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Vous permet de choisir le niveau de difficulté depuis un sous-menu.</para>
<para
>There are three default levels of difficulty: <guimenuitem
>Easy</guimenuitem
> (64 squares, 10 mines), <guimenuitem
>Normal</guimenuitem
> (256 squares, 40 mines), and <guimenuitem
>Expert</guimenuitem
> (480 squares, 99 mines). There is also a <guimenuitem
>Custom...</guimenuitem
> level settings.</para>
<para
>Si vous choisissez <guimenuitem
>Personnalisé...</guimenuitem
>, les réglages que vous avez définis dans la boîte de dialogue <guimenuitem
>Configurer &kmines;</guimenuitem
> seront utilisés.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer les raccourcis-clavier...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item lets you change the keyboard shortcuts used by &kmines;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Configurer les notifications...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item displays a standard &kde; notifications configuration dialog, where you can change the notifications (sounds, visible messages, &etc;) used by &kmines;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer les meilleurs scores...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Vous pouvez changer ici votre <guilabel
>Pseudo</guilabel
> et ajouter des <guilabel
>Commentaires</guilabel
> sympathiques à votre propre sujet, afin qu'ils s'affichent dans la table des meilleurs scores. Vous pouvez également cocher la case <guilabel
>Utiliser les meilleurs scores mondiaux</guilabel
>, afin de montrer votre talent pour &kmines; à toute la planète à l'aide d'un serveur de scores en ligne.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuration</guimenu
> <guimenuitem
>Configurer &kmines;</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Vous permet d'ajuster les options du jeu. Pour des informations plus détaillées, voyez le chapitre intitulé <link linkend="prefs"
>Options du jeu</link
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="help-menu">
<title
>Le menu <guimenu
>Aide</guimenu
></title>
&help.menu.documentation; </sect1>

<sect1 id="keys"
><title
>Default Keyboard Shortcuts</title>
<para
>The following table shows you the default keyboard shortcuts.</para>


<table>
<title
>Keyboard Shortcuts</title>
<tgroup cols="2">
<thead
><row
><entry
>Combinaison de touches</entry
><entry
>Action</entry
></row
></thead>
<tbody>
<row
><entry
><keycap
>Flèches</keycap
></entry
><entry
>Déplace le curseur sur la surface de jeu.</entry
></row>
<row
><entry
><keycap
>PageDown</keycap
></entry
><entry
>Move to bottom edge</entry
></row>
<row
><entry
><keycap
>PageUp</keycap
></entry
><entry
>Move to top edge</entry
></row>
<row
><entry
><keycap
>Home</keycap
></entry
><entry
>Move to left edge</entry
></row>
<row
><entry
><keycap
>End</keycap
></entry
><entry
>Move to right edge</entry
></row>
<row
><entry
><keycap
>Barre espace</keycap
></entry
><entry
>Reveal square.</entry
></row>
<row
><entry
><keycap
>W</keycap
></entry
><entry
>Mark square as mine</entry
></row>
<row
><entry
><keycap
>Retour</keycap
></entry
><entry
>Automatically reveal all surrounding squares not marked by a flag.</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></entry
><entry
>Nouvelle partie</entry
></row>
<row
><entry
><keycap
>P</keycap
></entry
><entry
>Met le jeu en pause</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
><entry
>Quitte &kmines;</entry
></row>
<row
><entry
><keycombo action="simul"
>&Maj;<keycap
>F1</keycap
></keycombo
></entry
><entry
>What's This Help</entry
></row>

</tbody>
</tgroup>
</table>

<para
>Ces raccourcis clavier peuvent être changés en sélectionnant <menuchoice
><guimenu
>Configuration</guimenu
><guimenuitem
>Raccourcis clavier...</guimenuitem
> </menuchoice
> dans la barre de menus.</para>

</sect1>

</chapter>

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

<para
>&kmines; </para>
<para
>Program copyright 1996-2000 &Nicolas.Hadacek; &Nicolas.Hadacek.mail;</para>
<para
>Documentation copyright 2000 &Nicolas.Hadacek; &Nicolas.Hadacek.mail;</para>
<para
>Documentation updated for &kde; 2.0 by &Mike.McBride; &Mike.McBride.mail;</para>
<para
>Some changes for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;</para>
<para
>Traduction française par &AnneMarieMahfouf; &YvesDessertine; et &GerardDelafond;.</para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kmines">
<title
>Comment obtenir &kmines;</title>
&install.intro.documentation; </sect1>

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


</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->


