MINI HOW-TO

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

En supposant que vous avez déjà installé album correctement, nous pouvons
réaliser quelques manipulations basiques. Si vous rencontrez une erreur ou
un quelconque problème ici, regardez les documents d'installation.

Vous avez besoin d'un répertoire accessible depuis le web où mettre vos
thèmes et votre album photos. Nous utiliserons /home/httpd/test dans ce
document. Ce répertoire 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.

Premièrement, créez un répertoire et mettez-y des images dedans. Nous
l'appellerons ainsi :
	/home/httpd/test/Photos

Puis nous ajouterons quelques images dénommées '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 légendes

Créez 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 légende a été modifée.

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

Et relancez la commande album une fois de plus. Vous verrz alors le texte
du fichier affichée au sommet de la page.

ITEM: Masquer des photos

Il y a quelques moyens de masquer des photos / des fichiers / des répertoires
mais nous allons utiliser le fichier des légendes. Essayez de placer un
commentaire avec le caractère '#' 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 procédé de la sorte la première fois, vous n'auriez généré ni
l'image de taille réduite 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 thème

Si les thèmes ont été correctement installés and sont accessibles via
them_path (chemin d'accès aux thèmes), alors vous pouvez utiliser un thème
lors de la génération de votre album :

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

L'album photo courant devrait être maintenant basé sur le thème Blue (bleu).
S'il y a tout un tas de liens cassés ou d'images qui n'apparaissent pas, il
y a de forte chance pour que votre thème n'ait pas été installé dans un
répertoire 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 thème Blue. Pour désactiver un thème, tapez :

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


ITEM: Images réduites

Les images de pleine taille sont en générale d'une taille trop imposante pour
un album photo sur le web. C'est pourquoi nous utiliserons des images réduites
sur les pages web générées :

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

Cependant, vous avez toujours accès aux images pleine taille en cliquant
simplement sur les images réduites.

La commande :

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

empêchera la liaison entre les images de taille réduite et les images pleine
taille, en présumant que nous avons lancé précédemment une commande avec
l'option -medium.

ITEM: Ajouter des légendes EXIF

Ajoutons la valeur du diaphragme dans les légendes 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 caractères '%') 'Aperture'
signifiant diaphragme en français ! 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 précédentes options, nous disposons maintenant
de deux balises exif pour toutes les images spécifiant à 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 chaîne de caractères suivant l'option '-no_exif' a besoin de correspondre
exactement à celle entrée précédemment avec l'option '-exif' sinon elle sera
ignorée. 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 répertoire :
	/home/httpd/test/Photos/Espagne/

Maintenant, exécutez la commande album depuis le répertoire 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 répertoire Espagne avec
les mêmes caractéristiques / thème, etc.

Maintenant, faisons un autre voyage en Italie et créons le répertoire :

	/home/httpd/test/Photos/Italie/
	
Nous pourrions lancer la commande depuis le répertoire principal :

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

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

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

Cette commande modifiera l'index de la première page (dans Photos) et
générera l'album correspond au répertorie Italie.

ITEM: Traduit par:

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