WEBMAGICK(1)

📦 version 2.02, in ubuntu jammy

💖 NAME 💖

webmagick — bestie, it makes gallery thumbnails for websites. That's it, that's the whole job. Also, hi, this is the webmagick(1) page from the FSF, so you know it's official 💅

🌸 SYNOPSIS 🌸

webmagick [OPTIONS]

✨ DESCRIPTION ✨

WebMagick (aka webmagick) literally recurses through your directories of images and builds HTML pages and image-maps so you can show those images off in a web browser. Main character behavior, honestly 👑

Okay so here's how you feed it options: you can drop them on the command line as --option, or you can put them in .webmagickrc files as $opt_option. Your choice, no judgment 💖

By default WebMagick processes files in the current directory. Wanna point it somewhere else? Go look at --srcdir, it's got you.

🫶 General 🫶

  • --[no]debug — print debug messages (default off)
  • --[no]forcecache — force cached thumbnails to be generated, no matter what (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 (those are FrontPage directories, we don't want them) (default on)
  • --[no]help — display the usage message (default off)
  • --[no]recurse — recurse the whole directory tree (default off)
  • --srcdir — the 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
  • --prefixpath — path to prepend to generated URLs (like /~username, iykyk)
  • --rootpath — absolute path to the server root (that's the NCSA DocumentRoot)

🗺️ Server-side imagemaps 🗺️

  • --htimage — the Imagemap CGI program URL (set it to '' for none)
  • --maptype — server-side map type, either "ncsa" or "cern"
  • --[no]serversidemap — enable server-side map writting (default off)

📁 Filenames 📁

  • --dirindexname — directory-name to title cross-reference file name
  • --imgindexname — image-name to thumbnail label cross-reference file name
  • --indexname — name of master index files (default is the server index)
  • --pageindexname — base name of page-related index files
  • --readme — name of the directory info file

🍓 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. (default 300*200)

🎀 Montage 🎀

  • --[no]forcegif — force the imagemap to be in GIF format (default off)
  • --[no]forcejpeg — force the imagemap to be in JPEG format (default off)
  • --jpegquality — quality of JPEG imagemaps
  • --maxgif — maximum size of a GIF imagemap before it tries JPEG
  • --columns — montage columns
  • --rows — montage rows (max)
  • --[no]mapnetscape — map generated image files to the Netscape 216-color cube (default off)
  • --thumbbackground — montage background color
  • --thumbframebgcolor — background color inside of Frame (unused if there's no Frame)
  • --thumbborderwidth — thumbnail border width (in pixels)
  • --thumbcompose — thumbnail image composition operation (default Copy). The options are: Over, In, Out, Atop, Xor, Plus, Minus, Add, Subtract, Difference, Bumpmap, Copy, MatteReplace, Mask, Blend, Displace
  • --thumbfont — thumbnail title font
  • --thumbforeground — montage foreground color (this one effects the label color)
  • --thumbframe — geometry of the frame around a thumbnail (default: no frame)
  • --thumbgeometry — thumbnail geometry (widthxheight)
  • --thumbgravity — direction the thumbnail gravitates to (default Center). Options: NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast. North is up ⬆️
  • --thumblabel — format for the default thumbnail text label
  • --thumblabelwidth — label width (in characters) to truncate to.
  • --thumbframecolor — frame color (if thumbnail frames are enabled)
  • --thumbshadow — enable a decorative shadow under the thumbnail
  • --thumbtexture — texture to tile onto the image background
  • --thumbtransparent — transparent color
  • --zoomfilter — zoom filter algorithm (Box/Triangle/Mitchell)

🌈 HTML Colors & Appearance 🌈

  • --address — optional user address info
  • --[no]anonymous — don't show WebMagick address and copyright info on pages (default off)
  • --coloralink — link (active) color
  • --colorback — background color (this also gets applied to the 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 the directory frame
  • --stylesheet — URL to stylesheet (this overrides the other color options, so like, it wins)
  • --[no]date — output the updates date (default on)
  • --footer — page footer (imagemap frame) (defaults to </CENTER>)
  • --header — page header (imagemap frame) (defaults to <CENTER>)
  • --[no]javascript — enable JavaScript output (default off)
  • --[no]pichtml — per-image HTML file generation (default off)
  • --pichtmlext — per-image HTML file extension (default .html)
  • --pichtmlbottom — per-image HTML, extra HTML to display below the image (defaults to </CENTER>)
  • --[no]pichtmlnav — per-image HTML, show navigation buttons (default off)
  • --[no]pichtmlputtitle — put per-image HTML picture title (default on)
  • --pichtmltarget — per-image HTML default frame target
  • --pichtmltitleend — end tags for the per-image HTML picture title (default </P>)
  • --pichtmltitlestart — start tags for the per-image HTML picture title (default <P>)
  • --pichtmltop — per-image HTML, extra HTML to display above the image (defaults to <CENTER>)
  • --[no]readmevisible — show README.html on the first page rather than just linking it (default off)
  • --[no]tables — use HTML tables instead of imagemaps for thumbnails (default off)
  • --title — page title

🧚 Frame Options 🧚

  • --[no]frames — use frames; if there are no frames, a single directory collection is assumed (default on)
  • --framemarginwidth — pixels allocated to the frame margin in the horizontal direction
  • --framemarginheight — pixels allocated to the frame margin in the vertical direction
  • --framebordersize — pixels allocated to the frame border
  • --frameborder — enable (YES) or disable (NO) decorative frame borders
  • --framestyle — frame style to use (out of those available)
  • --[no]allowconfig — allow the user to configure framestyle, columns and rows (this 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_images — "Images"
  • --msg_index_of_directory — "Index of directory"
  • --msg_index_of_files — "Index of files "
  • --msg_index_through — "through"
  • --msg_next — "Next"
  • --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 🐛

Found a bug? Bestie, report it to <clindell@users.sourceforge.net>. And go 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. No cap 📖✨

Okay that's the whole thing, and yes I need you to know this page is from webmagick 2.02, dated May 2009 — vintage, iconic, still serving looks 💅🌸 Go build a gallery bestie, you've got this 🎀

📦 where this page comes from