*****************************************************************
*                             JAV'ALBUM                         *
*                                ***                            *
*                        NOTICE D'UTILISATION                   *
*                           Septembre 1996                      *
*                            Erick NGUYEN                       *
*****************************************************************

	1. INSTALLATION
	2. PARAMETRES DE L'APPLET
	3. SYNTAXE DE DEFINITION DES PAGES
	4. EXEMPLES
	5. EN CAS DE PROBLEMES


-----------------------------------------------------------------
 1. INSTALLATION
-----------------------------------------------------------------

Vous venez de décompresser le fichier Album.zip avec succès.
Vous devez voir les fichiers et répertoires suivants :

  - Album.class
  - Page.class
  - Back.gif
  - Croc1.gif
  - Croc2.gif
  - Croc3.gif
  - Next.gif
  - Exemple.htm
  - Syntaxe.htm
  - [Images]
  - [Pages]

Pour utiliser l'applet, vous devez installer sur votre site au
moins les fichiers suivants :

  - Album.class
  - Page.class
  - Back.gif
  - Croc1.gif
  - Croc2.gif
  - Croc3.gif
  - Next.gif

plus les fichiers de définition de pages que vous aurez créés, et
les éventuels fichiers GIF ou JPG correspondant à la couverture
de l'album, au fond de page et aux images inclues dans vos pages.

Les fichiers "Exemple.htm", "Syntaxe.txt" et le contenu des
répertoires "Images" et "Pages" ne sont fournis que pour exemple.


-----------------------------------------------------------------
 2. PARAMETRES DE L'APPLET
-----------------------------------------------------------------

Dans votre fichier HTML, l'applet doit être déclarée comme suit :

<APPLET CODE="Album.class" WIDTH=561 HEIGHT=374>
  <PARAM NAME="BGCOLOR" VALUE="R V B">
  <PARAM NAME="PGCOLOR" VALUE="R V B">
  <PARAM NAME="BGFILE" VALUE="fichier_image">
  <PARAM NAME="PGFILE" VALUE="fichier_image">
  <PARAM NAME="PAGE1" VALUE="fichier_page1">
  <PARAM NAME="PAGE2" VALUE="fichier_page2">
  [...]
  <PARAM NAME="PGNUM" VALUE="[ON][OFF]">
  <!--Code pour les browsers ne supportant pas Java-->
  <FONT SIZE=2>(Votre browser ne supporte pas Java)</FONT><BR>
</APPLET>

Les paramètres sont tous optionnels, exceptés au moins un fichier
de définition de page. Lorsqu'un paramètre est omis, une valeur par
défaut lui est associée. Leur signification est la suivante :

<PARAM NAME="BGCOLOR" VALUE="R V B">
  - Définit la couleur de la couverture de l'album
  - Lorsqu'un fichier BGFILE est défini, cette couleur n'est
  utilisée que pour tracer le relief de la couverture.
  - Par défaut : VALUE="144 47 0"

<PARAM NAME="PGCOLOR" VALUE="R V B">
  - Définit la couleur du fond des pages de l'album
  - Lorsqu'un fichier PGFILE est défini, cette couleur n'est
  pas utilisée
  - Par défaut : VALUE="255 255 207"

<PARAM NAME="BGFILE" VALUE="fichier_image">
  - Définit un fichier image utilisé pour la couverture
  - Ce fichier est appliqué en mosaique sur toute la surface de
  la couverture
  - Par défaut : la couleur BGCOLOR est utilisée

<PARAM NAME="PGFILE" VALUE="fichier_image">
  - Définit un fichier image utilisé pour le fond des pages
  - Ce fichier est appliqué en mosaique sur toute la surface de
  la page
  - Par défaut : la couleur FGCOLOR est utilisée

<PARAM NAME="PAGE1" VALUE="fichier_page1">
  - Indique le fichier de définition de la page 1
  - Il doit y avoir autant de ligne <PARAM NAME="PAGEx" ...>
  qu'il y a de pages, les noms de paramètres devant être
  CONSECUTIFS (PAGE1, PAGE2, etc...)
  - Le fichier de définition de page peut porter un nom et une
  extension quelconques

<PARAM NAME="PGNUM" VALUE="[ON][OFF]">
  - VALUE="ON"  : force l'affichage des numéros de pages
  - VALUE="OFF" : inhibe l'affichage des numéros de pages


-----------------------------------------------------------------
 3. SYNTAXE DE DEFINITION DES PAGES
-----------------------------------------------------------------

La syntaxe utilisée dans les fichiers de définition des pages est
simpliste, similaire au langage HTML. Elle est composée de "TAGS"
servant à formatter le texte et les images à afficher. Ces TAGS
contiennent des attributs qui sont TOUS optionnels. Des valeurs
par défaut sont associées aux attributs manquants. Ces TAGS
sont les suivants :

