<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>
<title>Manuel de KAbalone</title>
<authorgroup>
<author>
<firstname>Josef</firstname>
<surname>Weidendorfer</surname>
</author>
</authorgroup>
<date>Version 1.04, 9 September 1999</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<abstract>
<para>Cette documentation a été mise à jour pour la version 1.04 de KAbalone. Pour tous commentaires ou ajouts, contactez l'auteur.</para>
<para>KDE Abalone</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>jeu</keyword>
<keyword>KAbalone</keyword>
<keyword>Linux</keyword>
</keywordset>
</bookinfo>
<chapter id="Introduction">
<title>Introduction</title>
<para>KAbalone est un simple jeu de stratégie qui se joue à deux. Chaque joueur à une couleur, soit rouge, soit jaune. Chaque joueur commence avec 14 pions. Le but du jeu est de déplacer ses pions de manière à faire sortir les pions de l'adversaire hors du plateau.
</para>
<para>Le programme original à été développé pour DOS et XLib pure en 1993. Le portage sous KDE a nécéssité des modifications majeures.</para>
<para></para>
<para><emphasis remap="bf">Remarque</emphasis>: L'idée de ce jeux n'est pas de moi. C'est un vrai jeux commercial, produit, je crois, par une société allemande.</para>
</chapter>
<chapter id="Reglesdujeu.">
<title>Règles du jeu.</title>
<para>Les rouges jouent toujours en premiers.</para>
<para>Deux types de déplacements sont autorisés:
<itemizedlist>
<listitem>
<para>Normal.
Un, deux ou trois pions alignés de votre couleur peuvent être déplaçés dans l'une des six directions.
Les dépalcements latéraux sont également autorisés.
</para>
<para>Positionnez la souris sur le premier pion que vous désirez déplacer, et enfoncer le bouton de gauche.
Le pion est alors mis en surbrillance. Maintenant, glissez la souris jusqu'à la position désirée.
Si le mouvement est valide, le pointeur de la souris se transforme en flèche dans cette direction et tous les pions à dé sont mis en surbrillance. Pour confirmer le déplacement, relachez le bouton de la souris.
</para>
<para>Les mouvements de front de plusieurs pions sont gérés de manière différente. Pour deux pions adjacents, cliquez entre les deux pions et faites glisser; pour trois pions, cliquez sur celui du milieu avec le bouton du milieu. Si un mouvement latéral est autorisé pour ces pions, ils seront mis en surbrilance. Sinon, seul celui du milieu le sera, et il s'agit d'un mouvement normal.
</para>
</listitem>
<listitem>
<para>Repousser les pions de l'adversaire.
Vous ne pouvez pousser au plus que deux pions adverses et ceci seulement si le nombre de pions que vous déplacez est supérieur a celui de votre adversaire. Ce qui veut dire que avec trois pions, vous ne pouvez en pousser qu'un ou deux et avec deux, un seul.
</para>
<para> Un cas spécial est celui où vous poussez un pion de votre adversaire hors du plateau. Si vous le faites six fois, vous avez gagné.
</para>
</listitem>
</itemizedlist>
</para>
<para>Si vous avez de la difficulté à comprendre le jeu, laissez l'ordinateur jouer tout seul. Pour cela, après avoir lancé kabalone, sélectionnez le menu Options/L'ordinateur joue/Les deux et commencez une nouvelle partie.
</para>
</chapter>
<chapter id="InterfaceUtilisateur">
<title>Interface Utilisateur</title>
<para>La manière de déplacer les pions est expliquée à la section <emphasis> Règles du Jeu</emphasis>. Les boutons dans la barre d'outils ont la même signification que les entrées du menu Fichier</para>
<para><emphasis remap="bf">Le Menu Fichier </emphasis>
<itemizedlist>
<listitem>
<para><literal remap="tt">Nouvelle Partie</literal> -
Commence un nouveau jeu si une partie est déjà en cours.</para>
</listitem>
<listitem>
<para><literal remap="tt">Arreter la Recherche</literal> -
Quand l'ordinateur cherche une solution, celle-ci s'arrête, et la meilleure solution qu'il a trouvé à cet instant est jouée.</para>
</listitem>
<listitem>
<para><literal remap="tt">Défaire</literal> -
Reprend votre dernier mouvement. Deux coups sont repris: le votre et celui de votre adversaire. C'est donc a vous de jouer à nouveau. Cent mouvements sont mémorisés, n'hésitez donc pas a revenir en arrière jusqu'au début du jeu (Raccourci : la touche F2). Le mode Modifier (voir Menu Editer/ Modifier plus loin), décrémente le numéro de cette position.</para>
</listitem>
<listitem>
<para><literal remap="tt">Avance</literal> -
Utile seulement en mode Modifier: augment le numéro de la position.</para>
</listitem>
<listitem>
<para><literal remap="tt">Truc</literal> -
Une aide pour le mouvement suivant est donnée. Possible seulement dans le cas où vous jouez en mode normal ou supérieur, le numéro de la position est supérieur à 2, et vous ne defaites pas votre mouvement.</para>
</listitem>
<listitem>
<para><literal remap="tt">Réseau</literal> -
Si vous cochez cette case, KAbalone pase en mode réseau. Tous les Abalone qui sont en mode réseau communiquent les positions entre eux. De cette manière, deux humains peuvent jouer l'un contre l'autre sur des ordinateur différents ou alors, on peut observer Abalone joué sur un autre ordinateur.</para>
<para> Pour changer les positions, les Abalone doivent se conna&icirc;tre mutuellement. Si ils sont démarrés sur la même machine, il n'y a besoin de rien de special (à part choisir le mode Réseau). Si ils sont lancés sur des machines différentes, il faut spécifier les autres machines via l'option <literal remap="tt">-h</literal>.</para>
<para>Pour ceux qui veulent des détails, KAbalone, en mode Réseau, écoute un socket  TCP pour conna&icirc;tre les changements de position. On peut spécifier un port de commnication avec l'option <literal remap="tt"> -p</literal>.
C'est nécessaire si vous désirez jouer à KAbalone en mode réseau.
</para>
<para>Exemples:
<itemizedlist>
<listitem>
<para>Chris sur machine1 et Marie, sur machine2 veulent jouer l'un contre l'autre. Marie démarre simplement KAbalone, et place l'option Options/L'Ordinateur joue sur "Aucun", et choisit le mode Réseau. Chris démarre KAbalone en tapant: <literal remap="tt">kabalone -h machine2</literal>. Maintenant l'un des deux peut commencer en bougeant les rouges. Chaque fois qu'un des deux joueurs bouge, son déplacement est automatiquement reporté sur le jeu de l'autre.</para>
</listitem>
<listitem>
<para>Jean veut regarder un jeu. Il fait pareil que Chris, mais ne bouge pas les pions lui même.</para>
</listitem>
<listitem>
<para>Il existe deux mode Réseau différents.
<literal remap="tt">m1</literal> et <literal remap="tt">m2</literal>. Pour les distinguer, choisissons le port 12345 pour l'un. Pour le mode <literal remap="tt">m1</literal>, on démarre comme d'habitude avec  <literal remap="tt">kabalone</literal> et le moins habituel <literal remap="tt">kabalone -p 12345</literal>. Pour le  mode <literal remap="tt">m2</literal>, on lance <literal remap="tt">kabalone -h m1</literal> et <literal remap="tt">kabalone -h m1:12345</literal> ou les : séparent le port et l'adresse comme pour une URL.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><literal remap="tt">Quitter</literal>
Finit le jeu
</para>
</listitem>
</itemizedlist>
</para>
<para><emphasis remap="bf">Le Menu Editer</emphasis></para>
<para><itemizedlist>
<listitem>
<para><literal remap="tt">Modifier</literal> -
Fait passer KAbalone en mode Modifier. Vous pouvez désormais changer les positions des rouges et/ou des jaunes en en rajoutant ou en en enlevant. La ligne de statut vous indique le nombre de pièces rouges et jaunes, le numéro du mouvement, le prochain joueur, et si la position est valide.
Un point d'exclamation signifie NON, et un signe "coché" veut dire OUI. Si la position est invalide et que vous retournez en mode Jeu, vous ne pouvez jouer! Seules des positions valides peuvent être utilisées comme positions de départ pour un jeu. Remarque: si vous jouez en mode Réseau, la position est transmise quand vous retournez en mode Jeu.

