Linux Certif

Toute la documentation sur la certification Linux LPI

lazygal

NAME

lazygal - static web gallery generator

SYNOPSIS

lazygal [-h | -v | [options] albumdir]

DESCRIPTION

This manual page explains the lazygal program. This program is a static web gallery generator written in Python.

OPTIONS

These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the -h switch.

-v --version

Show program's version number and exit.

-h --help

Show summary of options.

--quiet

Don't output anything except for errors.

--debug

Output everything that lazygal is doing.

-o DEST_DIR --output-directory=DEST_DIR

Directory where web pages, slides and thumbs will be written (default is current directory).

-t THEME --theme=THEME

Theme name (looked up in theme directory) or theme full path.

--default-style=DEFAULT_STYLE

Default style to apply to the theme.

--template-vars=TPL_VARS

Common variables to load all templates with.

--clean-destination

Clean destination directory of files that should not be there.

--check-all-dirs

Exhaustively go through all directories regardless of source modification time.

-s IMAGE_SIZE --image-size=IMAGE_SIZE

Size of images, define as name=xxy, ..., eg. small=800x600,medium=1024x768. The special dimensions 0x0 use original size.

-T THUMBNAIL_SIZE --thumbnail-size=THUMBNAIL_SIZE

Size of thumbnails, define as xxy, eg. 150x113.

-q QUALITY --quality=QUALITY

Quality of generated JPEG images (default is 85).

-O --original

Include original photos in output.

--orig-base=RELATIVE_PATH

Do not copy original photos in output directory, instead link them using RELATIVE_PATH as base for those links (discarded without -O).

--optimize

Run an extra optimization pass for each generated thumbnail.

--progressive

Generate progressive JPEG images.

--puburl=PUB_URL

Publication URL (only usefull for feed generation).

-m --generate-metadata

Generate metadata description files where they don't exist.

-n THUMBS_PER_PAGE --thumbs-per-page=THUMBS_PER_PAGE

Maximum number of thumbs per index page. This enables index pagination (0 is unlimited).

--pic-sort-by=ORDER

Sort order for images in a subgallery, among 'mtime', 'filename', or 'exif'. (default is 'exif' which is by EXIF date if EXIF data is available, filename otherwise, sorting EXIF-less images before). Add ':reverse' to reverse the sort order (e.g. --pic-sort-by=mtime:reverse).

--subgal-sort-by=ORDER

Sort order for subgalleries, among 'mtime' or 'filename' (default is 'filename'). Add ':reverse' to reverse the sort order (e.g. --subgal-sort-by=filename:reverse).

-z --make-dir-zip

Make a zip archive of original pictures for each directory.

--webalbum-pic-bg=WEBALBUMPIC_BG

Webalbum picture background color. Default is transparent, and implies the PNG format. Any other value, e.g. red, white, blue, uses JPEG.

THEMES

A theme maps to a directory that contains at least the following items:

theme/browse.thtml

The XHTML template for the theme browse page (displaying one picture).

theme/dirindex.thtml

The XHTML template for the directory index page (pictures and sub-galleries links).

This must be valid XML. See http://genshi.edgewall.org/wiki/Documentation/xml-templates.html for syntax.

Each file which name starts with SHARED_ is copied to the web album destination under the directory shared and is aimed at being a shared ressource accross your web album (CSS stylesheet, button, etc.).

Each file which extension starts with t is processed through the Genshi text template engine before being copied. See http://http://genshi.edgewall.org/wiki/Documentation/text-templates.html for syntax.

ALBUM METADATA

If a directory from the source album contains a file named album_description, it is processed as a source of album metadata. See /usr/share/doc/lazygal/README for more information.

FILES

~/.lazygal

User configuration directory.

~/.lazygal/config

User configuration file. INI like file format.

~/.lazygal/themes

User themes directory.

SEE ALSO

The full documentation of lazygal is maintained as a README file.

More information is available on the program website: http://sousmonlit.dyndns.org/~niol/playa/oss:lazygal.

AUTHOR

This manual page was written for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

COPYRIGHT

CopyrightCopyright © 2008