Utiliser album / Options de base

<span lang="fr">

ITEM: Excution basique

Crez un rpertoire contenant uniquement des images. Le script album et
les autres outils ne doivent pas se trouver dans ce rpertoire. Lancez
la commande album en prcisant ce rpertoire :

<code>% album /exemple/chemin/vers/les/images</code>

Ou, si vous tes dj dans le rpertoire exemple/chemin/vers/les/images :

<code>% album images/</code>

Quand l'opration est termine, vous aurez un album photo  l'intrieur
de ce rpertoire avec comme fichier d'entre index.html.

Si ce chemin fait partie de votre serveur web, alors vous pourrez
visualiser votre album photos  partir de votre navigateur. Si vous
ne le trouvez pas, contactez votre administrateur systme.


ITEM: Options

Il y a trois types d'options: options boolennes (vrai / faux), options
acceptant des chanes de caractres ou des numros et options acceptant
plusieurs arguments. Les options boolennes peuvent tre dsactives en
les prfixant avec -no_ :

<code>% album -no_image_pages</code>

Les chanes de caractres et les nombres sont entrs aprs une option :

<code>% album -type gif
% album -columns 5</code>

Les options acceptant plusieurs arguments peuvent tre utilises de
deux manires. La premire avec un argument  la fois :

<code>% album -exif hi -exif there</code>

ou avec plusieurs arguments en utilisant la syntaxe '--' :

<code>% album --exif hi there --</code>

Vous pouvez supprimer une valeur particulire d'une option  plusieurs
arguments avec -no_&lt;option&gt; suivi du nom de l'argument et effacer
tous les arguments d'une telle option avec -clear_&lt;option&gt;.
Pour effacer tous les arguments d'une option acceptant plusieurs arguments
(provenant par exemple d'une prcdente utilisation de la commande album) :

<code>% album -clear_exif -exif "new exif"</code>

(l'option -clear_exif effacera les anciens arguments de l'option exif puis
l'option -exif suivante permettra d'ajouter un nouveau commentaire dans
la section exif).

Et pour terminer, vous pouvez supprimer un argument particulier d'une option
 plusieurs arguments avec 'no_' :

<code>% album -no_exif hi</code>

supprimera la valeur 'hi' et laissera intacte la valeur 'there' de l'option
exif.


Voir galement la section sur <a href='Section_4.html#Saving_Options'>Sauvegarde des options</a>.

Pour voir une courte page d'aide :

<code>% album -h</code>

Pour voir davantage d'options :

<code>% album -more</code>

Et pour avoir encore plus d'options :

<code>% album -usage=2</code>

Vous pouvez spcifier un nombre plus grand que 2 pour voir encore davantage
d'options (jusqu' 100).

Les modules de plug-in peuvent aussi <a
href="Section_7.html#Plugin_Options">disposer d'options</a> pour leur propre
usage.


ITEM: Thmes

Les thmes sont une composante essentielle qui rend album attrayant. Vous
pouvez particulariser le look de votre album photo en tlchargeant un
thme depuis le site MarginalHacks ou mme crire votre propre thme en
phase avec votre site web.

Pour utiliser un thme, tlchargez l'archive correspondante du thme au
format .tar ou .zip et installez-l.

Les thmes sont spcifis grce  l'option -theme_path qui permet d'indiquer
les endroits o sont stockes les thmes. Ces chemins sont ncessairement
quelque part sous la racine du rpertoire de votre site web mais pas 
l'intrieur mme de votre album photo. De plus, ces chemins doivent tre
accessible depuis un navigateur.

Vous pouvez rajouter un thme dans l'un des chemins spcifi par l'option
theme_path et utilis par album ou crer un nouveau thme et indiquer son
chemin d'accs avec cette option (le rpertoire indiqu par l'option
-theme_path est celui o se trouve le thme et pas le rpertoire du thme
lui-mme).

Par la suite, appelez album avec l'option -theme accompagne ou non de
-theme_path:

<code>% album -theme Dominatrix6 mes_photos/
% album -theme Dominatrix6 -theme_path /home/httpd/album/Themes/ mes_photos/
</code>

