Attention, cette page n'est � jour par rapport � la version anglaise.

BINS

La page de r�f�rence est http://bins.sautret.org/.

Si vous d�sirez recevoir un mail annon�ant les nouvelles versions, allez sur la page Freshmeat de BINS et cliquez sur Subscribe to new releases.

Introduction

Le but de BINS est de cr�er des albums photos HTML statiques. Voici quelques unes de fonctionnalit�s de BINS :

un album peut contenir d'autres albums (des sous albums) : l'album peut avoir une structure d'arbre ;
g�n�ration d'une image timbre-poste et d'images � diff�rentes �chelles pour chaque image originale ;
l'album g�n�r� peut �tre enti�rement personnalis� en utilisant des mod�les HTML et via des param�tres de configuration qui permettent de modifier�: les couleurs, la taille et le nombre des timbres-poste, le nombre et la taille de chaque image � l'�chelle (en pixel ou en pourcentage de l'image originale pour la taille), les champs � afficher, etc. Ces param�tres peuvent �tre chang�s globalement, par utilisateur, par album, sous-album ou m�me par image (par exemple, vous pouvez changer les couleurs d'un sous-album ou de la page d'une image particuli�re). ;
plusieurs champs de description (date, lieu, etc.) peuvent �tre associ�s avec l'image. Ces descriptions peuvent �tre auformat texte ou HTML. Il est possible de personnaliser ou d'ajouter des champs. Ces donn�es sont sauvegard�es dans des fichiers XML propres � chaque image ;
support du format Exif est des appareils photos num�riques�:
- BINS peut utiliser la structure de donn�es EXIF que l'on trouve dans certaines images (notamment dans celles g�n�r�es par les appareils photos num�riques) pour remplir automatiquement certains champs (date et heure ou mod�le de l'appareil, par exemple)�;
- BINS utilise le tag EXIF Orientation (qui normalement utilis� quand vous faites une rotation de photo sur votre appareil num�rique) pour effectuer une rotation de automatique de l'image vers l'orientation correcte.
- pour chaque image, une page donne toutes les informations disponibles sur ses caract�ristiques et sur les param�tres de l'appareil photo num�rique lors de la prise de vue�;
- des informations suppl�mentaires sont fournies pour les appareils photos num�riques Canon�;
- une fen�tre d'aide explique la signification de certaines informations�;
- toutes les informations en provenance du fichier Exif sont sauvegard�es dans les fichiers de description XML, �vitant ainsi qu'ils disparaissent lors de modification de l'image�;
internationalisation (g�n�ration d'album dans diff�rents langages) via gettext. Les langues actuellement support�es sont : anglais, fran�ais, allemand et polonais ;
l'encodage du jeu de caract�res des fichiers HTML g�n�r�s est param�trable, avec support par d�faut de l'UTF-8 (Unicode). Cr�ation du fichier .htaccess d'Apache pour l'envoi de l'encodage du jeu de caract�res correct dans l'en-t�te HTTP ;
utilisation de fichiers XML pour sauvegarder les descriptions utilisateur des images et des albums/sous-albums ainsi que les donn�es Exif provenant des images ;
les noms de fichiers et de r�pertoires contenant des espaces et autres caract�res sp�ciaux (sauf /) sont g�r�s et des URL valides sont cr��s ;
BINS produit du code HTML 4 valide.

BINS (BINS Is Not SWIGS) est une version modifi�e de SWIGS (Structured Web Image Gallery System). J'ai fais ces modifications parce que j'en avais besoin. J'ai essay� de contacter l'auteur de SWIGS, mais je n'ai eu aucune r�ponse, c'est pourquoi j'ai d�cid� de publier ma version modifi�e, au cas o� elle int�resse quelqu'un.

Voir le fichier ChangeLog (en anglais) pour les diff�rences entre BINS et SWIGS ainsi que les nouveaut�s de chaque version.

Exemple

Vous pouvez voir un exemple d'un album g�n�r� par BINS sur http://album.sautret.org/. Il s'agit de mon album personnel avec l'I18N fran�aise.

T�l�chargement

La derni�re version de BINS est la 1.1.10.

BINS est maintenant dans Sid (version unstable de Debian). Vous pouvez trouver le paquetage sur la page Debian de BINS.

Un tarball contenant l'ensemble des biblioth�ques pour faire fonctionner BINS sur une Mandrake est disponible. Vous aurez quand m�me besoin d'un des tarballs disponibles ci-dessous.

Attention, le format des fichiers de description des images et des albums a chang� dans la version 1.1.0. Lisez le fichier README pour savoir comment migrer vos anciens fichiers de description.

format gzip	format bzip2
bins-1.1.10.tar.gz	bins-1.1.10.tar.bz2
bins-1.1.9.tar.gz	bins-1.1.9.tar.bz2
bins-1.1.8.tar.gz	bins-1.1.8.tar.bz2
bins-1.1.7.tar.gz	bins-1.1.7.tar.bz2
bins-1.1.6.tar.gz	bins-1.1.6.tar.bz2
bins-1.1.5.tar.gz	bins-1.1.5.tar.bz2
bins-1.1.4.tar.gz	bins-1.1.4.tar.bz2
bins-1.1.3.tar.gz	bins-1.1.3.tar.bz2
bins-1.1.2.tar.gz	bins-1.1.2.tar.bz2
bins-1.1.1.tar.gz	bins-1.1.1.tar.bz2
bins-1.1.0.tar.gz	bins-1.1.0.tar.bz2
bins-1.0.4.tar.gz	bins-1.0.4.tar.bz2
bins-1.0.3.tar.gz	bins-1.0.3.tar.bz2
bins-1.0.2.tar.gz	bins-1.0.2.tar.bz2
bins-1.0.1.tar.gz	bins-1.0.1.tar.bz2
bins-1.0.0.tar.gz	bins-1.0.0.tar.bz2

Installation

Proc�dure rapide :

v�rifiez que vous avez les logiciels et biblioth�ques n�cessaires
d�tarez l'archive
lancer le script install.sh (en tant que root si vous pouvez)
ex�cutez bins -h pour obtenir de l'aide, et lisez la section utilisation de ce document

d�pendances

Vous avez besoin de Perl pour utiliser BINS, ainsi que des biblioth�ques Perl suivantes (les noms de paquetage Debian et Mandrake sont mentionn�s quand ils sont connus).

Ce tarball regroupe l'ensemble de ces biblioth�ques au format rpm pour Mandrake ou tar.gz quand aucun rpm n'est disponible (voir ci dessous pour l'installation de biblioth�que Perl � partir d'un tarball).

Biblioth�que Perl	Paquetage Debian	Paquetage Mandrake 8.1 & 8.2
POSIX	perl-base	perl-base-5.601-7mdk
IO::File	perl-base	perl-base-5.601-7mdk
Getopt::Long	perl-base	perl-base-5.601-7mdk
File::Basename	perl-modules	perl-base-5.601-7mdk
Storable	libstorable-perl
IO:String	libio-string-perl
Image::Size	libimage-size-perl	perl-Image-Size-2.903-5mdk
Image::Info	libimage-info-perl	perl-Image-Info-1.07-1mdk
Image::Magick (avec la collection d'outils ImageMagick)	perlmagick	perl-Magick-5.4.2.3-3mdk
HTML::Entities	libhtml-parser-perl	perl-HTML-Parser-3.25-3mdk
URI:Escape	liburi-perl	perl-URI-1.18-1mdk
XML::Parser::PerlSAX	libxml-perl	perl-libxml-perl-0.07-5mdk
XML::Grove	libxml-grove-perl	perl-XML-Grove-0.46alpha-2mdk
XML::Handler::YAWriter	libxml-handler-yawriter-perl
Text::Iconv	libtext-iconv-perl
Locale::gettext (optionnel si vous ne d�sirez pas avoir d'album dans une autre langue que l'anglais.)	liblocale-gettext-perl	perl-gettext-1.0-10mdk

R�f�rez-vous � cette page pour savoir comment installer ces biblioth�ques. Vous pouvez trouver l'interp�teur perl et toutes ces biblioth�ques Perl sur CPAN.

BINS utilise la collection d'outils ImageMagick, qui est probablement d�j� utilis�e si vous utilisez une des distributions GNU/Linux communes. Pour vous en assurer, v�rifier que vous avez les programmes convert (utilis� pour changer la taille des images) et mogrify (utilis� pour faire les rotations d'images).

BINS peut �galement utiliser jpegtran pour effectuer les rotations des JPEG. S'il ne le trouve pas, il utilisera mogrify (d'ImageMagick) � la place. Le programme jpegtran peut effectuer des transformations sans perte et il est plus rapide que mogrify. Il peut �tre trouv� dans le paquetage Debian libjpeg-progs ou dans le tarball jpegsrc accessible sur ce site FTP.

