meillo@45: .TH GENWEBGALLERY 1 "genwebgallery\-0.8" "2008\-06\-23" "genwebgallery"
meillo@0: 
meillo@0: .SH NAME
meillo@45: genwebgallery \- generates minimalistic web galleries
meillo@0: 
meillo@0: .SH SYNOPSIS
meillo@6: .B genwebgallery [OPTIONS] PICTURES
meillo@0: 
meillo@0: .SH DESCRIPTION
meillo@0: .B genwebgallery
meillo@16: Generates a web gallery of mentioned pictures. Only very minimalistic static HTML pages are generated. Copies of the pictures are resized to the defined sizes.
meillo@0: .PP
meillo@36: All generated content goes in a subdirectory which defaults to
meillo@36: .IR webgallery .
meillo@36: Or any other directory specified by \-\-output.
meillo@0: .PP
meillo@45: Files are skipped if resizing is not successful. So it depends on the resize program.
meillo@25: .PP
meillo@0: The
meillo@45: .BR mogrify
meillo@45: tool from ImageMagick, or
meillo@45: .BR resize\-gd
meillo@45: is required.
meillo@45: 
meillo@45: .B mogrify
meillo@45: is the prefered resizing tool, cause of its (assumed) better quality.
meillo@45: .B resize\-gd
meillo@45: on the other hand has much less dependencies, but still provides everything that's needed here. It is used, if
meillo@45: .B mogrify
meillo@45: is not installed. If none of them is available, the program will abort.
meillo@0: 
meillo@0: .SH OPTIONS
meillo@0: .TP
meillo@0: .B \-\-help
meillo@0: Show summary of options.
meillo@0: .TP
meillo@0: .B \-\-version
meillo@0: Show version of program
meillo@0: .TP
meillo@0: .B \-v, \-\-verbose
meillo@0: Outputs more log data
meillo@0: .TP
meillo@0: .B \-o, \-\-output
meillo@0: Specify output directory
meillo@0: .TP
meillo@0: .B \-i, \-\-index
meillo@36: Specify index file
meillo@0: .TP
meillo@0: .B \-t, \-\-title
meillo@0: Specify title of gallery
meillo@0: .TP
meillo@36: .B \-f, \-\-footer
meillo@36: Specify footer text
meillo@0: .TP
meillo@12: .B \-ps, \-\-pic\-size
meillo@16: Specify size of pictures
meillo@0: .TP
meillo@12: .B \-ts, \-\-thumb\-size
meillo@0: Specify size of thumbnails
meillo@6: .TP
meillo@6: .B \-\-overwrite
meillo@6: Overwrites the output directory if it exists without asking.
meillo@6: Without this option, the users is interactively asked what to do.
meillo@6: .PP
meillo@6: See
meillo@12: .B genwebgallery \-\-help
meillo@6: for default values.
meillo@0: 
meillo@36: .SH EXAMPLES
meillo@36: To create an image gallery as fast as possible, simply call the program with the pictures you want as arguments.
meillo@36: .IP
meillo@36: genwebgallery *.jpg
meillo@36: .PP
meillo@36: The program creates a directory
meillo@36: .I webgallery
meillo@36: which contains a
meillo@36: .I index.html
meillo@36: and each picture in large, small and a HTML for it.
meillo@36: .PP
meillo@36: If you want to customize the output
meillo@36: .IP
meillo@39: genwebgallery \-o holiday2008 \-t "Trip to Hawaii" ~/hawaii08/*.jpg
meillo@36: .PP
meillo@36: Creates a directory
meillo@36: .I holiday2008
meillo@36: which contains a
meillo@36: .I index.html
meillo@36: and each picture in large, small and a HTML for it. All HTML pages are titled with ``Trip to Hawaii''.
meillo@36: 
meillo@0: .SH EXIT CODE
meillo@0: .TP
meillo@0: .B 1
meillo@0: Any other error
meillo@0: .TP
meillo@0: .B 2
meillo@45: None of the supported image resize programs was found. These are:
meillo@45: .B mogrify
meillo@45: from the ImageMagick tool collection, and
meillo@45: .B resize\-gd
meillo@6: .TP
meillo@6: .B 3
meillo@6: The output directory already exists and the user wanted to keep it.
meillo@6: .TP
meillo@6: .B 4
meillo@6: The output directory already exists and the user wanted it to be deleted, but it was not possible.
meillo@0: 
meillo@25: .SH BUGS
meillo@45: .B mogrify
meillo@25: fails the conversion of the XCF image format of GIMP, but it exits with 0 anyway. This looks like a bug in the
meillo@45: .B mogrify
meillo@25: program.
meillo@25: As result the image is added to the gallery but it is not viewable.
meillo@25: Other formats might be affected as well.
meillo@25: 
meillo@0: .SH SEE ALSO
meillo@45: .BR mogrify (1),
meillo@45: .BR ImageMagick (1),
meillo@45: .BR resize\-gd (1).
meillo@0: 
meillo@0: .SH AUTHOR
meillo@25: genwebgallery and this man page were written by markus schnalke <meillo@marmaro.de>
meillo@0: .PP
meillo@22: Website: http://prog.marmaro.de/genwebgallery