#
# pyAwale - A simple Awalé game
# The count-and-capture official board game of Africa.
# Author: MiKael NAVARRO <klnavarro@gmail.com>.
#

pyAwale - A simple Awalé game
=============================

L'**Awalé** ou Awélé_ est un jeu très ancien originaire
d'Afrique considéré comme le jeu d'échecs africain.

De très nombreuses légendes circulent sur son origine. On dit
que certains hommes ayant marché à travers le désert de
nombreux mois arrivèrent enfin à la mer. Ils y trouvèrent de
superbes coquillages qu'ils emportèrent comme souvenirs. Durant
leur longue marche de retour, ils auraient fait des trous dans le
sable pour stocker les coquillages. L'awalé était né.

.. _Awélé: http://fr.wikipedia.org/wiki/Aw%C3%A9l%C3%A9

C'est le plus répandu des jeux de la famille mancala_, ensemble de
jeux africains de type "compter et capturer" dans lesquels on
distribue des cailloux, graines ou coquillages dans des coupelles ou
des trous, parfois creusés à même le sol.

.. _mancala: http://fr.wikipedia.org/wiki/Mancala

Le projet **pyAwalé** propose une implémentation des règles
de jeu appelée Abapa avec la *Pygame*.

Licence
=======

pyAwalé est fourni sous licence GPL, sans aucune garantie de
fonctionnement. De même, les corrections de bugs et mises à jour ne
sont pas garanties. Référez vous au fichier LICENCE (qui doit être
inclus dans cette distribution) pour plus de détails sur les termes de
la licence.

Éléments requis
===============

La seule dépendance requise est Python_ 2.3 ou supérieur.

.. _Python: http://python.org

Pour jouir de l'interface graphique la Pygame_ est aussi requise.

.. _Pygame: http://pygame.org

Théoriquement ce logiciel doit fonctionner sur toutes les 
plates-formes.

Installation
============

Pour installer *pyAwalé*, veuillez vous référez au fichier INSTALL.

Usage
=====

Lancez simplement le script (depuis le répertoire des sources) ::

  $ python -O src/pyawale.py --help

Pour plus de détails référez-vous à la documentation fournie dans le
sous répertoire doc/.

-- 
MiKaël NAVARRO
