Mercurial > bins
view doc/intro.xml @ 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
<?xml version="1.0" encoding="LATIN1" ?> <!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN" "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [ <!NOTATION XML SYSTEM "xml"> <!ENTITY intro SYSTEM "intro.xml" NDATA XML> ]> <!-- $Id: intro.xml,v 1.13 2005/08/21 20:12:33 jerome Exp $ --> <webpage id="intro"> <config param="rcsdate" value="$Date: 2005/08/21 20:12:33 $"/> <head> <title>Introduction</title> <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords> </head> <section> <title>Features</title> <para>The aim of BINS is to generate <emphasis role="bold">static HTML photo albums</emphasis>. Some of the functionalities of BINS are :</para> <itemizedlist> <listitem><para> generated album is <emphasis role="bold">static</emphasis> : it's just plain HTML/CSS/Javascript files (Javascript is not mandatory to view the album), no need of any dynamic language (php, asp, etc.) nor database on server side. Album can be burned on CD or DVD.</para></listitem> <listitem><para> album can contains other albums (<emphasis role="bold">sub albums</emphasis>): the album can have a tree structure ; </para></listitem> <listitem><para> generation of a <emphasis role="bold">thumbnail</emphasis> and of <emphasis role="bold">scaled images</emphasis> for each picture ; </para></listitem> <listitem><para> generated album appearance is <emphasis role="bold">fully customizable</emphasis> by using <emphasis role="bold">HTML templates</emphasis> (5 different templates sets are currently provided) and <emphasis role="bold">configuration parameters</emphasis>: colors, number and size of thumbnails per page, number and size of scaled pictures (in pixels or percentage of the original image for the size), fields to display, etc. Those parameters can be <emphasis role="bold">set globally</emphasis> (system wide or per user), <emphasis role="bold">per album</emphasis> or sub album or <emphasis role="bold">per picture</emphasis> (for example, you can change the colors of one sub album or one just one picture page in an album by editing its description file) ; </para></listitem> <listitem><para> several <emphasis role="bold">description fields</emphasis> (date, location, etc...) can be associated with the pictures (in text or HTML format). You can easily add or customize these fields ; </para></listitem> <listitem><para> description fields can be set or modified via a <emphasis role="bold">command line interface</emphasis> or a <emphasis role="bold">GTK+/GNOME-based GUI</emphasis> ; </para></listitem> <listitem><para> A <emphasis role="bold">search engine</emphasis> is included in the album : you can find some pictures by searching keywords in their description fields.</para></listitem> <listitem><para> Album can be generated from pictures managed by <ulink url="http://www.nother.net/zoph/">Zoph</ulink>. </para></listitem> <listitem><para> <emphasis role="bold">speed up</emphasis> album browsing by performing a clean up of <acronym>HTML</acronym> code to reduce its size and by <emphasis role="bold">pre-loading</emphasis> thumbnails in browser cache using <emphasis>JavaScript</emphasis> code ; </para></listitem> <listitem><para>Exif information and <emphasis role="bold">Digital camera support</emphasis>?: <itemizedlist> <listitem><para> use the EXIF data structure found on some image files (usually, those produced by digital cameras) to fill automatically some fields (date and time for example). </para></listitem> <listitem><para> BINS use the Orientation EXIF tag (which is normally set when you rotate a image on you DigiCam) to <emphasis role="bold">rotate the picture to correct orientation</emphasis>. </para></listitem> <listitem><para> For each image, a page provides all information available on the picture and the <emphasis role="bold">DigiCam settings</emphasis> when the photo was taken. </para></listitem> <listitem><para> Additional information are provided for <emphasis role="bold">Canon DigiCams</emphasis>. </para></listitem> <listitem><para> Tooltips provide information about the meaning of some of the fields. </para></listitem> <listitem><para> All EXIF information is saved in the XML description file, preventing they disappear when the image is modified ; </para></listitem> </itemizedlist> </para></listitem> <listitem> <para> <emphasis role="bold">internationalization</emphasis> (generation of album in different languages) using gettext. Current languages supported are Catalan, Dutch, English, Esperanto, Finish, French, German, Hungarian, Italian, Japanese, Polish, Russian, Spanish and Traditional Chinese ; </para> </listitem> <listitem><para> <emphasis role="bold">customizable charset encoding</emphasis> for HTML generation, including <emphasis role="bold">UTF-8 (Unicode)</emphasis> support by default. Generation of the Apache <filename>.htaccess</filename> file for correct encoding charset in HTTP headers ; </para></listitem> <listitem><para> use of <emphasis role="bold">XML files</emphasis> to save user description of pictures and albums/subalbums and Exif data from image file ; </para></listitem> <listitem><para> handle correctly file and directory names with spaces or other odd characters (excepted '/'), and create <emphasis role="bold">valid escaped URLs</emphasis> ; </para></listitem> <listitem><para> generate <emphasis role="bold">valid HTML/XHTML</emphasis> code. The level of HTML depends of the style used. Some of the styles are valid, table free XHTML.</para></listitem> </itemizedlist> </section> <section> <title>History</title> <para>BINS (BINS Is Not SWIGS) is a modified version of <ulink url="http://sourceforge.net/projects/swigs/">SWIGS</ulink> (Structured Web Image Gallery System). I've made these modifications because I need them. I tried to contact SWIGS author, but I've got no response, so I decided to publish my modified version in case someone is interested.</para> <para>See <ulink url="ChangeLog">ChangeLog</ulink> file for differences between SWIGS and BINS and new functionalities of each version.</para> </section> </webpage>