NAME

vlgal - Vincenzo's little gallery

SYNOPSIS

 vlgal [--h] [--css_definition_file <file>] [--image_icon_folder <file>]
    [--image_icon_next_peer <file>] [--image_icon_next_seq <file>]
    [--image_icon_previous_peer <file>] [--image_icon_previous_seq <file>]
    [--max_columns_dir <nr>] [--max_columns_image <nr>]
    [--max_height_list <nr-list>] [--max_width_list <nr-list>]
    [--table_order_dir <n|z>] [--table_order_image <n|z>]
    [--verbose] directory...

DESCRIPTION

vlgal implements a foto gallery browser in HTML. It generates HTML code to browse images. It also scales images to make thumbails out of them and to support different screen sizes.

The vlgal layout is designed to be simple. There are two views. The directory view shows images and sub-directories. The image view shows thumbnails and allows to jump to the next and previous images.

Both the directory view and the image view allow to switch the size of the images on the fly. The image view allows to jump between directories in order to avoid having to switch between directories during browsing.

The HTML code and scaled images are put inside the same directory where the original images reside. In each directory one file index-vlgal.html is created and one directory .vlgal.

The style can be customized by providing a CSS file.

Also, several options are provided to alter the ordering and the size of the tables in which the directories and images are put in the directory view.

Options:

--h

Print help.

--css_definition_file <file>

Css file to be used in the html files. The contents of this file is put between <style> and </style> tags. A default is provided as file VLGal/lib/default.css in @INC.

--image_icon_folder <file>

Image for folder icon. This file is copied into the .vlgal/icon directory and referred in the html files. A default is provided as file VLGal/lib/icon-folder.png in @INC.

--image_icon_next_peer <file>

Image for next-peer icon. This file is copied into the .vlgal/icon directory and referred in the html files. A default is provided as file VLGal/lib/icon-next-peer.png in @INC.

--image_icon_next_seq <file>

Image for next-in-sequence icon. This file is copied into the .vlgal/icon directory and referred in the html files. A default is provided as file VLGal/lib/icon-next-seq.png in @INC.

--image_icon_previous_peer <file>

Image for previous-peer icon. This file is copied into the .vlgal/icon directory and referred in the html files. A default is provided as file VLGal/lib/icon-previous-peer.png in @INC.

--image_icon_previous_seq <file>

Image for previous-in-sequence icon. This file is copied into the .vlgal/icon directory and referred in the html files. A default is provided as file VLGal/lib/icon-previous-seq.png in @INC.

--max_columns_dir <nr>

Maximum columns of directories. Defaults to 8.

--max_columns_image <nr>

Maximum columns of images. Defaults to 5.

--max_size_list <nr-list>

Maxumum image size list. The first size is the thumbnail size. The second size is the size displayed by default. A size of 0x0 means the original size. Defaults to 90x90,600x600,800x800,1000x1000,1200x1200,0x0.

--verbose

Show verbose messages.

SEE ALSO

VLGal::Directory, VLGal::File, VLGal::File::Factory, VLGal::File::MMagic, VLGal::Size, VLGal::Style

BUGS

None known (yet).

HISTORY

First development: October 2003

AUTHOR

Vincenzo Zocca <Vincenzo@Zocca.com>

COPYRIGHT

Copyright 2003, Vincenzo Zocca.

LICENSE

This file is part of the VLGal module hierarchy for Perl by Vincenzo Zocca.

The VLGal module hierarchy is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

The VLGal module hierarchy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the VLGal module hierarchy; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

VERSION

$Revision: 0.01 $