Vous pouvez galement crer vos propres thmes trs facilement. Ce sujet est
abord un peu plus loin dans cette documentation.


ITEM: Sous-albums

Crez des rpertoires dans votre rpertoire cr prcedemment et mettez-y
des images. Lancez une nouvell fois album : vos sous-rpertoires seront
explors et donneront naissance  des sous-albums du premier album.

Si vous apportez des modifications dans un seul sous-album, vous pouvez
excuter album uniquement sur ce sous-album ; les liens avec l'album
parent seront conservs.

Si vous ne souhaitez pas descendre dans l'arborescence des rpertoires,
vous pouvez limiter la profondeur du niveau d'exploration avec l'option
-depth. Exemple :

<code>% album images/ -depth 1</code>

Cette commande ne gnrera qu'un album photo pour les images du
rpertoire courant.

Si vous avez plusieurs sous-albums et que vous voulez ajouter un nouveau
sous-album sans regnrer les autres, alors utilisez l'option -add :

<code>% album -add images/nouvel_album/</code>

Ceci ajoutera nouvel_album  la page HTML pour 'images/' et crera
ensuite les vignettes et les pages HTML pour toutes les donnes contenues
dans 'images/nouvel_album'.


ITEM: Eviter la regnration des vignettes

album essaie d'viter au maximum le travail inutile. Il ne cre seulement
des vignettes que si elles n'existent pas et n'ont pas t modifies. Ceci
permet d'acclrer les traitements successifs d'album.

Cependant, cela peut provoquer un problme si vous changez la taille ou
recadrez vos vignettes car album ne ralisera pas que ces dernires ont
changes. Pour forcer la regnration des vignettes, utilisez l'option
-force :

<code>% album -force images/</code>

Mais vous ne devriez pas avoir besoin d'utiliser l'option -force  chaque
fois.


ITEM: Nettoyer les vignettes

Si vous supprimez une image de votre album, alors vous laisserez des
vignettes et des pages HTML. Pour les supprimer, lancer album avec
l'option -clean :

<code>% album -clean images/</code>


ITEM: Taille d'images moyenne

Quand vous cliquez sur la vignette d'un album, vous tes dirigs vers
une page spcifique  cette image. Par dfaut, cette page affiche l'image
en taille relle ainsi que les boutons de navigation, les lgendes et
tout le toutim. Quand vous cliquez sur l'image de cette page, l'URL
pointe alors uniquement sur l'image en taille relle.

Si vous voulez avoir une image de taille rduite sur la page affichant
cette image, utilisez l'option -medium en prcisant la gomtrie que vous
souhaitez obtenir. Vous pouvez utiliser toutes les gomtries supportes
par ImageMagick (voir la page man de cet outil pour de plus amples dtails).
Par exemple :

# Une image faisant la moiti de la taille relle
<code>% album -medium 50%</code>

# Une image qui s'insre dans 640x480 (taille maximale)
<code>% album -medium 640x480</code>

# Une image qui est rduite pour s'insrer dans 640x480
# (mais qui ne sera pas largie si elle est dj plus petite que 640x480)
<code>% album -medium '640x480>'</code>

Les caractres de 'quotation' du dernier exemple seront obligatoires sur
la plupart des systmes  cause de la prsence du caractre '>'.


ITEM: Lgendes

Les images et les vignettes peuvent avoir des noms et des lgendes. Il y a
plusieurs moyens de prciser / changer les noms et les lgendes dans vos
albums photo.


<img src='../Pics/Caption.gif' alt='exemple de lgende align='left'>Le nom est
li  l'image ou  la page qui l'hberge et la lgende suit juste en dessous.

Le nom par dfaut est le fichier nettoy :

The default name is the filename cleaned up:
  "Kodi_Cow.gif"  =>  "Kodi Cow"

Un moyen de prciser une lgende est d'utiliser un fichier texte avec le
mme nom que l'image mais l'extension .txt. Par exemple,
"Kodi_Cow.txt" pourrait contenir <tt>"Kodi takes down a cow!</tt> ("Kodi
matrise une vache !")

