WebThumb

From PDWiki

WebThumb

Curator:	Sam Stafford
Depot path:	//guest/sam_stafford/webthumb/
Download:	bin.ntx86/
Language:	C/C++
License:	BSD

1 About This Project
2 Usage
3 License
4 Recent Changes

About This Project

WebThumb is a command line utility that uses a simple markup language to generate bare-bones HTML image galleries. It was written to simplify the process of taking a directory full of vacation photos and creating a web page with thumbnail links.

Usage

To use WebThumb:

Create a file called webthumb.txt and place it in the directory with your image files.
Copy and paste a list of the image files into the webthumb.txt file.
Put a line at the top with the text \output=index.html, or whatever file you want the HTML to go to.
(optional) Type descriptions after the image file names.
(optional) Add additional configuration settings after \output=... (see below).
Run webthumb.
Uploading the resulting HTML, source images, and thumbs/ directory to your web server.

Configuration settings are listed by webthumb -h:

% webthumb -h

Usage: webthumb [input file]
Input file defaults to webthumb.txt.
Syntax for input file:
--------------------------
IMAGE Image Caption : thumbnail IMAGE with caption 'Image Caption'
--------------------------
#<insert html here> : pass html straight through to output file
--------------------------
\variable=value     : set configuration variable
 output=FILE (specifies HTML file to write to, default stdout)
 height=NUM  (specifies max height of thumbnails, default 200)
 width=NUM   (specifies max width of thumbnails, default 200)
 columns=NUM (specifies number of columns in table, default off)
 spacing=NUM (specifies space in pixels between thumbnails)
 quality=NUM (specifies thumbnail quality on a scale of 0-100)
 padthumbs   (pads all thumbnails to max height and width)
 padbgcol=C  (uses HTML color C as background for padded thumbnails
 imgattrib=A (inserts string A into image tags, i.e. <img A ...>
 link=URL    (redirects next link to URL instead of source image)
 captions    (places captions under each image [requires columns])

License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the Perforce Public Depot nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.