# Manuel de &kabalone;

Josef
Weidendorfer
Philip
Rodrigues

    phil.rod@ntlworld.com

Lauri
Watts

    lauri@kde.org

Relecteur
Gérard
Delafond

    g.delafond@medsyn.fr

Traducteur
2001-05-29
1.06.00
2001
Philip Rodrigues
&FDLNotice;

&kabalone; est un jeu de stratégie pour deux joueurs.

KDE
jeu
abalone
linux

## Introduction

&kabalone; est un simple jeu de stratégie qui se joue à deux. Chaque joueur a une couleur : soit rouge, soit jaune. Chaque joueur commence avec 14 boules. Le but du jeu est de déplacer ses boules de manière à pousser six boules de l'adversaire hors du plateau.

Le programme original a été développé pour DOS et XLib pure en 1993. Le portage sous &kde; a nécessité des modifications majeures.

L'idée de ce jeu n'est pas de moi. C'est un vrai jeu commercial produit, je crois, par une société allemande.

## Règles du jeu

Les rouges jouent toujours en premier.

Deux types de déplacements sont autorisés :

Normal

  Vous pouvez déplacer une, deux ou trois pièces alignées dans l'une des six directions. Les déplacements latéraux sont également autorisés.

  Cliquez avec le bouton gauche de la souris sur la première pièce que vous voulez bouger. La pièce est alors mise en sur-brillance. Maintenant, glissez la souris jusqu'à la position désirée. Si le mouvement est possible, le pointeur de la souris se transforme en flèche dans cette direction et toutes les boules à déplacer sont mises en sur-brillance. Pour confirmer le déplacement, relâchez le bouton de la souris..

  Les mouvements de front de plusieurs boules sont gérés de manière différente. Pour deux boules adjacentes, cliquez entre les deux boules et faites glisser ; pour trois boules, cliquez sur celle du milieu avec le bouton central de la souris. Si un mouvement de front est autorisé pour ces boules, elles seront mises en sur brillance. Sinon, seule celle du milieu le sera, et il s'agira d'un mouvement normal.

Pousser

  Vous ne pouvez pousser au plus que deux boules adverses et ceci seulement si le nombre de boules que vous déplacez est supérieur à celui de votre adversaire. Ce qui veut dire qu'avec trois boules, vous ne pouvez en pousser qu'une ou deux et avec deux, une seule.

  Un cas spécial est celui où vous poussez une boule de votre adversaire hors du plateau. Si vous le faites six fois, vous avez gagné.

Si vous avez de la difficulté à comprendre le jeu, laissez l'ordinateur jouer tout seul. Pour cela, après avoir lancé &kabalone;, choisissez Configuration L'ordinateur joue avec Les deux et commencez une nouvelle partie.

## Jeu en réseau

### Généralités sur le jeu en réseau

&kabalone; gère le jeu en réseau. Ceci permet à deux personnes de jouer l'une contre l'autre sur deux ordinateurs différents, ou à une personne d'observer le jeu d'un autre programme &kabalone;. Pour utiliser les possibilités de réseau de &kabalone;, vous devez le passer en mode réseau en sélectionnant Jeu Partie en réseau.

Tous les programmes &kabalone; qui sont en mode réseau échangent leurs plateaux.

Pour exporter les plateaux, les programme &kabalone; doivent se connaître. S'ils fonctionnent sur la même machine, il n'y a besoin de rien (sauf choisir le mode réseau). S'ils fonctionnent sur des ordinateurs différents, vous devez préciser la machine de l'autre en ligne de commande avec l'option `-h` de cette manière :

    %kabalone -hun_nom_d_hote

Pour ceux qui veulent des détails, &kabalone; en mode Réseau, écoute une socket TCP pour connaître les changements de position. On peut spécifier un port de communication avec l'option de ligne de commande `-p`. Vous devez faire ceci si vous voulez jouer deux jeux &kabalone; différents en réseau.

#### Exemples

- Chris sur machine1 et Mary sur machine2 veulent jouer l'un contre l'autre : Mary démarre simplement &kabalone;, règle le menu Configuration L'ordinateur joue avec sur Aucun et passe en mode réseau. Chris démarre &kabalone; avec

      %kabalone -h machine2

  et fait comme Mary. Maintenant, l'un des deux peut commencer en jouant avec les les rouges. Chaque fois qu'un des deux joueurs joue un coup, ce coup est automatiquement reporté sur le plateau de l'autre.

- John veut regarder un jeu. Il fait pareil que Chris, mais ne bouge pas les boules lui-même.

