Identifier search

TOC »

sigma is a simple program for creating a Web gallery of images with a single command. It is based on the igal program by Eric Pop and generates a set of HTML 4.0+CSS-compliant static slides. The appearance of the image gallery can be altered by modifying the default CSS file, as well as the slide template and index page template files that appear in the image directory. Unlike igal, the templates are written as S-expressions, and follow the conventions of SXML.

sigma also checks for the existence of a $HOME/.sigma directory where users can store their own templates, overriding the site-wide /usr/share/sigma.

sigma relies on the ImageMagick package, and if sorting by image date is desired, it can use the exif program to extract EXIF date information from JPEG files.

The convert command from the ImageMagick package is required to process image files and the identify command enables sigma to include size information in the HTML it generates and to determine whether large images need to be rescaled.

If the -c option is used, sigma creates a .captions file, which contains captions to be inserted under each slide. The captions must be in S-expression format and may include SXML tags. Each caption entry can be in one of two forms:

(fname caption [option1 option2 ...])

The first element is the image file name, and the second element is the caption. The file name and the caption are required. They can be followed by any number of options keywords. The only option keyword currently recognized is hl, which indicates that the slide should be included on the optional highlights page.

(subdir name caption)

Entries of this form be used to specify captions for subfolders.

To add any comments to this file or to exclude any images from the slide show, add a semicolon the beginning of their respective lines. You may also change the order of images in your slide show at this time.

## Creates an image gallery using the image files
## found in the current directory and its subdirectories;
## uses directory album to write the HTML files and slides;
## writes image sizes and captions under the thumbnails on the index pages;
## creates and reads .captions file; resizes the slide images to a maximum
## height of 500 pixels
sigma -a -c -u -R --yslide=500 -t album

Copyright 2007-2013 Ivan Raikov.
Based on the igal program by Eric Pop.
ISO 9660 image creation code based on code by Walter C. Pelissero.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
A full copy of the GPL license can be found at
<http://www.gnu.org/licenses/>.