<TXT FONT=ft SIZE=sz STYLE=st COLOR=r,v,b>

  Définit un paragraphe de texte autoformatté (retours à la ligne
  automatiques). Ce type de texte est obligatoirement aligné à
  gauche, et ne peut être associé à un lien.
  Valeur des attributs (valeur par défaut):
  - FONT=TimesRoman, Arial, Courier (TimesRoman)
  - SIZE=sz (15)
  - STYLE=Plain, Bold, Italic, BoldItalic (Plain)
  - COLOR=r,v,b (0,0,0)


<TIT ALIGN=align FONT=ft SIZE=sz STYLE=st COLOR=r,v,b URL=url LNK=lnk>

  Définit un "titre", c'est-à-dire une seule ligne de texte, sans
  formattage automatique. Ce type de texte peut être aligné à
  gauche, au centre ou à droite. Il peut aussi être associé à
  un lien vers une autre page de l'album ou une page HTML.
  Valeur des attributs (valeur par défaut):
  - ALIGN=Left, Center, Right (Left)
  - FONT=TimesRoman, Arial, Courier (TimesRoman)
  - SIZE=sz (18)
  - STYLE=Plain, Bold, Italic, BoldItalic (Bold)
  - COLOR=r,v,b (0,0,0)
  - URL=adresse URL (absolue ou relative) d'une page HTML liée (aucun)
  - LNK=numéro d'une page de l'album (aucun)
  (URL et LNK ne peuvent pas être utilisés en même temps)


<IMG SRC=src URL=url LNK=lnk>
  
  Affiche une image centrée sur la page
  Valeur des attributs (valeur par défaut):
  - SRC=nom du fichier image (attribut INDISPENSABLE)
  - URL=adresse URL (absolue ou relative) d'une page HTML liée (aucun)
  - LNK=numéro d'une page de l'album (aucun)
  (URL et LNK ne peuvent pas être utilisés en même temps)


<SOM FONT=ft SIZE=sz STYLE=st COLOR=r,v,b>

  Définit une entrée de sommaire, c'est-à-dire une seule ligne de
  texte occupant toute la largeur de la page avec, à gauche,
  le nom de l'entrée et, à droite, le numéro de page. La ligne de
  texte est automatiquement associée à un lien vers la page
  concernée.
  Valeur des attributs (valeur par défaut):
  - FONT=TimesRoman, Arial, Courier (TimesRoman)
  - SIZE=sz (18)
  - STYLE=Plain, Bold, Italic, BoldItalic (Bold)
  - COLOR=r,v,b (0,0,0)

<BR haut>
  Force un retour à la ligne.
  - Lorsque ce tag est donné sans paramètre (<BR>), le saut de
  ligne correspond à la hauteur de la dernière police utilisée.
  - Lorsque la hauteur est précisée, elle est exprimée en pixels.

<HR WIDTH=w COLOR=r,v,b>
  Dessine une ligne horizontale.
  - WIDTH : w est TOUJOURS un pourcentage (ne pas mettre "%")
  - COLOR=r,v,b (0,0,0)


*** Remarque importante ***

Lorsqu'un tag quelconque est inséré au milieu d'un texte, il faut
répéter le tag original du texte. Par exemple :

<TXT SIZE=15>
Blah, blah, blah, blah, ...
<IMG SRC=toto.jpg>
Papoti, papota, ...

Ce qui précède est INCORRECT. Il faut écrire :

<TXT SIZE=15>
Blah, blah, blah, blah, ...
<IMG SRC=toto.jpg>
<TXT SIZE=15>
Papoti, papota, ...


-----------------------------------------------------------------
 4. EXEMPLES
-----------------------------------------------------------------

Pour un exemple de déclaration de l'applet, voir le fichier :

  - Exemple.htm

Pour des exemples de définition de pages, voir les fichiers :

  - Pages/Java1.pag
  - [...]
  - Pages/Java12.pag


-----------------------------------------------------------------
 5. EN CAS DE PROBLEMES
-----------------------------------------------------------------

  Afin de conserver une taille raisonnable à l'applet, le
  traitement des erreurs a été réduit au strict minimum (ne pas
  faire planter l'applet). Entre autres, la syntaxe de définition
  des pages n'est pas (ou très peu) vérifiée.

  Donc, en cas de problème :

  a. Vérifiez bien la syntaxe de toutes vos pages,
  b. Affichez la console Java, un message y est peut-être affiché
  c. En dernier recours, contactez-moi par mail :
  
              ==>>      guigui@mygale.org      <<==

     en décrivant de façon PRECISE (et concise) le problème.
     Joindre éventuellement le source incriminé.


Amusez-vous bien, et soyez sympas, tenez-moi au courant des bugs
ou dysfonctionnements éventuels, en particulier les problèmes
rencontrés sur différents navigateurs.

A+
Erick =^o^=

==============================================
  Erick Nguyen
  Email : guigui@mygale.org
  Homepage : http://www.mygale.org/03/guigui
==============================================