- Il existe deux modes réseau différents pour &kabalone; sur les machines m1 et m2. Pour distinguer les parties, choisissons le port 12345 pour l'une. Sur la machine m1, on démarre comme d'habitude avec :

      %kabalone

  pour le premier et (plus rare)

      %kabalone -p 12345

  pour le second. Sur m2 nous démarrons la premiere partie avec :

      %kabalone
      -h m1

  et le deuxième avec :

      %kabalone -h m1:12345

  (Les deux points séparent l'hôte et le port comme dans une &URL;).

## Options avancées

### Mode modification

Vous pouvez modifier le plateau actuel en sélectionnant Édition Modifier pour passer &kabalone; en mode modification. Vous pouvez ajouter des pièces rouges ou jaunes ou en supprimer. La barre d'état 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 non valide et que vous retournez en mode Jeu, vous ne pouvez pas jouer ! Seules des positions valides peuvent être utilisées comme positions de départ pour une partie.

Précédent et Suivant changent seulement le numéro du mouvement mais ne changent aucune pièce.

#### Utilisation

En cliquant avec le bouton gauche ou droit de la souris sur une case vide ou jaune, vous passez en mode Ajout de boule rouge ; en cliquant avec le bouton central sur une case vide ou rouge, vous passez en mode Ajout de boule jaune. Enfin, en cliquant avec le bouton gauche ou droit sur une boule rouge ou avec le bouton central sur une pièce jaune, vous passez en mode Suppression de boule. En tenant le bouton enfoncé et en balayant aux alentours, vous agirez sur chaque case que vous survolez. Vous finissez la modification en relâchant le bouton.

Pour quitter le mode de modification et revenir en mode jeu, décochez simplement Modifier du menu Édition.

##### Utilisation du Presse-papiers

Le plateau en cours de &kabalone; peut être copié dans le presse-papiers en utilisant la commande Copier du menu Édition, et collée en utilisant Coller. De cette manière, vous pouvez copier la position du plateau d'un programme &kabalone; vers un autre en cliquant Copier dans un programme et Coller dans l'autre, mais ceci est mieux réalisé avec le mode réseau (voir ci-dessus). Une autre utilisation est d'enregistrer des positions dans un fichier texte (en utilisant Copier et votre éditeur favori) et retrouver la position plus tard en la sélectionnant dans l'éditeur et en la collant dans &kabalone;.

### Niveau

L'ordinateur peut jouer à quatre niveaux différents, nommés :

- Facile

- Normal

- Difficile

- Défi

Plus le réglage est difficile, plus l'ordinateur cherche longtemps le meilleur mouvement. Vous pouvez interrompre sa recherche en enfonçant la touche S.

### Espion

Espion peut être activé ou désactivé à partir du menu Configuration, option Espion. Si c'est votre tour, vous pouvez voir dans la barre d'état l'estimation de l'ordinateur quant au déplacement que vous voulez faire. Si c'est au tour de l'ordinateur, vous pouvez voir (dans la barre d'état et avec les pièces en sur-brillance) le mouvement qu'il pense actuellement être le meilleur. Bien sûr, ceci change durant sa recherche.

### Choix de la couleur jouée par l'ordinateur

Vous pouvez choisir que l'ordinateur joue avec les Rouges, les Jaunes, ou les deux. Choisissez avant de commencer une partie. Bien sûr, 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.

## Référence des menus

La manière de déplacer les boules est expliquée à la section Règles du jeu. Les boutons de la barre d'outils ont la même signification que les items du menu Jeu ou Édition.

### Le menu Jeu

&Ctrl;N Jeu Nouveau

  Commence une nouvelle partie, même si une partie est déjà en cours.

S Jeu Arrêter la réflexion

  Quand l'ordinateur réfléchit, sa recherche est interrompue et il joue le meilleur coup qu'il a trouvé à cet instant.

Page Haut Jeu Précédent

  Revient à votre précédent déplacement. Deux (!) coups sont annulés : le mouvement de l'adversaire et votre dernier mouvement. C'est donc à nouveau à vous de jouer. Cent mouvements sont mémorisés ; n'hésitez donc pas à revenir en arrière jusqu'au début du jeu (plus rapide avec la touche F2). Le mode Modifier (voir le menu Édition Modifier ci-dessous), décrémente le numéro de cette position.

Page-bas Jeu Suivant

  Utile seulement en mode Modifier : augmente le numéro de la position.

H Jeu Conseil

  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 votre mouvement n'a pas été annulé.

N Jeu Partie en réseau

  Si ceci est activé, l'application est en mode réseau.

&Ctrl;Q Jeu Quitter

  Quitte&kabalone;.

### Le menu Édition

&Ctrl;C Édition Copier

  Copie la position actuelle du plateau dans le presse-papiers.

&Ctrl;V Édition Coller

  Interprète le contenu du presse-papiers comme le codage ASCII du plateau de jeu de &kabalone;. Une représentation du plateau peut être obtenue en faisant Copier.

&Ctrl;Ins Édition Modifier

  Bascule &kabalone; en mode Modifier.

&Ctrl;S Édition Mémoriser la position

  Vous pouvez enregistrer la position actuelle et la retrouver plus tard avec Édition Restaurer la position.

&Ctrl;O Édition Restaurer la position

  Restaure la position enregistrée dans le fichier de configuration de &kabalone; par Édition Mémoriser la position.

### Le menu Configuration

&Ctrl; M Configuration Afficher la barre de menus

  Montre ou cache la barre de menus de &kabalone;.

Configuration Afficher la barre d'outils

  Montre ou cache la barre d'outils (ou barre d'icônes).

Configuration Afficher la barre d'état

  Montre ou cache la barre d'état en bas de l'écran.

Configuration Enregistrer la configuration

  Enregistre toutes les options avec leurs valeurs actuelles pour devenir les valeurs par défaut de &kabalone;.

Configuration Raccourcis clavier...

  Ouvre une boîte de dialogue standard de &kde;, qui vous permet de changer les raccourcis-clavier de &kabalone;.

Configuration Barre d'outils...

  Ouvre une boîte de dialogue standard de &kde; vous permettant de changer la barre d'outils de &kabalone;.

Configuration Niveau

  Choisissez le niveau auquel joue l'ordinateur. Ce peut être :

  - Facile

  - Moyen

  - Difficile

  - Défi

Configuration L'ordinateur joue avec

  Vous pouvez choisir que l'ordinateur joue avec :

  - les Rouges

  - les jaunes

  - les deux

  - Aucun

Configuration Déplacements lents

  Un mouvement de l'ordinateur est généralement montré (si cette option est cochée) en faisant clignoter et en rehaussant la couleur des pièces utilisées. Dé-sélectionnez cette option si vous ne voulez pas attendre cette animation. Seule la sur-brillance se fera.

Configuration Boules élégantes

  Si vous sélectionnez cette option, le rendu des boules est fait par un traceur de rayon lumineux quand c'est nécessaire, &pex; quand on redimensionne la fenêtre.

Configuration Espion

  Si vous cochez cette option, vous activez le mode Espion.

### Le menu Aide

F1 Aide Contenu

  Ceci invoque le système d'aide de &kde; s'ouvrant sur les pages d'aide de &kabalone; (ce document).

&Shift; F1 Aide Qu'est-ce que c'est ?

  Ceci transforme le pointeur de souris en une combinaison d'une flèche et d'un point d'interrogation. En cliquant sur les items dans &kabalone;, s'ouvrira une fenêtre d'aide (s'il en existe une pour cet item) qui explique sa fonction.

