MINI HOW-TO

<span lang="fr">
ITEM: Simple album

En supposant que vous avez dj install album correctement, nous pouvons
raliser quelques manipulations basiques. Si vous rencontrez une erreur ou
un quelconque problme ici, regardez les documents d'installation.

Vous avez besoin d'un rpertoire accessible depuis le web o mettre vos
thmes et votre album photos. Nous utiliserons /home/httpd/test dans ce
document. Ce rpertoire a besoin d'tre accessible par le serveur web. Dans
cet exemple, nous utiliserons l'URL suivante :
	http://myserver/test

Adaptez vos commandes / URLs en fonction de vos besoins.

Premirement, crez un rpertoire et mettez-y des images dedans. Nous
l'appellerons ainsi :
	/home/httpd/test/Photos

Puis nous ajouterons quelques images dnommes 'IMG_001.jpg'  'IMG_004.jpg'.

Maintenant, pour ce test basique, lançons simplement album:

<code>% album /home/httpd/test/Photos</code>

Maintenant, vous pouvez visualiser l'album cr via un navigateur  l'adresse :
	http://myserver/test/Photos

ITEM: Ajouter des lgendes

Crez un fichier /home/httpd/test/Photos/captions.txt avec le contenu
suivants (utilisez la touche 'tab' si vous voyez "  [tab]  ") :

-- captions.txt ---------
IMG_001.jpg  [tab]  Nom de la premi&egrave;re image
IMG_002.jpg  [tab]  Deuxi&egrave;me image
IMG_003.jpg  [tab]  Encore une image      [tab] avec une l&eacute;gende!
IMG_004.jpg  [tab]  Derni&egrave;re image        [tab] avec une autre l&eacute;gende.
-------------------------

Puis lancer de nouveau la commande album :

<code>% album /home/httpd/test/Photos</code>

Vous verrez que la lgende a t modife.

Maintenant, crez un fichier avec du texte dedans :
/home/httpd/test/Photos/header.txt

Et relancez la commande album une fois de plus. Vous verrez alors le texte
du fichier affiche au sommet de la page.

ITEM: Masquer des photos

Il y a quelques moyens de masquer des photos / des fichiers / des rpertoires
mais nous allons utiliser le fichier des lgendes. Essayez de placer un
commentaire avec le caractre '#' devant le nom d'une image dans captions.txt:

-- captions.txt ---------
IMG_001.jpg  [tab]  Nom de la premi&egrave;re image
#IMG_002.jpg  [tab]  Deuxi&egrave;me image
IMG_003.jpg  [tab]  Encore une image      [tab] avec une l&eacute;gende!
IMG_004.jpg  [tab]  Derni&egrave;re image        [tab] avec une autre l&eacute;gende.
-------------------------

Relancez la commande album et vous verrez que l'image IMG_002.jpg a maintenant
disparu.
Si vous aviez procd de la sorte la premire fois, vous n'auriez gnr ni
l'image de taille rduite ni la vignette correspondante. Si vous le souhaitez,
vous pouvez les supprimer en utilisant l'option -clean :

<code>% album -clean /home/httpd/test/Photos</code>

ITEM: Utiliser un thme

Si les thmes ont t correctement installs and sont accessibles via
them_path (chemin d'accs aux thmes), alors vous pouvez utiliser un thme
lors de la gnration de votre album :

<code>% album -theme Blue /home/httpd/test/Photos</code>

L'album photo courant devrait tre maintenant bas sur le thme Blue (bleu).
S'il y a tout un tas de liens casss ou d'images qui n'apparaissent pas, il
y a de forte chance pour que votre thme n'ait pas t install dans un
rpertoire accessible depuis le web ; voir les documents d'installation.

Album sauvegarde les options que vous lui indiquez. Ainsi, la prochaine fois
que vous lancerez la commande album :

<code>% album /home/httpd/test/Photos</code>

vous utiliserez toujours le thme Blue. Pour dsactiver un thme, tapez :

<code>% album -no_theme /home/httpd/test/Photos</code>


ITEM: Images rduites

Les images de pleine taille sont en gnrale d'une taille trop imposante pour
un album photo sur le web. C'est pourquoi nous utiliserons des images rduites
sur les pages web gnres :

<code>% album -medium 33% /home/httpd/test/Photos</code>

Cependant, vous avez toujours accs aux images pleine taille en cliquant
simplement sur les images rduites.

La commande :

<code>% album -just_medium /home/httpd/test/Photos</code>

empchera la liaison entre les images de taille rduite et les images pleine
taille, en prsumant que nous avons lanc prcdemment une commande avec
l'option -medium.

ITEM: Ajouter des lgendes EXIF

Ajoutons la valeur du diaphragme dans les lgendes de chaque image.

<code>% album -exif "&lt;br&gt;diaphragme=%Aperture%" /home/httpd/test/Photos

Cette commande ajoutera seulement la valeur du diaphragme pour les images qui
disposent de la balise exif (le symbole entre les caractres '%') 'Aperture'
signifiant diaphragme en franais ! Nous avons galement ajout la balise
&lt;br&gt; qui permet d'ajouter cette information exif sur une nouvelle ligne.

Nous pouvons rajouter d'autres informations exif :

<code>% album -exif "&lt;br&gt;focale: %FocalLength%" /home/httpd/test/Photos

Parce que album sauvegarde vos prcdentes options, nous disposons maintenant
de deux balises exif pour toutes les images spcifiant  la fois le diaphragme
et la focale.
Supprimons le diaphragme :

<code>% album -no_exif "&lt;br&gt;diaphragme=%Aperture%" /home/httpd/test/Photos</code>

La chane de caractres suivant l'option '-no_exif' a besoin de correspondre
exactement  celle entre prcdemment avec l'option '-exif' sinon elle sera
ignore. Vous pouvez galement diter le fichier de configuration qu'album a
cr ici :
	/home/httpd/test/Photos/album.conf
Puis supprimez l'option en question.

ITEM: Ajouter d'autres albums

Imaginons que vous faites un voyage en Espagne. Vous prenez des photos et les
mettez dans le rpertoire :
	/home/httpd/test/Photos/Espagne/

Maintenant, excutez la commande album depuis le rpertoire principal :

<code>% album /home/httpd/test/Photos</code>

Cette commande modifiera l'album principal Photos qui sera reli  Espagne
puis elle lancera galement la commande album sur le rpertoire Espagne avec
les mmes caractristiques / thme, etc.

Maintenant, faisons un autre voyage en Italie et crons le rpertoire :

	/home/httpd/test/Photos/Italie/

Nous pourrions lancer la commande depuis le rpertoire principal :

<code>% album /home/httpd/test/Photos</code>

Mais ceci rescannerait le rpertoire Espagne qui n'a pas chang. Album ne
gnrera aucune page HTML ni vignette  moins qu'il ait le besoin de la
faire. Cependant, il peut perdre du temps, plus particulirement si vos
albums photos deviennent de plus en plus volumineux. Aussi, vous pouvez
juste demander d'ajouter le nouveau rpertoire :

<code>% album -add /home/httpd/test/Photos/Italie</code>

Cette commande modifiera l'index de la premire page (dans Photos) et
gnrera l'album correspond au rpertorie Italie.

ITEM: Traduit par:

Jean-Marc [jean-marc.bouche AT 9online.fr]
</span>
