WEBMAGICK(1) FSF WEBMAGICK(1)NAME
webmagick - manual page for webmagick 2.03pre26
SYNOPSIS
webmagick [OPTIONS]
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 .webmag‐
ickrc 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.
General:
--[no]debug
Print debug messages (default off)
--[no]forcecache
Force cached thumbnails to be generated (default off)
--[no]forcelowres
Force cached low resolution images to be generated (default off)
--[no]forcehtml
Force HTML files to be generated (default off)
--[no]forcemontage Force montage (default off)
--[no]ignorefp
Ignore directories with names like _vti (FrontPage directories)
(default on)
--[no]indexinfo
Put "Index of files" (default on)
--[no]help
Display usage message (default off)
--[no]recurse
Recurse directory tree (default off)
--srcdir
Image directory to process
--[no]verbose
Tell us more ... (default off)
--[no]version
Print version and exit (default off)
Paths:
--iconpath
Relative path under rootdir to webmagick icons
--iconbase
Global base URL for webmagick icons
--imgprefixpath
Add to any image URL
--prefixpath
Path to prepend to generated URLs (e.g. /~username)
--rootpath
Absolute path to server root (NCSA DocumentRoot)
Server-side imagemaps:
--htimage
Imagemap CGI program URL (set to '' for none)
--maptype
Server-side map type ("ncsa" or "cern")
--[no]serversidemap Enable server-side map writting (default off)
Filenames:
--defsiteindex
Default index name for the whole site (default "index.html")
--dirindexname
Directory-name to title cross-reference base name (default
".dirindex")
--imgindexname
Image-name to thumbnail label cross-reference base name (default
".imgindex")
Line Format: <Image Name> <Short Description>[, <Full Description> ]
or: pageTitle <html page tile>[, <Montage Title> ]
--indexname
Name of master index files (default "index.html")
--pageindexname
Base name of page-related index files (default ".index")
--readme
Name of directory info file (default "README.html")
Caching:
--[no]cache
Cache thumbnails (default on)
--cachedir
Subdirectory name to cache thumbnails in (default .cache)
--cacheformat
Format of cached thumbnails (default JPEG)
--cachegeom
Cache thumbnail geometry (default thumbgeom)
--cachemin
Smallest image to cache in pixels, x*y (default 0)
Low resolution images:
--[no]lowres
Cache low resolution images (default on for Javascript, off oth‐
erwise)
--lowresdir
Subdirectory name to cache low resolution images in (default
.640x480)
--lowresformat
Format of cached low resolution images (default JPEG)
--lowresgeom
Cache low resolution geometry (default 640x480+2+2>)
--lowresmin
Smallest image to resize in pixels. (default 640*480)
Montage:
--[no]forcegif
Force imagemap to be in GIF format (default off)
--[no]forcejpeg
Force imagemap to be in JPEG format (default off)
--jpegquality
Quality of JPEG imagemaps
--maxgif
Maximum size of GIF imagemap before trying JPEG
--columns
Montage columns
--rows Montage rows (max)
--[no]mapnetscape
Map generated image files to Netscape 216-color cube (default
off)
--thumbbackground
Montage background color
--thumbframebgcolor Background color inside of Frame (unused if no
Frame)
--thumbborderwidth Thumbnail border width (pixels)
--thumbcompose
Thumbnail image composition operation (default Replace) Over,
In, Out, Atop, Xor, Plus, Minus, Add, Subtract, Difference,
Bumpmap, Replace, MatteReplace, Mask, Blend, Displace
--thumbfont
Thumbnail title font
--thumbforeground
Montage foreground color (effects label color)
--thumbframe
Geometry of frame around thumbnail (default no frame)
--thumbgeometry
Thumbnail geometry (widthxheight)
--thumbgravity
Direction thumbnail gravitates to (default Center) NorthWest,
North, NorthEast, West, Center, East, SouthWest, South, South‐
East. North is up.
--thumblabel
Format for default thumbnail text label
--thumblabelwidth
Label width (in characters) to truncate to.
--thumbframecolor
Frame color (if thumbnail frames enabled)
--thumbshadow
Enable decorative shadow under thumbnail
--thumbtexture
Texture to tile onto the image background
--thumbtransparent Transparent color
--unsharp
Unsharping parameters (for all images)
--zoomfilter
Zoom filter algorithm (Box/Triangle/Mitchell)
HTML Colors & Appearance:
--address
Optional user address info
--[no]centerfooter Center the footer text (default no)
--[no]anonymous
Don't show WebMagick address and copyright info on pages
(default off)
--bodytagins
Insert argument into <BODY> tag
--htmltagins
Insert argument into <HTML> tag
--coloralink
Link (active) color
--colorback
Background color (also applied to JPEG montage background)
--colorfore
Foreground text color
--colorlink
Link (unvisited) color
--colorvlink
Link (visited) color
--dircoloralink
Link (active) color (directory frame)
--dircolorback
Background color (directory frame)
--dircolorfore
Foreground color (directory frame)
--dircolorlink
Link (unvisited) color (directory frame)
--dircolorvlink
Link (visited) color (directory frame)
--dirhtmlext
Extension for directory frame
--forceuplink
Force there to be a link to "../index.html" in directory list
even if we didn't generate the file
--forcenouplink
Force there to be no link to "../index.hml" in directory list
even if we did generate the file
--stylesheet
URL to stylesheet (overrides other color options)
--relnextadd
Addition to rel=next, Chrome's "prerender" for example (default
"")
--[no]userelnav
Put rel=prev,next links to the <HEAD> (default 1)
--[no]date
Output updates date (default on)
--footer
Page footer (imagemap frame) (default to </article></DIV>)
--header
Page header (imagemap frame) (default to <DIV class="wm_cen‐
ter"><article>)
--headins
Insert argument into <HEAD> section
--prepend
Prepend to the very top of each HTML
--[no]javascript
Enable JavaScript output (default off)
--[no]readmevisible Show README.html on first page rather than just
linking (default off)
--[no]divs
Use HTML divs instead of imagemaps for thumbnails (default off)
--[no]tables
Use HTML tables instead of imagemaps for thumbnails (default
off)
--tables_params
Table HTML parameters
--tables_top
HTML before table contents
--tables_bottom
HTML after table contents
--title
Page title
--[no]idxbtnfirst
Put Up/First button before Prev/Next buttons (default on)
--[no]microformat
Use schema.org/ImageObject for thumbnails and pictures (default
on)
Per-image HTML options:
--[no]pichtml
Per-image HTML file generation (default off)
--pichtmlaltdrop
Regexp to drop from ALT= (default "")
--pichtmlaltend
Some words to append to ALT= (default "")
--pichtmlaltstart
Some words to prepend to ALT= (default "")
--pichtmlbottom
Per-image HTML, extra HTML to display below image (default to
</article></DIV>)
--pichtmlext
Per-image HTML file extension (default .html)
--[no]pichtmlnav
Per-image HTML, show navigation buttons (default off)
--[no]pichtmlputtitle Put per-image HTML picture title (default on)
--[no]pichtmltitletop
Put per-image picture title above image (default on)
--[no]edgelinksindex Edge-links on per-image HTML link back to index
(default off)
--pichtmltarget
Per-image HTML default frame target
--pichtmltitleend
End tags for per-image HTML picture title (default </P>)
--pichtmltitlestart Start tags for per-image HTML picture title
(default <P>)
--pichtmltop
Per-image HTML, extra HTML to display above image (default to
<DIV class="wm_center"><article>)
--[no]fancytables
Use a fancier HTML table (default off). Caution, the default
colors do not look good with this option.
Frame Options:
--[no]frames
Use frames, if no - single directory collection assumed (default
no)
--framemarginwidth Pixels allocated to frame margin in horizontal
direction (default 1)
--framemarginheight Pixels allocated to frame margin in vertical direc‐
tion (default 1)
--frameborder
Enable (1, default) or disable (0) decorative frame borders
--framestyle
Frame style to use (out of those available)
--[no]allowconfig
Allow user to configure framestyle, columns and rows (requires
javascript and tables) (default off)
Messages Replacement:
--msg_copyright
"Copyright "
--msg_date_format
"%B %e, %Y" (see strftime(3))
--msg_directories
"Directories"
--msg_directory_navigator
"Directory Navigator"
--msg_first
"First"
--msg_images
"Images"
--msg_index_of_directory
"Index of directory"
--msg_index_of_files
"Index of files "
--msg_index_through
"through"
--msg_next
"Next"
--msg_pause
"Pause"
--msg_page_navigator
"Page Navigator"
--msg_page_updated_on
"Page updated on"
--msg_prev
"Prev"
--msg_produced_by
"Produced by"
--msg_readme
"ReadMe"
--msg_up
"Up"
REPORTING BUGS
Report bugs to <clindell@users.sourceforge.net>. Visit the WebMagick
web page at http://webmagick.sourceforge.net/
SEE ALSO
The full documentation for webmagick is maintained as a Texinfo manual.
If the info and webmagick programs are properly installed at your site,
the command
info webmagick
should give you access to the complete manual.
webmagick 2.03pre26 February 2016 WEBMAGICK(1)