digest v 0.9

What is it?

Digest is a program to generate HTML index pages and image previews for collections of images. It is fast and simple, and it creates HTML that is compact, quick-rendering and does not rely on JavaScript or CSS. Click here to see a sample of what it does.

Requirements

Digest is written in the fantastic Python language and uses the python-imaging module to read images and create thumbnails.

Download

Download it here: digest.py.gz.

Supported and unsupported file types

Digest supports all filetypes supported by python-imaging; currently this includes JPG, JPEG, JPE, GIF, PNG, TIF, TIFF, AND BMP.

Thumbnails

In addition to creating thumbnails for supported file types, Digest will also use thumbnails for files or directories created by other programs or created by hand. For example, if you have created a thumbnail for a file named ./foo-bar.mpeg, digest will look for a thumbnail in ./.cache/foo-bar.jpg. A thumbnail for a directory ./dirname/ would be located in ./.cache/dirname.jpg.

If a directory contains images and has no hand-created thumbnail in its parent directory, digest will use the first image in the directory to generate a thumbnail for the directory.

Usage

Digest can be invoked from the command line with a list of directories to index; if the list is empty, Digest will index the current directory. Command line options can appear anywhere in the list of directories and apply to all directories.

Command line option	Description	Default value
General options
-l --links	index/follow symbolic links like directories	off
-nl --nolinks	do not index/follow symbolic links	on
-r --recurse	generate indices for all subdirectories	off
-c --cols	number of columns per index page	8
--rows	number of rows per index page ("--rows 0" will include all rows in one page)	6
Thumbnails
--thumbsize	maximum pixel dimensions of thumbnail	96
File names
--cache	name of directory to cache thumbnails in	.cache/
--index	name of file to store index in	index
--suffix	suffix of file to store index in	.html
--thumb	name of folder-thumbnail	folder
--ext	thumbnail extension/filetype	.jpg
	With these default file name settings, ./.cache/file.jpg is the thumbnail file for ./file.EXT.
HTML appearance
--text	text color	ffffff
--link	link color	ffff00
--vlink	visited link color	e0b000
--alink	active link color	ff0000
--bgcolor	background color	000000
	All colors in must be given in HTML color format.
Ignored directories
--skip	If this file is present in a directory, the directory will skipped by digest; it will not be indexed, but it will appear in the index for the parent directory.	.digest_skip
--ignore	If this file is present in a directory, the directory will be ignored by digest. It will not be indexed and it will not appear in the index file for the parent directory. It will be effectively invisible.	.digest_ignore
Help
-h --help	print help message

Last modified: Fri Feb 14 11:01:31 PST 2003