Applets, mode d'emploi

Applets archivées en formar jar   Applets archivées en formar zip    Documentation du programmeur

Introduction

Elles sont toutes basées sur un même ensemble de classes qui a été entièrement réécrit.

Voici les améliorations principales offertes par rapport à la version précédente :

• une zone de texte interactive qui permet, par simple clic sur un coup, de mettre en place automatiquement la position correspondante,
• une synchronisation de la zone de texte et des boutons de commande afin que le coup joué soit toujours dans la fenêtre d'affichage,
• le tracé de figurines à la place des sempiternels symboles anglophones.
• l'introduction de caractères de contrôle qui vous permettent, dans les commentaires :
  • de mettre des couleurs ( &red &green &blue &black )
  • de montrer des figurines à la place des symboles ( ^P ^N ^B ^R ^Q et ^K)
  • d'écrire en roman, en italique ou en gras : &rm &it &bf
• une zone de commentaires colorisée par défaut même si vous n'avez pas utilisé les codes de contrôle ci-dessus,
• la possibilité de sortir les parties des pages Html : on peut désormais directement sauvegarder dans un fichier une partie en format PGN et la publier via une applet. ChessBase 7 offre une possibilité analogue (en JavaScript) mais le résultat est beaucoup moins interactif.
• l'introduction du format FEN pour entrer les positions de problèmes ou d'études,

L'ensemble des applets, images des pièces comprises, reste modeste (environ 80ko) et comparable à la taille d'une image 640x480 en format JPEG.

Téléchargement des applets

Les applets sont stockées dans un unique fichier chess.jar qu'il vous suffit de télécharger sur votre propre site (cliquez sur le lien et sauvegardez le fichier chez vous).

Ce fichier est une archive java qui contient toutes les classes et toutes les images utilisées par les applets.

Si vous voulez utiliser ces applets sur votre site Web vous devez :

• installer le fichier archive "chess.jar" sur votre site
• installer le répertoire chess que cette archive contient. Ce dernier point est une précaution nécessaire car les navigateurs ne sont pas tous en mesure d'exploiter directement une archive java (mais Internet Explorer de Microsoft le fait fort bien).

Pour mettre en service une applet dans une page Html il suffit alors d'appliquer la syntaxe générale suivante :

  <applet codebase="chemin d'accès au répertoire contenant le sous-répertoire chess"
          code="chess.nom_de_l'applet"
          archive="nom complet de l'archive" width=500 height=450>
    ... paramètres de l'applet sélectionnée ...
  </applet>

Le paramètre codebase est facultatif si le répertoire chess est stocké dans le même répertoire que la page Html (ce que je conseille). De plus tous les fichiers PGN que vous voulez publier doivent obligatoirement se situer dans le répertoire codebase ou dans un sous-répertoire sinon les applets ne pourront y accéder (limitation drastique des navigateurs pour des raisons de sécurité).

L'installation du répertoire en parallèle de l'archive demande quelques précautions. Si vous avez installé un compilateur java sur votre ordinateur, alors vous devez pouvoir créer le répertoire chess par la commande suivante :

   jar xvf chess.jar

Si vous n'avez pas installé java, pas de panique : j'ai aussi prévu une archive au format Zip (j'espère que vous avez quand même WinZip, unzip ou autre pkunzip ...). Cliquez sur le lien suivant pour la télécharger : chess.zip

Maintenant, faites très attention aux problèmes de majuscules et miniscules car Bill Gates vous attend au tournant (ce cher Bill ... sans lui on s'ennuierait !). En effet, Windows a la fâcheuse habitude de transformer les minuscules en majuscules ce qu'internet n'aime pas du tout et java encore moins. Pour les fichiers "*.class", il n'y a en principe pas de problème car ils ne suivent pas le format de DOS (suffixe de plus de 3 caractères) et Windows ne transforme pas leurs noms (Heureusement d'ailleurs car ceux-ci contiennent alternativement des majuscules et des minuscules qu'il ne faut surtout pas changer). Par contre, tous les autres fichiers (répertoires et images) repectent le format DOS et doivent apparaître en minuscules dans Windows Exporer. Si vous voyez "Chess" ou "CHESS" au lieu de "chess" alors remplacez les majuscules par des minuscules.

Le répertoire chess a une organisation très simple que vous devez donc contrôler : partez à la chasse aux majuscules dans tous les noms des fichiers gif et dans les noms des deux répertoires "chess" et "images".

   chess -> *.class
         -> images  -> *.gif

Les applets disponibles

• chess.replay remplace l'ancien replay : elle permet de rejouer des parties entrées comme paramètres de l'applet dans une page Html.
• chess.exo remplace l'ancien exo : elle permet d'afficher de nombreux petits échiquiers, chacun d'eux représentant, en général, un exercice à résoudre. Ces exercices sont ici aussi définis comme paramètres de l'applet.
• chess.database permet de rejouer des parties sauvegardées en format PGN dans des fichiers séparés. Attention : chaque fichier ne doit contenir qu'une seule partie. Ces parties peuvent néanmoins être rangées par catégories, via des fichiers décrivant des menus. L'applet propose ainsi deux menus : sélection de la catégorie et sélection de la partie.
• chess.exobase permet de rejouer des exercices (ou des parties) archivés en format PGN dans des fichiers séparés. Contrairement à chess.database, un même fichier PGN peut contenir plusieurs études (ou parties). Attention toutefois à la contrainte liée au téléchargement : il ne faut pas qu'un fichier PGN soit trop volumineux. C'est pourquoi cette applet est plutôt réservée à la publication d'études ou de problèmes qui, même commentés, restent de taille limitée.

Jouer ses propres variantes

• cliquer sur la pièce à déplacer
• cliquer sur la case d'arrivée

Autres informations

Par ailleurs, si vous désirez compléter les rubriques avec des parties commentées ou des problèmes de votre cru, n'hésitez pas : envoyez les moi en format PGN et je les publierai avec plaisir en vous mettant en référence.