Aide Rapport de bogue

  Rapporter un bogue ou un souhait aux auteurs de &kabalone;'s.

Aide Àpropos de KAbalone

  Ceci affiche la versions des informations sur les auteurs (NDT et les traducteurs !)

Aide À propos de KDE

  Ceci affiche la version de &kde; et d'autres informations de base.

## Options de ligne de commande

    kabalone

    -p
    MyPortNumber

    -h
    host:port

Avec `-p`, vous spécifiez le numéro de port que doit écouter le socket TCP quand vous êtes en mode réseau

Avec `-h`, vous précisez un processus &kabalone; distant (avec éventuellement un numéro de port, si vous n'utilisez pas celui par défaut sur la machine distante) pour communiquer en mode réseau. Vous pouvez en spécifier plusieurs.

## Remerciements et Licences

&kabalone;

Program copyright 1997-2000 Josef Weidendorfer weidendo@informatik.tu-muenchen.de

Documentation originale par Robert Williams rwilliams@kde.org et Josef Weidendorfer

Documentation mise à jour pour &kde; 2.0 par Philip Rodrigues philip.rodrigues@libertysurf.co.uk

Traduction française par Gérard Delafond g.delafond@medsyn.fr

&underFDL; &underGPL;

## Installation

### Comment obtenir &kabalone;

&kabalone; fait partie du projet &kde; http://www.kde.org. On peut trouver &kabalone; dans le paquetage kdegames sur ftp://ftp.kde.org/pub/kde/, le principal site ftp du projet &kde;.

Toutes les bibliothèques nécessaires se trouvent sur le site &FTP; de &kde;.

### Compilation et installation

Pour compiler et installer &kabalone; sur votre système, saisissez les commandes suivantes dans le dossier de &kabalone; de la distribution kdegames :

    % ./configure
    % make
    % make install

Comme &kabalone; utilise autoconf et automake, vous ne devriez pas avoir de problème pour le compiler. Si toutefois c'était le cas, veuillez les signaler à l'auteur à l'adresse weidendo@informatik.tu-muenchen.de.