view doc/intro.xml @ 1:178fed916ebe

Added tag 1.1.29 for changeset a84c32f131df
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:29:18 +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&nbsp;:</para>

    <itemizedlist>

      <listitem><para> generated album is <emphasis
      role="bold">static</emphasis>&nbsp;: 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&nbsp;; </para></listitem> 

      <listitem><para> generation
      of a <emphasis role="bold">thumbnail</emphasis> and of <emphasis
      role="bold">scaled images</emphasis> for each picture&nbsp;;
      </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)&nbsp;;
      </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&nbsp;;
      </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>&nbsp;; </para></listitem>

      <listitem><para> A <emphasis role="bold">search engine</emphasis> is
      included in the album&nbsp;: 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&nbsp;;
      </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&nbsp;;
	  </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 &nbsp;;
	</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&nbsp;;
      </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&nbsp;;
      </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>&nbsp;;
      </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>