Mercurial > bins
view doc/index_fr.html @ 6:3021deef1599
Encoding related fixes
* chomp encoding string
* reformat else (seems someone hacked it in)
* debug print encoding
* do not use :utf8 binmode ("re-encode") on written file if the input is _already_ UTF-8
author | Peter Gervai <grin@grin.hu> |
---|---|
date | Thu, 16 Oct 2008 00:02:14 +0200 |
parents | a84c32f131df |
children |
line wrap: on
line source
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>BINS album photo</title> </head> <!--$Id: index_fr.html,v 1.26 2002/06/09 19:47:56 jerome Exp $--> <body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000"> <div align="right"> <a href="index.html"> <img SRC="http://sautret.org/flag_english.gif" ALT="English Version" border="0"></a> </div> <p><b>Attention</b>, cette page n'est ? jour par rapport ? la <a href="index.html">version anglaise.</a></p> <h1>BINS</h1> La page de r?f?rence est <a href="http://bins.sautret.org/">http://bins.sautret.org/</a>. <p>Si vous d?sirez recevoir un mail annon?ant les nouvelles versions, allez sur la <a href="http://freshmeat.net/projects/bins/">page Freshmeat de BINS</a> et cliquez sur <b>Subscribe to new releases</b>. <hr> <h2>Introduction</h2> <p>Le but de BINS est de cr?er des <b>albums photos HTML statiques</b>. Voici quelques unes de fonctionnalit?s de BINS : <ul> <li> un album peut contenir d'autres albums (des <b>sous albums</b>) : l'album peut avoir une structure d'arbre ; </li> <li> g?n?ration d'une image <b>timbre-poste</b> et d'<b>images ? diff?rentes ?chelles</b> pour chaque image originale ; </li> <li> l'album g?n?r? peut ?tre <b>enti?rement personnalis?</b> en utilisant des <b>mod?les HTML</b> 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 <b>globalement</b>, par utilisateur, <b>par album</b>, sous-album ou m?me <b>par image</b> (par exemple, vous pouvez changer les couleurs d'un sous-album ou de la page d'une image particuli?re). ; </li> <li> plusieurs <b>champs de description</b> (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 ; </li> <li> support du format Exif est des <b>appareils photos num?riques</b>?: <ul> <li> 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 <b>remplir automatiquement certains champs</b> (date et heure ou mod?le de l'appareil, par exemple)?; </li> <li> BINS utilise le tag EXIF Orientation (qui normalement utilis? quand vous faites une rotation de photo sur votre appareil num?rique) pour effectuer une <b>rotation de automatique de l'image</b> vers l'orientation correcte. </li> <li>pour chaque image, une page donne toutes les informations disponibles sur ses caract?ristiques et sur les <b>param?tres de l'appareil photo num?rique</b> lors de la prise de vue?; </li> <li>des informations suppl?mentaires sont fournies pour les <b>appareils photos num?riques Canon</b>?; </li> <li>une fen?tre d'aide explique la signification de certaines informations?; </li> <li>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?; </li> </ul> </li> <li> <b>internationalisation</b> (g?n?ration d'album dans diff?rents langages) via gettext. Les langues actuellement support?es sont : anglais, fran?ais, allemand et polonais ; </li> <li> l'<b>encodage du jeu de caract?res</b> des fichiers HTML g?n?r?s est param?trable, avec support par d?faut de <b>l'UTF-8 (Unicode)</b>. Cr?ation du fichier <tt>.htaccess</tt> d'Apache pour l'envoi de l'encodage du jeu de caract?res correct dans l'en-t?te HTTP ; </li> <li> utilisation de <b>fichiers XML</b> pour sauvegarder les descriptions utilisateur des images et des albums/sous-albums ainsi que les donn?es Exif provenant des images ; </li> <li> 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 ; </li> <li> BINS produit du code <b>HTML 4 valide</b>. </li> </ul> <p> BINS (BINS Is Not SWIGS) est une version modifi?e de <a href="http://sourceforge.net/projects/swigs/">SWIGS</a> (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. <p>Voir le fichier <a href="ChangeLog">ChangeLog</a> (en anglais) pour les diff?rences entre BINS et SWIGS ainsi que les nouveaut?s de chaque version. <hr> <h2>Exemple</h2> <p>Vous pouvez voir un exemple d'un album g?n?r? par BINS sur <a href="http://album.sautret.org/">http://album.sautret.org/</a>. Il s'agit de mon album personnel avec l'I18N fran?aise. <hr> <h2>T?l?chargement</h2> <p>La derni?re version de BINS est la 1.1.10.</p> <p>BINS est maintenant dans Sid (version unstable de <a href="http://www.debian.org">Debian</a>). Vous pouvez trouver le paquetage sur la <a href="http://packages.debian.org/unstable/web/bins.html">page Debian de BINS</a>.</p> <p>Un <a href="bins_for_mdk.tar.gz">tarball</a> contenant l'ensemble des biblioth?ques pour faire fonctionner BINS sur une <a href="http://www.linux-mandrake.com/fr/">Mandrake</a> est disponible. Vous aurez quand m?me besoin d'un des tarballs disponibles ci-dessous.</p> <p><b>Attention</b>, 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.</p> <table border="3"> <tr> <td bgcolor="#999999"> <b>format gzip</b> </td> <td bgcolor="999999"> <b>format bzip2</b> </td> </tr> <tr> <td> <b><a href="bins-1.1.10.tar.gz">bins-1.1.10.tar.gz</a></b> </td> <td> <b><a href="bins-1.1.10.tar.bz2">bins-1.1.10.tar.bz2</a></b> </td> </tr> <tr> <td> <a href="bins-1.1.9.tar.gz">bins-1.1.9.tar.gz</a> </td> <td> <a href="bins-1.1.9.tar.bz2">bins-1.1.9.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.8.tar.gz">bins-1.1.8.tar.gz</a> </td> <td> <a href="bins-1.1.8.tar.bz2">bins-1.1.8.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.7.tar.gz">bins-1.1.7.tar.gz</a> </td> <td> <a href="bins-1.1.7.tar.bz2">bins-1.1.7.tar.bz2</a> </td> <tr> <tr> <td> <a href="bins-1.1.6.tar.gz">bins-1.1.6.tar.gz</a> </td> <td> <a href="bins-1.1.6.tar.bz2">bins-1.1.6.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.5.tar.gz">bins-1.1.5.tar.gz</a> </td> <td> <a href="bins-1.1.5.tar.bz2">bins-1.1.5.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.4.tar.gz">bins-1.1.4.tar.gz</a> </td> <td> <a href="bins-1.1.4.tar.bz2">bins-1.1.4.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.3.tar.gz">bins-1.1.3.tar.gz</a> </td> <td> <a href="bins-1.1.3.tar.bz2">bins-1.1.3.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.2.tar.gz">bins-1.1.2.tar.gz</a> </td> <td> <a href="bins-1.1.2.tar.bz2">bins-1.1.2.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.1.tar.gz">bins-1.1.1.tar.gz</a> </td> <td> <a href="bins-1.1.1.tar.bz2">bins-1.1.1.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.1.0.tar.gz">bins-1.1.0.tar.gz</a> </td> <td> <a href="bins-1.1.0.tar.bz2">bins-1.1.0.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.0.4.tar.gz">bins-1.0.4.tar.gz</a> </td> <td> <a href="bins-1.0.4.tar.bz2">bins-1.0.4.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.0.3.tar.gz">bins-1.0.3.tar.gz</a> </td> <td> <a href="bins-1.0.3.tar.bz2">bins-1.0.3.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.0.2.tar.gz">bins-1.0.2.tar.gz</a> </td> <td> <a href="bins-1.0.2.tar.bz2">bins-1.0.2.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.0.1.tar.gz">bins-1.0.1.tar.gz</a> </td> <td> <a href="bins-1.0.1.tar.bz2">bins-1.0.1.tar.bz2</a> </td> </tr> <tr> <td> <a href="bins-1.0.0.tar.gz">bins-1.0.0.tar.gz</a> </td> <td> <a href="bins-1.0.0.tar.bz2">bins-1.0.0.tar.bz2</a> </td> </tr> </table> <!-- <a href="http://kashmir.sautret.org/~jerome/perso/BINS/bins-1.0.1.tar.gz">ici</a>. --> <hr> <h2>Installation</h2> <p>Proc?dure rapide :</p> <ul> <li>v?rifiez que vous avez les logiciels et biblioth?ques n?cessaires</li> <li>d?tarez l'archive</li> <li>lancer le script <tt>install.sh</tt> (en tant que root si vous pouvez)</li> <li>ex?cutez <tt>bins -h</tt> pour obtenir de l'aide, et lisez la section utilisation de ce document</li> </ul> <h3>d?pendances</h3> <p>Vous avez besoin de <a href="http://www.perl.com/CPAN/ports/index.html">Perl</a> pour utiliser BINS, ainsi que des biblioth?ques Perl suivantes (les noms de paquetage Debian et Mandrake sont mentionn?s quand ils sont connus).</p> <p>Ce <a href="bins_for_mdk.tar.gz">tarball</a> regroupe l'ensemble de ces biblioth?ques au format rpm pour <a href="http://www.linux-mandrake.com/fr/">Mandrake</a> ou tar.gz quand aucun rpm n'est disponible (voir ci dessous pour l'installation de biblioth?que Perl ? partir d'un tarball).</p> <table border="3" cellspacing="3"> <tr> <td bgcolor="#BBBBBB"> <b>Biblioth?que Perl</b> </td> <td bgcolor="#BBBBBB"> <b>Paquetage Debian</b> </td> <td bgcolor="#BBBBBB"> <b>Paquetage Mandrake 8.1 & 8.2</b> </td> </tr> <tr> <td> POSIX </td> <td>perl-base</td> <td>perl-base-5.601-7mdk</td> </tr> <tr> <td> IO::File </td> <td>perl-base</td> <td>perl-base-5.601-7mdk</td> </tr> <tr> <td> Getopt::Long </td> <td> perl-base </td> <td>perl-base-5.601-7mdk</td> </tr> <tr> <td> File::Basename </td> <td>perl-modules</td> <td>perl-base-5.601-7mdk</td> </tr> <tr> <td> Storable</td> <td>libstorable-perl</td> <td></td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=IO-String">IO:String</a> </td> <td> libio-string-perl </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=Image-Size">Image::Size</a> </td> <td> libimage-size-perl </td> <td>perl-Image-Size-2.903-5mdk</td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=Image-Info">Image::Info</a> </td> <td> libimage-info-perl</td> <td>perl-Image-Info-1.07-1mdk</td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=PerlMagick">Image::Magick</a> (avec la collection d'outils <a href="http://www.imagemagick.org/">ImageMagick</a>) </td> <td> perlmagick </td> <td>perl-Magick-5.4.2.3-3mdk</td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=HTML-Parser">HTML::Entities</a> </td> <td> libhtml-parser-perl </td> <td> perl-HTML-Parser-3.25-3mdk </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=URI">URI:Escape</a> </td> <td> liburi-perl </td> <td> perl-URI-1.18-1mdk </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=libxml-perl">XML::Parser::PerlSAX</a> </td> <td> libxml-perl </td> <td> perl-libxml-perl-0.07-5mdk </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=XML-Grove">XML::Grove</a> </td> <td> libxml-grove-perl </td> <td> perl-XML-Grove-0.46alpha-2mdk </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=XML-Handler-YAWriter">XML::Handler::YAWriter</a> </td> <td> libxml-handler-yawriter-perl </td> <td> </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=Text-Iconv">Text::Iconv</a> </td> <td> libtext-iconv-perl </td> <td> </td> </tr> <tr> <td> <a href="http://search.cpan.org/search?dist=gettext">Locale::gettext</a> (optionnel si vous ne d?sirez pas avoir d'album dans une autre langue que l'anglais.)</td> <td> liblocale-gettext-perl </td> <td> perl-gettext-1.0-10mdk </td> </tr> </table> <p>R?f?rez-vous ? <a href="http://cpan.org/modules/INSTALL.html">cette page</a> pour savoir comment installer ces biblioth?ques. Vous pouvez trouver l'interp?teur perl et toutes ces biblioth?ques Perl sur <a href="http://www.cpan.org/">CPAN</a>.</p> <p>BINS utilise la collection d'outils <a href="http://www.imagemagick.org/">ImageMagick</a>, 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 <tt>convert</tt> (utilis? pour changer la taille des images) et <tt>mogrify</tt> (utilis? pour faire les rotations d'images).</p> <p>BINS peut ?galement utiliser <tt>jpegtran</tt> pour effectuer les rotations des JPEG. S'il ne le trouve pas, il utilisera <tt>mogrify</tt> (d'ImageMagick) ? la place. Le programme <tt>jpegtran</tt> peut effectuer des transformations sans perte et il est plus rapide que <tt>mogrify</tt>. Il peut ?tre trouv? dans le paquetage Debian <tt>libjpeg-progs</tt> ou dans le tarball <tt>jpegsrc</tt> accessible sur ce <a href="ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz">site FTP</a>.</p> <h3>Installation automatique de BINS</h3> <p>Une fois toutes les d?pendances remplies, il faut extraire l'archive dans un r?pertoire de votre choix.</p> <p>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.</p> <p>pour installer BINS globalement, lancer le scipt <tt>install.sh</tt> en tant que root. Cela installera les programmes dans <tt>/usr/local/bin</tt>, les fichiers d'internationalisation dans <tt>/usr/local/share/locale</tt> et les fichiers de configuration dans <tt>/etc/bins</tt>. Si vous voulez changer la configuration pour un seul utilisateur, vous pouvez toujours copier le contenu de <tt>/etc/bins</tt> dans <tt>~/.bins</tt> et ensuite ?diter les fichiers dans <tt>~/.bins</tt>.</p> <p>Pour installer BINS pour un seul utilisateur, lancer le script <tt>install.sh</tt> avec cet utilisateur. Cela installera les programmes dans <tt>~/bin</tt> les fichiers de configuration dans <tt>~/.bins</tt>. 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 <tt>/usr/local/share/locale</tt>.</p> <h3>Installation manuelle de BINS</h3> <p>Si vous ne faites pas confiance au script <tt>install.sh</tt>, vous pouvez effectuer l'installation manuellement.</p> <p>Copiez les fichiers <tt>bins</tt> et <tt>bins_edit</tt> quelque part dans votre PATH (<tt>/usr/local/bin</tt> est appropri? ou <tt>~/bin</tt> si vous n'?tes pas root). Ensuite copiez le contenu du r?pertoire template dans <tt>/etc/bins</tt> ou <tt>~/.bins</tt> :</p> <tt> <br>$ cp bins bins_edit ~/bin <br>$ mkdir ~/.bins <br>$ cp templates/* ~/.bins </tt> <p>Si vous voulez utiliser l'I18N (traduction de l'album):</p> <tt> <br>$ mkdir -p /usr/local/share/locale/fr/LC_MESSAGES/ <br>$ cd intl <br>$ cp fr.mo /usr/local/share/locale/fr/LC_MESSAGES/bins.mo </tt> <p> l'exemple donn? est pour les traduction en fran?ais. </p> <p>Notez que seul l'album est traduit, les messages fournis sur la ligne de commande sont en anglais</p> <hr> <h2>Utilisation</h2> <p>Mettez toutes vos images dans un r?pertoire, disons <tt>~/image</tt>. 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 <tt>~/album</tt> : <br><tt> $ mkdir ~/album </tt> <p>Allez au niveau sup?rieur de ces r?pertoires : <br><tt> $ cd ~ </tt> <p>Et lancez bins avec les deux r?pertoires en param?tre (source et destination) : <br><tt> $ bins images album </tt> <p>Cela va cr?er un album HTML, avec des ?ventuels sous-albums, des images timbre-poste et des images ? l'?chelle. <p>bins poss?de des options de ligne de commande. Tapez : <br><tt> $ bins -h </tt> <p>Pour les voir. Jetez un oeil au README original de SWIGS pour en apprendre plus. <p>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 : <br><tt> $ bins_edit -d "my picture" img.jpg </tt> <p>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 <tt>--html</tt>. Vous pouvez lancez bins_edit sur plusieurs images, par exemple : <br><tt> $ bins_edit -l "Paris" -y "2001" *.jpg </tt> <p><tt>bins_edit</tt> 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.</p> <p>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 <tt>--album</tt>. Tapez <tt>bins_edit --help</tt> pour plus d'information.</p> <p>Vous pouvez personnaliser bins en ?ditant les valeurs des param?tres du fichier de configuration <tt>binsrc</tt>. 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 <tt>/etc/bins</tt> vers <tt>~/.bins</tt> et ensuite l'?diter <tt>~/.bins</tt> si vous ne voulez pas changer la configuration globale. Lisez les commentaires dans ce fichier pour plus d'informations.</p> <p>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.</p> <p>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 <tt>-t</tt>, puis dans <tt>~/.bins</tt> et enfin dans <tt>/etc/bins</tt>.</p> <h2>Licence</h2> <p>BINS est un logiciel libre, sous la <a href="http://www.gnu.org/home.fr.html">GNU</a> <a href="http://www.gnu.org/copyleft/gpl.html">GPL</a>. <p>BINS est Copyright © 2001,2002 J?r?me Sautret (Jerome @ Sautret.org). <p>Code original de SWIGS est Copyright © 2000 Brendan McMahan (mcmahahb @ whitman.edu). <p>Code initial bas? sur IDS 0.21 est Copyright © John Moose (moosejc @ muohio.edu). <p> <a href="http://petition.eurolinux.org"> <img src="http://aful.org/images/patent_button.gif" alt="Software Patent Free Europe" align="left" border="0"> </a> <a href="http://validator.w3.org/check/referer"><img border="0" src="http://www.w3.org/Icons/valid-html401" align="right" alt="Valid HTML 4.01!" height="31" width="88"></a> </p> <hr> <address><a href="http://Sautret.org/">J?r?me SAUTRET</a></address> <!-- Created: Fri Nov 9 22:23:18 CET 2001 --> <!-- hhmts start --> Last modified: Sun Jun 9 21:47:09 CEST 2002 <!-- hhmts end --> <!-- for logging & anti-spam purpose (see http://kb.babel.net/ for GERM goal and usage) --> <a href="http://kb.babel.net/xq/germ"> <img src="http://log.sautret.org/~jerome/log/./BINS/index_fr.html.jpg" border="0" alt=""> </a> </body> </html> <!-- LocalWords: BINS HTML EXIF SWIGS Magick T?l?chargement t?l?charg?e PATH --> <!-- LocalWords: root bins template README Freshmeat templates sous-album -->