Vous pouvez renommer vos images et spcifier toutes les lgendes d'un
rpertoire avec un fichier <i>captions.txt</i>.

Chaque ligne du fichier doit tre le nom d'une image <b>ou d'un
rpertoire</b>, suivi par <b>une tabulation</b>, suivi par le nouveau
nom. Vous pouvez aussi spcifier (spar par une tabulation), une lgende
optionnelle puis un tag ALT, optionnel galement, pour l'image. Pour sauter
un champ, utilisez 'tabulation' 'espace' 'tabulation'.

Exemple :
<tt>001.gif	Ma premire photo
002.gif		Maman et Papa dans le grand canyon
003.gif		Ani DiFranco  ma fiance    Whaou !</tt>

Les images et les rpertoires sont lists dans l'ordre dans lequel ils
sont trouvs dans le fichier de lgende. Vous pouvez modifier ce tri avec
les options '-sort date' et '-sort name'.

Si votre diteur de texte ne gre pas trs bien les tabulations, vous
pouvez sparer les champs par un double deux-points mais .b/seulement</b>
si votre lgende ne contient aucune tabulation :

<tt>003.gif :: Ani DiFranco :: Ma fiance :: Whaou !</tt>

Si vous ne souhaitez avoir des lgendes que sur les pages contenant les
images (et pas sur les pages affichant les albums), utilisez :

<code>% album -no_album_captions</code>

Si vous voulez crer ou diter vos lgendes depuis un accs web, regardez
le script CGI <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/caption_edit'>caption_edit.cgi</a> (mais soyez sr de limiter l'accs  ce
script sinon n'importe qui pourra modifier vos lgendes).


ITEM: Lgendes EXIF

Vous pouvez galement prciser des lgendes extraites des informations
EXIF (Exchangeable Image File Format) ajoutes aux images par la plupart
des appareils photo numriques.

Mais tout d'abord, vous avez besoin d'installer 'jhead'. Vous pouvez,
par exemple, lancer jhead sur un fichier au format jpeg (.jpg ou .jpeg)
et ainsi voir les commentaires et informations affichs.

Les lgendes EXIF sont ajouts  la suite des lgendes normales et sont
spcifis  l'aide de l'option -exif :

<code>% album -exif "&lt;br&gt;Fichier: %File name% pris avec %Camera make%"</code>

Tous les %tags% trouvs seront remplaces par les informations EXIF
correspondantes. Si des %tags% ne sont pas trouvs dans les informations
EXIF, alors la lgende EXIF est ignore. A cause de ce comportement, vous
pouvez multiplier les arguments passs  l'option -exif :

<code>% album -exif "&lt;br&gt;Fichier: %File name% " -exif "pris %Camera make%"</code>

De la sorte, si le tag 'Camera make' n'est pas trouv, vous pourrez toujours
avoir la lgende relative au tag 'File name'.

De la mme faon que pour toutes les options acceptant plusieurs arguments,
vous pouvez utiliser la syntaxe --exif :

<code>% album --exif "&lt;br&gt;Fichier: %File name% " "pris avec %Camera make%" --</code>

Comme montr dans l'exemple, il est possible d'inclure des balises HTML dans
vos lgendes EXIF :

<code>% album -exif "&lt;br&gt;<font size='-1'>Ouverture: %Aperture%</font>"</code>

Afin de voir la liste des tags EXIF possible (Rsolution, Date / Heure,
Ouverture, etc...), utilisez un programme comme 'jhead' sur une image issue
d'un appareil photo numrique.

Vous pouvez galement prciser des lgendes EXIF uniquement pour les albums
ou les pages affichant une image. Voir les options -exif_album et
-exif_image.


ITEM: En-ttes et pieds-de-page

Dans chaque rpertoire abritant un album, vous pouvez avoir des fichiers texte
<tt>header.txt</tt> and <tt>footer.txt</tt>.
Ces fichiers seront copis tels quels dans l'en-tte et le pied-de-page
de votre album (si cette fonctionnalit est supporte par votre thme).


