chess.exobase

Fonction Function)

Cette applet a pour but d'afficher des exercices (problèmes, études voire parties entières) dans un seul échiquier. Ce dernier est associé à :

des boutons de commandes en dessous,
une zone de texte au dessus qui commente la position courante,
une zone de texte sur la droite qui rappelle tous les coups déjà joués et les commentaires associés mais pas les coups restant à jouer (il faut bien que le lecteur travaille un peu),
un menu en haut à gauche permettant de sélectionner une ensemble particulier de problèmes,
des boutons + - x qui permettent de changer l'exercice en cours. Les boutons + et - sont faciles à interpréter : on passe à l'exercice suivant ou on revient à l'exercice précédent. Le bouton x permet une sélection aléatoire.

This applet allows you to display exercises (problems, studies or full games) on a single chess board. This one is associated to :

command buttons,

a short text area above commenting the current position,

a larger text zone on the right recalling previous moves and associated comments but not remaining moves (the reader must work a little bit in looking for next moves),

an upper left menu enabling the reader to select a particular category of exercises,

three buttons + - x to select a new exercise in the current category. The buttons + and - are easy to understand (next or previous problem). The button x selects randomly a new problem.

Exemple (Example)

  <applet code="chess.exobase" archive="chess.jar" width=550 height=375>
     <PARAM NAME="list"   VALUE="studies.lst">
  </applet>

Paramètres principaux (Main parameters)

list: fichier menu décrivant la liste des catégories d'exrcices et les noms des fichiers au format PGN
menu file describing the list of catageories and the associated PGN file names

Paramètres optionnels (Optional parameters)

textheight: hauteur du texte juste au dessus de l'échiquier. Par défaut, elle est égale à 36 pixels ce qui représente deux lignes.
height of the text area just above the chessboard. By default, it is equal to 36 which means two lines.
textwidth: largeur de la zone de texte à droite de l'échiquier. Par défaut, elle est égale à 4/9*width.
width of the text zone on the right. By default, it is equal to 4/9*width.

Fichier "menu" menu file

Un fichier menu est constitué d'un ensemble de lignes dont le format est le suivant :

   nom d'un fichier PGN=titre associé

A menu file is composed of a set of lines in the following format :

   PGN file name=category title

Voici un exemple pratique : c'est le contenu du fichier etudes.lst :
Here is an actual example : the contents of the file etudes.lst :

   etudes/finales_de_pions.pgn=Finales de pions
   etudes/finales_diaboliques.pgn=Finales diaboliques
   etudes/tactique.pgn=Savez vous attaquer ?

Fichiers au format PGN

Le format PGN doit être strictement appliqué. Une partie ou un exercice est constituée :

d'une zone de tags entre crochets [nom_du_tag "valeur du tag"] (le tag FEN permet de définir la position initiale d'un problème, les autres tags servant simplement de commentaires).
de la partie proprement dite contenant elle-même plusieurs types d'éléments :

les numéros des coups sont facultatifs : ils se terminent toujours par un ou plusieurs points.
Les coups sont indiqués dans le format court ou le format long en utilisant les symbols anglais pour la désignation des pièces. Le symbol du pion est facultatif,
les variantes sont placées entre parenthèses,
les commentaires éventuels sont placés entre accolades,
les marques (! ? !! ?? ...) sont des glyphs qui suivent un format spécial commençant par le caractères $ ($1 = ! $2 = ? $3=!! $4=?? $5=!? $6=?! ...)

une marque de fin de partie. Voici les quatres marques autorisées : 1-0 (les blancs ont gagné) 0-1 (les noirs ont gagné) 1/2-1/2 (partie nulle) * (partie interrompue).

Un fichier PGN peut contenir un nombre quelconque de parties ou d'exercices.
The PGN format must be strickly applied. A game or exercise is composed of :

a TAG zone, each tag following the format [tag_name "tag value"] (the tag FEN enables you to define a initial position, other tags being simply comments).

the game itself composed of several kinds of elements :

facultative move numbers ending by one or several points,

the moves using the english piece symbols,

the variants enclosed between parentheses,

comments between { and },

glyphs starting by $ and ending by a space : $1=! $2=? $3=!! $4=?? $5=!? $6=?!<:tt> ...
a mark ending the game. Four marks are allowed : 1-0 (white wins) 0-1 (black wins) 1/2-1/2 (draw) * (interrupted game)
A PGN file may contain as many games as you want.Mise à jour des problèmes Updating problems Si vous avez déjà publié des exercices sur votre site en utilisant chess.exobase, alors votre travail normal consiste maintenant à mettre à jour régulièrement les exrcices en ajoutant de nouvelles catégories ou en complétant des catégories existantes : si vous ajoutez des parties ou exercices dans un fichier PGN déjà publié, alors vous avez simplement à remplacer l'ancienne version du fichier PGN par la nouvelle. si vous voulez ajouter une catégorie, alors vous devez : modifier le fichier menu en joutant une ligne, installer le nouveau fichier PGN à l'emplacement indiqué par le fichier menu. Dans aucun des deux cas vous n'avez à modifier votre page Html. If you have already published games or studies using the applet chess.exobase, then your main work consists now in updating regularly the exercises in adding new categories or in completing existing categories : if you add games or exercices in a PGN file already published, then you have just to update this file on your web site, if you want to add a category, then you have to : modify the menu file in adding a line, installing the new PGN file at the location indicated in the menu file. In any case, you don't have to update you Html page.