Installation automatique de BINS

Une fois toutes les d�pendances remplies, il faut extraire l'archive dans un r�pertoire de votre choix.

Vous pouvez installer BINS globalement ou pour un utilisateur. Attention, cette proc�dure va �craser les anciens programmes, fichiers de configuration et templates HTML. Fa�tes une sauvegarde si vous les avez modifi�s.

pour installer BINS globalement, lancer le scipt install.sh en tant que root. Cela installera les programmes dans /usr/local/bin, les fichiers d'internationalisation dans /usr/local/share/locale et les fichiers de configuration dans /etc/bins. Si vous voulez changer la configuration pour un seul utilisateur, vous pouvez toujours copier le contenu de /etc/bins dans ~/.bins et ensuite �diter les fichiers dans ~/.bins.

Pour installer BINS pour un seul utilisateur, lancer le script install.sh avec cet utilisateur. Cela installera les programmes dans ~/bin les fichiers de configuration dans ~/.bins. Notez que les fichiers d'internationalisation (utilis�s pour cr�er des album dans une langue autre que l'anglais) ne seront PAS copi�s, car ils doivent �tre install�s dans /usr/local/share/locale.

Installation manuelle de BINS

Si vous ne faites pas confiance au script install.sh, vous pouvez effectuer l'installation manuellement.

