Mercurial > bins
diff doc/intro.xml @ 0:a84c32f131df 1.1.29
Import vendor version
| author | Peter Gervai <grin@grin.hu> |
|---|---|
| date | Wed, 15 Oct 2008 23:28:56 +0200 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/intro.xml Wed Oct 15 23:28:56 2008 +0200 @@ -0,0 +1,165 @@ +<?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>