<literal remap="tt">Reprendre </literal> et <literal remap="tt">Avance</literal> incrémentent ou décrémente juste le numéro du mouvement, mais ne changent rien aux pièces.</para>
<para><emphasis remap="bf">Usage</emphasis>: en pressant le bouton droit ou le bouton gauche de la souris,  sur une case vide ou sur une pièce jaune, vous passez en mode "Ajout de pièces rouges". En appuyant sur le bouton du milieu sur une case vide ou sur une pièce rouge, vous passez en mode "Ajout de pièces jaunes". Et enfin, en appuyant sur le bouton droit ou gauche sur une pièce rouge, ou sur le bouton du milieu sur une jaune, vous passez en mode "Retirer une pièce". En enfonçant le bouton et en vous déplaçant, vous allez agir à chaque endroit où vous passerez. Pour finir vos modifications, relachez le bouton de la souris.</para>
</listitem>
<listitem>
<para><literal remap="tt">Copier</literal>
Permet de faire une copie de votre position actuelle sur le tableau de jeu dans le Presse-Papier, en utilisant une représentation ASCII de celui-ci. Vous pouvez maintenant copier cette version "texte" dans n'importe quel éditeur de texte, en pressant le bouton du milieu.
</para>
</listitem>
<listitem>
<para><literal remap="tt">Coller</literal>
Interprète le contenu du Presse-Papier comme le codage ASCII du plateau de jeu de KAbalone. Une représentaion du plateau peut être obtenue en faisant un 
<literal remap="tt">Copier</literal>.</para>
<para>De cette manière, vous pouvez echanger les positions de deux KAbalone en utilisant <literal remap="tt">Copier</literal> chez un et<literal remap="tt">Coller</literal> chez l'autre, mais il vaut mieux utiliser le mode Réseau (voir plus haut). Une autre utilisation est la sauvegarde de votre partie actuelle dans un fichier texte (en utilisant <literal remap="tt">Copier</literal> et de la retrouver plus tard en utilisant l'option <literal remap="tt">Coller</literal></para>
</listitem>
<listitem>
<para><literal remap="tt">Sauver la Position</literal> -
Vous pouvez sauver votre partie actuelle et la continuer plus tard en utilisant <literal remap="tt">Restaurer la Position</literal>. La position sauvegardée l'est dans le fichier de configuration de KAbalone.</para>
</listitem>
</itemizedlist>
</para>
<para><emphasis remap="bf">Le Menu Options</emphasis>
<itemizedlist>
<listitem>
<para><literal remap="tt">Niveau</literal> -
L'ordinateur peut jouer à quatre niveaux différents. Ce niveau influence le nombre de mouvements qu'il va prédire pour calculer son meilleur mouvement. En appuyant sur S, vous arretez sa recherche.</para>
</listitem>
<listitem>
<para><literal remap="tt">L'Ordinateur Joue</literal> -
Vous pouvez choisir que l'ordinateur joue avec les Rouges, les Jaunes, ou les deux. Choisissez avant de commencer. Bien sur, pendant le jeu, vous pouvez changer de coté également. Choisissez "Aucun" pour jouer contre quelqu'un d'autre. C'est très utile en mode Réseau.</para>
</listitem>
<listitem>
<para><literal remap="tt">Déplacement Lent</literal> -
Un mouvement de l'ordinateur est généralement montré (si cette option est cochée) en faisant clignoter et en réhaussant la couleur des pièces utilisées. Déselectionnez cette option si vous ne voulez voir que le réhaussement de la couleur des pièces sans le clignotement.</para>
</listitem>
<listitem>
<para><literal remap="tt">Rendu des Billes</literal> -
Si vous sélectionnez cette option, le rendu des billes est fait par un traceur de rayon lumineux quand c'est nécessaire, c'est à dire quand on redimensionne la fenêtre.</para>
</listitem>
<listitem>
<para><literal remap="tt">Espionnage</literal> -
Si vous cochez cette option, quand c'est votre tour, l'ordinateur note le mouvement que vous voulez faire. Quand c'est son tour, il vous montre (dans la barre des status, et en colorant les pièces) quel est le meilleur coup qu'il a trouvé. Ce coup change bien s&ucirc;r lors de la recherche de l'ordinateur.
</para>
</listitem>
<listitem>
<para><literal remap="tt">Sauver</literal> -
Sauvegarde les options dans le fichier de configuration. Ces options sont restaurées au démarrage de KAbalone.
</para>
</listitem>
</itemizedlist>
</para>
</chapter>
<chapter id="Commandlineoptions">
<title>Options de la ligne de commande</title>
<para><literal remap="tt">kabalone [-p MonNumérode Port] [-h host[:Port]]*</literal></para>
<para>Avec <literal remap="tt">-p</literal> vous spécifiez le numéro du port que doit écouter le socket TCP quand vous êtes en mode Réseau.</para>
<para>Avec <literal remap="tt">-h</literal> vous précisez un processus KAbalone distant (avec eventuellement un numéro de port, si vous n'utilisez pas celui par défaut sur la machine distante) ou communiquer en mode Réseau. Vous pouvez en spécifier plusieurs.</para>
</chapter>
<chapter id="Epilogue">
<title>Epilogue</title>
<sect1 id="developer">
<title>Developpeur</title>
<para><literal remap="tt"><ulink url="mailto:weidendo@informatik.tu-muenchen.de">Josef Weidendorfer</ulink></literal></para>
</sect1>
<sect1 id="authors">
<title>Auteurs</title>
<para><literal remap="tt"><ulink url="mailto:weidendo@informatik.tu-muenchen.de">Josef Weidendorfer</ulink></literal></para>
<para><literal remap="tt"><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editeur</para>
</sect1>
<sect1 id="copyright">
<title>Copyright</title>
<para>kabalone est développé sous la license GPL</para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