Copiez les fichiers bins et bins_edit quelque part dans votre PATH (/usr/local/bin est appropri� ou ~/bin si vous n'�tes pas root). Ensuite copiez le contenu du r�pertoire template dans /etc/bins ou ~/.bins :

$ cp bins bins_edit ~/bin $ mkdir ~/.bins $ cp templates/* ~/.bins

Si vous voulez utiliser l'I18N (traduction de l'album):

$ mkdir -p /usr/local/share/locale/fr/LC_MESSAGES/ $ cd intl $ cp fr.mo /usr/local/share/locale/fr/LC_MESSAGES/bins.mo

l'exemple donn� est pour les traduction en fran�ais.

Notez que seul l'album est traduit, les messages fournis sur la ligne de commande sont en anglais

Utilisation

Mettez toutes vos images dans un r�pertoire, disons ~/image. Vos images peuvent �tre rang�es dans des sous r�pertoires de ce r�pertoire. Ensuite, cr�ez un r�pertoire dans lequel l'album sera cr��, au m�me niveau que le pr�c�dent, disons ~/album :
$ mkdir ~/album

Allez au niveau sup�rieur de ces r�pertoires :
$ cd ~

Et lancez bins avec les deux r�pertoires en param�tre (source et destination) :
$ bins images album

Cela va cr�er un album HTML, avec des �ventuels sous-albums, des images timbre-poste et des images � l'�chelle.

bins poss�de des options de ligne de commande. Tapez :
$ bins -h

Pour les voir. Jetez un oeil au README original de SWIGS pour en apprendre plus.

Si vous d�sirez ajouter des commentaires pour les images, vous pouvez utiliser le programme bins_edit. Par exemple, pour ajouter le commentaire � mon image � � img.jpg, rendez-vous dans le r�pertoire des image (l� ou se trouve img.jpg), et tapez :
$ bins_edit -d "my picture" img.jpg

l'option -d indique qu'il s'agit de la description. Vous pouvez ajouter d'autre champs, comme le lieu ou la date. Lancez bins_edit sans arguments pour voir les champs disponibles. Le texte de la description peut �tre en HTML avec l'option --html. Vous pouvez lancez bins_edit sur plusieurs images, par exemple :
$ bins_edit -l "Paris" -y "2001" *.jpg

bins_edit cr�� un fichier .xml pour chaque image. Vous pouvez �diter ce fichier � la main si vous le d�sirer � l'aide d'un �diteur supportant l'Unicode.

Pour chaque album (et sous-album) vous pouvez �galement mettre un titre, une description et choisir une image pour repr�senter l'album. Pour cela, utilisez bins_edit avec l'option --album. Tapez bins_edit --help pour plus d'information.

Vous pouvez personnaliser bins en �ditant les valeurs des param�tres du fichier de configuration binsrc. Un tel fichier est fourni avec BINS. Il se trouve dans /etc/bins si vous avez effectu� l'installation en tant que root, sinon il se trouve dans ~/.bins. Dans le premier cas, vous pouvez le copier de /etc/bins vers ~/.bins et ensuite l'�diter ~/.bins si vous ne voulez pas changer la configuration globale. Lisez les commentaires dans ce fichier pour plus d'informations.

Vous pouvez �galement utiliser ces param�tres (quand cela a un sens) dans la section <bins> des fichiers de description des albums (album.xml) ou des images (fichier_image.jpg.xml par exemple). Vous pouvez ainsi changer les param�tres pour un album particulier (ou un sous-album et ses descendants) ou m�me pour une page d'image.

L'apparence des albums peut aussi �tre chang�e via les templates HTML. BINS recherche ces fichiers d'abord dans le repertoire sp�cifi� par l'option -t, puis dans ~/.bins et enfin dans /etc/bins.

Licence

BINS est un logiciel libre, sous la GNU GPL.

J�r�me SAUTRET

Last modified: Sun Jun 9 21:47:09 CEST 2002