Mercurial > bins

view doc/intro.html @ 6:3021deef1599

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><meta name="generator" content="Website XSL Stylesheet V2.2
"><link rel="home" href="index.html" title="BINS Photo Album"><link rel="up" href="index.html" title="BINS Photo Album"><link rel="previous" href="index.html" title="BINS Photo Album"><link rel="next" href="examples.html" title="Examples"><link rel="last" href="license.html" title="License"><link rel="stylesheet" href="example.css" type="text/css">
    <title>Introduction</title>
    <meta name="keyword" content="SAUTRET, BINS, album, gallery, photos, EXIF">
  </head><body class="tabular" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="intro" class="webpage"><a name="intro"></a><table border="0" cellpadding="0" cellspacing="0" width="100%" summary="Navigation"><tr><td valign="top" align="left" bgcolor="#4080FF" width="220"><p class="navtoc"><a href="index.html"><img align="left" border="0" src="graphics/banner.png" alt="Banner"></a><br clear="all"><br><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="intro.html"><img src="graphics/navicons/triangle/current/leaf.gif" alt="+" border="0"></a><span class="curpage">Introduction?<img src="graphics/navicons/triangle/current/pointer.gif" alt="&lt;-"></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="examples.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="examples.html">Examples</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="faq.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="faq.html">FAQ</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="download.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="download.html">Download</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="install.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="install.html">Installation</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="usage_album.html"><img src="graphics/navicons/triangle/other/closed.gif" alt="?" border="0"></a><span class="otherpage"><a href="usage_album.html">Usage</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="contact.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="contact.html">Contact and contribution</a></span><br></span><span class="toplevel"><img src="graphics/blank.gif" alt="???"><a href="license.html"><img src="graphics/navicons/triangle/other/leaf.gif" alt="?" border="0"></a><span class="otherpage"><a href="license.html">License</a></span><br></span><br></p></td><td valign="top" align="left" bgcolor="white"><h1>Introduction</h1><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469589"></a>Features</h2></div></div></div>
    

    <p>The aim of BINS is to generate <span class="bold"><strong>static
    HTML photo albums</strong></span>. Some of the functionalities of BINS
    are?:</p>

    <div class="itemizedlist"><ul type="disc"><li><p> generated album is <span class="bold"><strong>static</strong></span>?: 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.</p></li><li><p> album can contains other albums (<span class="bold"><strong>sub albums</strong></span>): the album can have a tree
      structure?; </p></li><li><p> generation
      of a <span class="bold"><strong>thumbnail</strong></span> and of <span class="bold"><strong>scaled images</strong></span> for each picture?;
      </p></li><li><p> generated album appearance
      is <span class="bold"><strong>fully customizable</strong></span> by using
      <span class="bold"><strong>HTML templates</strong></span> (5 different
      templates sets are currently provided) and <span class="bold"><strong>configuration parameters</strong></span>: 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 <span class="bold"><strong>set globally</strong></span> (system wide or per user),
      <span class="bold"><strong>per album</strong></span> or sub album or
      <span class="bold"><strong>per picture</strong></span> (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)?;
      </p></li><li><p> several <span class="bold"><strong>description fields</strong></span> (date, location,
      etc...) can be associated with the pictures (in text or HTML
      format). You can easily add or customize these fields?;
      </p></li><li><p> description fields can be
      set or modified via a <span class="bold"><strong>command line
      interface</strong></span> or a <span class="bold"><strong>GTK+/GNOME-based
      GUI</strong></span>?; </p></li><li><p> A <span class="bold"><strong>search engine</strong></span> is
      included in the album?: you can find some pictures by searching
      keywords in their description fields.</p></li><li><p> Album can be generated from pictures managed by
      <a href="http://www.nother.net/zoph/" target="_top">Zoph</a>. 
      </p></li><li><p> <span class="bold"><strong>speed up</strong></span> album
      browsing by performing a clean up of <span class="acronym">HTML</span>
      code to reduce its size and by <span class="bold"><strong>pre-loading</strong></span> thumbnails in browser cache
      using <span class="emphasis"><em>JavaScript</em></span> code?;
      </p></li><li><p>Exif information and <span class="bold"><strong>Digital
	  camera support</strong></span>?:
	</p><div class="itemizedlist"><ul type="circle"><li><p>
	    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).
	  </p></li><li><p>
	    BINS use the Orientation EXIF tag (which is normally set
	    when you rotate a image on you DigiCam) to
	    <span class="bold"><strong>rotate the picture to correct
	      orientation</strong></span>.
	  </p></li><li><p>
	    For each image, a page provides all information
	    available on the picture and the <span class="bold"><strong>DigiCam
	      settings</strong></span> when the photo was taken.
	  </p></li><li><p>
	    Additional information are provided for <span class="bold"><strong>Canon DigiCams</strong></span>.
	  </p></li><li><p>
	    Tooltips provide information about the meaning of some of
	    the fields.
	  </p></li><li><p>
	    All EXIF information is saved in the XML description file,
	    preventing they disappear when the image is
	    modified?;
	  </p></li></ul></div><p>
      </p></li><li>
	<p>
	<span class="bold"><strong>internationalization</strong></span>
	(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 ?;
	</p>
      </li><li><p>
	  <span class="bold"><strong>customizable charset
	  encoding</strong></span> for HTML generation, including <span class="bold"><strong>UTF-8 (Unicode)</strong></span> support by
	  default. Generation of the Apache
	  <code class="filename">.htaccess</code> file for correct encoding
	  charset in HTTP headers?;
      </p></li><li><p>
	use of <span class="bold"><strong>XML files</strong></span> to save user
	description of pictures and albums/subalbums and Exif data
	from image file?;
      </p></li><li><p>
	handle correctly file and directory names with spaces or
	other odd characters (excepted '/'), and create
	<span class="bold"><strong>valid escaped URLs</strong></span>?;
      </p></li><li><p> generate <span class="bold"><strong>valid
      HTML/XHTML</strong></span> code. The level of HTML depends of the
      style used. Some of the styles are valid, table free
      XHTML.</p></li></ul></div>

  </div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2469935"></a>History</h2></div></div></div>
     
    
    <p>BINS (BINS Is Not SWIGS) is a modified version of <a href="http://sourceforge.net/projects/swigs/" target="_top">SWIGS</a>
    (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.</p>

    <p>See <a href="ChangeLog" target="_top">ChangeLog</a> file for
    differences between SWIGS and BINS and new functionalities of each
    version.</p>
  </div><br></td></tr></table><div class="navfoot"><hr><table width="100%" border="0" summary="Footer navigation"><tr><td width="33%" align="left"><span class="footdate">$Date: 2005/08/21 20:12:33 $</span></td><td width="34%" align="center"><span class="foothome"><a href="index.html">Home</a></span></td><td width="33%" align="right">?</td></tr><tr><td colspan="3" align="right"><span class="footcopy"><span class="copyright">Copyright ? 2001, 2005,  J?r?me SAUTRET. </span></span></td></tr></table></div></div></body></html>