.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.010.
.TH WEBMAGICK 1 "May 2009" "webmagick 2.02" "FSF"
.SH NAME
webmagick \- create gallery thumbnails for websites
.SH SYNOPSIS
.B webmagick
[\fIOPTIONS\fR]
.SH DESCRIPTION
WebMagick `webmagick' recurses through directories of images and builds HTML
pages and image-maps to display those images in a web browser. Options may be
specified on the command line as \-\-option or in .webmagickrc files as $opt_option.
By default WebMagick processes files in the current directory.  See \-\-srcdir for
a way to process files in a different directory.
.SS "General:"
.TP
\fB\-\-[no]debug\fR
Print debug messages (default off)
.TP
\fB\-\-[no]forcecache\fR
Force cached thumbnails to be generated (default off)
.TP
\fB\-\-[no]forcehtml\fR
Force HTML files to be generated (default off)
.TP
\fB\-\-[no]forcemontage\fR Force montage (default off)
.TP
\fB\-\-[no]ignorefp\fR
Ignore directories with names like _vti (FrontPage directories) (default on)
.TP
\fB\-\-[no]help\fR
Display usage message (default off)
.TP
\fB\-\-[no]recurse\fR
Recurse directory tree (default off)
.TP
\fB\-\-srcdir\fR
Image directory to process
.TP
\fB\-\-[no]verbose\fR
Tell us more ... (default off)
.TP
\fB\-\-[no]version\fR
Print version and exit (default off)
.SS "Paths:"
.TP
\fB\-\-iconpath\fR
Relative path under rootdir to webmagick icons
.TP
\fB\-\-iconbase\fR
Global base URL for webmagick icons
.TP
\fB\-\-prefixpath\fR
Path to prepend to generated URLs (e.g. /~username)
.TP
\fB\-\-rootpath\fR
Absolute path to server root (NCSA DocumentRoot)
.SS "Server-side imagemaps:"
.TP
\fB\-\-htimage\fR
Imagemap CGI program URL (set to '' for none)
.TP
\fB\-\-maptype\fR
Server-side map type ("ncsa" or "cern")
.TP
\fB\-\-[no]serversidemap\fR Enable server-side map writting (default off)
.SS "Filenames:"
.TP
\fB\-\-dirindexname\fR
Directory-name to title cross-reference file name
.TP
\fB\-\-imgindexname\fR
Image-name to thumbnail label cross-reference file name
.TP
\fB\-\-indexname\fR
Name of master index files (default server index)
.TP
\fB\-\-pageindexname\fR
Base name of page-related index files
.TP
\fB\-\-readme\fR
Name of directory info file
.SS "Caching:"
.TP
\fB\-\-[no]cache\fR
Cache thumbnails (default on)
.TP
\fB\-\-cachedir\fR
Subdirectory name to cache thumbnails in (default .cache)
.TP
\fB\-\-cacheformat\fR
Format of cached thumbnails (default JPEG)
.TP
\fB\-\-cachegeom\fR
Cache thumbnail geometry (default thumbgeom)
.TP
\fB\-\-cachemin\fR
Smallest image to cache in pixels. (default 300*200)
.SS "Montage:"
.TP
\fB\-\-[no]forcegif\fR
Force imagemap to be in GIF format (default off)
.TP
\fB\-\-[no]forcejpeg\fR
Force imagemap to be in JPEG format (default off)
.TP
\fB\-\-jpegquality\fR
Quality of JPEG imagemaps
.TP
\fB\-\-maxgif\fR
Maximum size of GIF imagemap before trying JPEG
.TP
\fB\-\-columns\fR
Montage columns
.TP
\fB\-\-rows\fR
Montage rows (max)
.TP
\fB\-\-[no]mapnetscape\fR
Map generated image files to Netscape 216-color cube (default off)
.TP
\fB\-\-thumbbackground\fR
Montage background color
.TP
\fB\-\-thumbframebgcolor\fR Background color inside of Frame (unused if no Frame)
.TP
\fB\-\-thumbborderwidth\fR Thumbnail border width (pixels)
.TP
\fB\-\-thumbcompose\fR
Thumbnail image composition operation (default Copy) Over, In, Out, Atop, Xor, Plus, Minus, Add, Subtract, Difference, Bumpmap, Copy, MatteReplace, Mask, Blend, Displace
.TP
\fB\-\-thumbfont\fR
Thumbnail title font
.TP
\fB\-\-thumbforeground\fR
Montage foreground color (effects label color)
.TP
\fB\-\-thumbframe\fR
Geometry of frame around thumbnail (default no frame)
.TP
\fB\-\-thumbgeometry\fR
Thumbnail geometry (widthxheight)
.TP
\fB\-\-thumbgravity\fR
Direction thumbnail gravitates to (default Center) NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast. North is up.
.TP
\fB\-\-thumblabel\fR
Format for default thumbnail text label
.TP
\fB\-\-thumblabelwidth\fR
Label width (in characters) to truncate to.
.TP
\fB\-\-thumbframecolor\fR
Frame color (if thumbnail frames enabled)
.TP
\fB\-\-thumbshadow\fR
Enable decorative shadow under thumbnail
.TP
\fB\-\-thumbtexture\fR
Texture to tile onto the image background
.TP
\fB\-\-thumbtransparent\fR Transparent color
.TP
\fB\-\-zoomfilter\fR
Zoom filter algorithm (Box/Triangle/Mitchell)
.SS "HTML Colors & Appearance:"
.TP
\fB\-\-address\fR
Optional user address info
.TP
\fB\-\-[no]anonymous\fR
Don't show WebMagick address and copyright info on pages (default off)
.TP
\fB\-\-coloralink\fR
Link (active) color
.TP
\fB\-\-colorback\fR
Background color (also applied to JPEG montage background)
.TP
\fB\-\-colorfore\fR
Foreground text color
.TP
\fB\-\-colorlink\fR
Link (unvisited) color
.TP
\fB\-\-colorvlink\fR
Link (visited) color
.TP
\fB\-\-dircoloralink\fR
Link (active) color (directory frame)
.TP
\fB\-\-dircolorback\fR
Background color (directory frame)
.TP
\fB\-\-dircolorfore\fR
Foreground color (directory frame)
.TP
\fB\-\-dircolorlink\fR
Link (unvisited) color (directory frame)
.TP
\fB\-\-dircolorvlink\fR
Link (visited) color (directory frame)
.TP
\fB\-\-dirhtmlext\fR
Extension for directory frame
.TP
\fB\-\-stylesheet\fR
URL to stylesheet (overrides other color options)
.TP
\fB\-\-[no]date\fR
Output updates date (default on)
.TP
\fB\-\-footer\fR
Page footer (imagemap frame) (default to </CENTER>)
.TP
\fB\-\-header\fR
Page header (imagemap frame) (default to <CENTER>)
.TP
\fB\-\-[no]javascript\fR
Enable JavaScript output (default off)
.TP
\fB\-\-[no]pichtml\fR
Per-image HTML file generation (default off)
.TP
\fB\-\-pichtmlext\fR
Per-image HTML file extension (default .html)
.TP
\fB\-\-pichtmlbottom\fR
Per-image HTML, extra HTML to display below image (default to </CENTER>)
.TP
\fB\-\-[no]pichtmlnav\fR
Per-image HTML, show navigation buttons (default off)
.TP
\fB\-\-[no]pichtmlputtitle\fR Put per-image HTML picture title (default on)
.TP
\fB\-\-pichtmltarget\fR
Per-image HTML default frame target
.TP
\fB\-\-pichtmltitleend\fR
End tags for per-image HTML picture title (default </P>)
.TP
\fB\-\-pichtmltitlestart\fR Start tags for per-image HTML picture title (default <P>)
.TP
\fB\-\-pichtmltop\fR
Per-image HTML, extra HTML to display above image (default to <CENTER>)
.TP
\fB\-\-[no]readmevisible\fR Show README.html on first page rather than just linking (default off)
.TP
\fB\-\-[no]tables\fR
Use HTML tables instead of imagemaps for thumbnails (default off)
.TP
\fB\-\-title\fR
Page title
.SS "Frame Options:"
.TP
\fB\-\-[no]frames\fR
Use frames, if no - single directory collection assumed (default on)
.TP
\fB\-\-framemarginwidth\fR Pixels allocated to frame margin in horizontal direction
.TP
\fB\-\-framemarginheight\fR Pixels allocated to frame margin in vertical direction
.TP
\fB\-\-framebordersize\fR
Pixels allocated to frame border
.TP
\fB\-\-frameborder\fR
Enable (YES) or disable (NO) decorative frame borders
.TP
\fB\-\-framestyle\fR
Frame style to use (out of those available)
.TP
\fB\-\-[no]allowconfig\fR
Allow user to configure framestyle, columns and rows (requires javascript and tables) (default off)
.SS "Messages Replacement:"
.TP
\fB\-\-msg_copyright\fR
"Copyright "
.TP
\fB\-\-msg_date_format\fR
"%B %e, %Y" (see strftime(3))
.TP
\fB\-\-msg_directories\fR
"Directories"
.TP
\fB\-\-msg_directory_navigator\fR
"Directory Navigator"
.TP
\fB\-\-msg_images\fR
"Images"
.TP
\fB\-\-msg_index_of_directory\fR
"Index of directory"
.TP
\fB\-\-msg_index_of_files\fR
"Index of files "
.TP
\fB\-\-msg_index_through\fR
"through"
.TP
\fB\-\-msg_next\fR
"Next"
.TP
\fB\-\-msg_page_navigator\fR
"Page Navigator"
.TP
\fB\-\-msg_page_updated_on\fR
"Page updated on"
.TP
\fB\-\-msg_prev\fR
"Prev"
.TP
\fB\-\-msg_produced_by\fR
"Produced by"
.TP
\fB\-\-msg_readme\fR
"ReadMe"
.TP
\fB\-\-msg_up\fR
"Up"
.SH "REPORTING BUGS"
Report bugs to <clindell@users.sourceforge.net>.
Visit the WebMagick web page at http://webmagick.sourceforge.net/
.SH "SEE ALSO"
The full documentation for
.B webmagick
is maintained as a Texinfo manual.  If the
.B info
and
.B webmagick
programs are properly installed at your site, the command
.IP
.B info webmagick
.PP
should give you access to the complete manual.