ITEM: Masquer des Fichiers / des Rpertoires

Chaque fichier non reconnu par album comme tant une image est ignor.
Pour afficher ces fichiers, utilisez l'option -no_known_images (l'option
par dfaut est -known_images).

Vous pouvez marquer une image comme n'tant pas une image en ditant un
fichier vide avec le mme et l'extension <tt>.not_img</tt> ajoute  la fin.

Vous pouvez ignorer compltement un fichier en crant un fichier vide avec
le mme nom et l'extension <tt>.hide_album</tt> ajoute  la fin.

Vous pouvez viter de parcourir un rpertoire complet (bien qu'tant
toujours inclus dans la liste de vos rpertoires) en crant un fichier
<tt>&lt;dir&gt;/.no_album</tt>.

Vous pouvez ignorer compltement des rpertoires crant un fichier
<tt>&lt;dir&gt;/.hide_album</tt>

La version pour Windows d'album n'utilise pas le . pour <tt>no_album</tt>,
<tt>hide_album</tt> et <tt>not_img</tt> car il est difficile de crer des
<tt>.fichiers</tt> dans Windows.


ITEM: Recadrer les images

Si vos images comportent un large ventail de ratios (c'est--dire autres
que les traditionnels ratios portrait / paysage) ou si votre thme ne
supporte qu'une seule orientation, alors vos vignettes peuvent tre
recadres afin qu'elles partagent toutes la mme gomtrie :

<code>% album -crop</code>

Le recadrage par dfaut est de recadrer l'image au centre. Si vous n'aimez
pas le recadrage central utilis par album pour gnrer les vignettes, vous
pouvez donner des directives  album afin de spcifier o recadrer des
images spcifiques. Pour cela, il suffit de changer le nom du fichier
contenant l'image pour qu'il ait la directive de recadrage juste avant
l'extension. Vous pouvez ainsi demander  album de recadrer l'image en haut,
en bas,  droite ou  gauche. Par exemple, supposons que nous ayons un
portrait "Kodi.gif" que vous voulez recadrer au sommet de votre vignette.
Renommez le fichier en "Kodi.CROPtop.gif" et c'est tout (vous pouvez
venutellement utiliser l'option -clean pour supprimer l'ancienne
vignette). La chane de caractres prcisant le recadrage sera supprime
du nom affich dans votre navigateur.

La gomtrie par dfaut est 133x133. De cette faon, les images en position
paysage auront des vignettes au format 133x100 et les images en position
portrait auront des vignettes au format 100x133. Si vous utilisez le
recadrage et souhaitez que vos vignettes aient toujours le mme ratio que
les photos numriques; alors essayez 133x100 :

<code>% album -crop -geometry 133x100</code>

Souvenez-vous que si vous recadrez ou changez la gomtrie d'un album
prcdemment gnr, vous devrez utiliser l'option -force une fois afin
de regnrer compltement toutes vos vignettes.


ITEM: Film vido

album peut gnrer des vignettes issues de prise instantane pour de
nombreux formats vido si vous installez <a href='http://MarginalHacks.com/redir.cgi?ffmpeg.org/'>ffmpeg</a>.

Si vous tes sur un systme linux sur une architecture x86, vous n'avez qu'
tlcharger le <a href='/bin/ffmpeg'>fichier excutable</a>, ou autrement, tlcharger le
paquetage complet depuis <a href='http://MarginalHacks.com/redir.cgi?ffmpeg.org/'>ffmpeg.org</a> (c'est trs facile d'installation).


