HTML Gallery Program Version 1.0

William Stein

Gallery is a program for creating nice HTML galleries on a UNIX computer with the convert command installed. Here is a small example.

Quick Steps to Create a Gallery

  1. Copy all the images and videos that will be in the gallery into a directory.
  2. Create a file like conf.txt, which includes captions and ratings of the photos and allows you to customize the style of the gallery. (You can skip this step, but your photos will have no caption, and the gallery will have default parameters, e.g., thumbnail sizes, etc.)
  3. Put the directory of images and videos and conf.txt on your web server.
  4. At the command prompt on the web server, type 
           $ cd directory_of_images_and_videos
       $ gallery 0
  5. Now there is an index.html file in the current directory, and web browsers will see this directory as an HTML gallery.
  6. If you don't like the gallery, modify conf.txt to your taste, put the new version on the web server (or modify it on the web server), then rerun "gallery 0". It will run much more quickly after the first run.

More Documentation

Running gallery with no arguments prints the documentation:

$ gallery

****************************************************************************
* HTML Gallery Program Version 1.0                                         *
* Copyright (C) 2005 William Stein                   *
* Distributed under the terms of the GNU General Public License (GPL)      *
****************************************************************************

Usage: gallery min_rating [+keyword] [-keyword] ...

---------------------------------------------------------------------------
 Create an HTML gallery of photos with rating at least min_rating,
 making use of any .txt files in the current directory for rating,
 captioning, and style information.  The photos are sorted by date/time.

 The default photo rating is 0, so type 'gallery 0' to make
 a gallery of all photos (except any you have rated negative).
 If +keyword appears for any keyword, only photos whose caption
 contains keyword will be included.  You can include any number
 of +keywords, to include only photos that contain *all* those words.
 Likewise, -keyword only includes photos that do not contain keyword.
 The keywords are not case sensitive.

EXAMPLES:
 * Make gallery of all photos in current directory not rated negative.
       gallery 0

 * Create gallery of photos rated at least 2 that don't contain
   the word Kelly but do contain William.
       gallery 2 -kelly +william

RATINGS AND CAPTIONS:
 The gallery program makes use of any file with extension .txt in the
 current directory, parsing all of them in alphabetical order.
 The format of a .txt file is a series of lines as follows:

     property: value
     image_name: rating caption
     # a comment begins with # and will be ignored.

 * image_name must be the file name of an image (or video) including
    the extension, e.g., img_7430.jpg.  The rating must be an integer,
   and the caption text is any text that does not contain a colon.
   The rating may be omitted, and the caption text may span multiple lines.
 * The properties are: author, bgcolor, bordercolor, columns, date, email, mediu
m_quality, medium_size, textcolor, thumb_quality, thumb_size, title

 The thumbnails, small versions of photos, HTML gallery, and exif info
 are stored in hidden subdirectories .exif, .small, and .html.
---------------------------------------------------------------------------