ITEM: Graver des CDs (en utilisant file://)

Si vous utilisez album pour graver des CDs ou si vous souhaitez accder
 vos albums depuis votre navigateur avec le protocole file://, alors
vous ne voulez pas qu'album suppose que le fichier "index.html" soit
la page principale puisque votre navigateur ne le saura probablement pas.
De plus, si vous utilisez des thmes, vous <b>devez</b> utiliser des
chemins d'accs relatifs. Vous ne pouvez pas utiliser l'option
-theme_url car vous ne savez pas o sera l'URL final. Sur Windows, le
chemin d'accs aux thmes pourrait tre "C:/Themes" ou sous UNIX ou OSX,
il pourrait tre quelque chose comme "/mnt/cd/Themes", tout dpendant
de la faon dont le CD a t mont.
Pour rsoudre ces cas de figure, utilisez l'option -burn :

  % album -burn ...

Ceci implique que les chemins d'accs de l'album vers les thmes ne
change pas. Le meilleur moyen de faire ceci consiste  prendre le
rpertoire racine que vous allez graver et d'y mettre vos thmes et votre
album puis de spcifier le chemin complet vers le thme. Par exemple,
crez les rpertoires :

  monISO/Photos/
  monISO/Themes/Blue

Puis vous lancez :

  % album -burn -theme monISO/Themes/Blue monISO/Photos

Ensuite, vous pouvez crer une image ISO depuis le rpertoire mon ISO (ou
plus haut).

Les utilisateurs Windows peuvent galement jeter un oeil sur <a href='http://MarginalHacks.com/redir.cgi?www.squirrel.nl/people/jvromans/software/sw_shellrun.html'>shellrun</a>
qui permet de lancer automatiquement l'album dans le navigateur. (Ou
voyez aussi <a href='http://MarginalHacks.com/redir.cgi?duckware.com/winopen/'>winopen</a>).


ITEM: Indexer entirement votre album

Pour naviguer sur un album entirement compris sur une page, utilisez l'outil
<a href='http://MarginalHacks.com/Hacks/album/tools/caption_index'>caption_index</a>.
Il utilise les mmes options qu'album (bien qu'il en ignore la plupart) de
telle sorte que vous pouvez remplacer l'appel  "album" par "caption_index".

La sortie est la page HTML de l'index de l'album complet.

Regardez <a href='http://DavePics.com/Examples/Blue_Index.html'>l'index d'exemple</a> ralis  partir d'un de mes <a href='http://DavePics.com/Examples/Blue.html'>albums photo d'exemple</a>


ITEM: Mettre  jour des albums avec CGI

Premirement, vous avez besoin de charger vos photos dans le rpertoire
de l'album. Je vous suggre d'utiliser ftp pour faire cette manipulation.
Vous pouvez aussi crire un script java qui chargerait les fichiers. Si
quelqu'un pouvait me montrer comment faire, j'apprcierais beaucoup.


Ensuite, vous avez besoin de pouvoir excuter album  distance. Pour viter
les abus, je vous conseille de mettre en place un script CGI qui cre
un fichier bidon (ou qui transfre ce fichier via ftp) et d'avoir un
cron job (process tournant en arrire plan) qui teste rgulirement
 quelques minutes d'intervalle si ce fichier est prsent et, s'il l'est,
de le supprimer et de lancer album. Cette mthode ne fonctionne que sous
unix et vous aurez srement besoin de modifier votre variable
d'environnement $PATH ou d'utiliser des chemins absolus dans le script
pour la conversion).

Si vous souhaitez une gratification immdiate, vous pouvez lancer album
depuis un script CGI comme <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/run_album'>celui-ci.</a>

Si l'utilisateur du serveur web n'est pas le propritaire des photos, vous
aurez besoin d'utiliser un script setuid via CGI [toujours pour unix
seulement].
Mettez ce script setuid dans un emplacement protg, changez son propritaire
pour qu'il soit le mme que celui de vos photos et lancez la commande
"chmod ug+s" sur le script. Vous trouverez ici des exemples de scripts
<a href='http://MarginalHacks.com/Hacks/album/tools/cgi/run_setuid_album'>setui</a> et <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/setuid_album'>CGI</a>.  N'oubliez pas de les diter.

Regardez galement <a
href='http://MarginalHacks.com/Hacks/album/tools/cgi/caption_edit'>caption_edit.cgi</a>
qui vous permet (ou une autre personne) d'diter les lgendes / noms /
en-ttes / pieds-de-pages  travers le web.

ITEM: Traduit par:

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