La playa de ~niol/ oss/ projects/ Lazygal
  1. About
  2. Requirements
  3. Usage
  4. Download & Changelog
  5. Contributing
    1. Code
    2. Translations
  6. Bugs & feature requests

About

lazygal is another static web gallery generator written in Python.

It can be summed up by the following features :

A huge gallery shows Lazygal in action : Album. Another example using album images: Photos from Japan.

Requirements

lazygal requires :

Building a lazygal installation requires :

Usage

Usage is straightforward :

usage: lazygal [options] albumdir

Options:
  -h, --help            Show this help message and exit.
  --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.
  -v, --version         Display program version.
  --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>=<x>x<y>,..., eg.
                        small=800x600,medium=1024x768. The special dimensions
                        0x0 use original size.
  -T THUMBNAIL_SIZE, --thumbnail-size=THUMBNAIL_SIZE
                        Size of thumbnails, define as <x>x<y>, eg. 150x113.
  -q QUALITY, --quality=QUALITY
                        Quality of generated JPEG images (default is 85).
  -O, --original        Include original photos in output.
  --orig-base=ORIG_BASE
                        Do not copy original photos in output directory,
                        instead link them using submitted relative path as
                        base.
  --puburl=PUB_URL      Publication URL (only usefull for feed generation).
  -m, --generate-metadata
                        Generate metadata description files where they don&#039;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).
  -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.
  --optimize            Run an extra optimization pass an each image.
  --progressive         Generate Progressive JPEG images.
  --pic-sort-by=ORDER   Sort order for images in a folder: filename, mtime, or
                        exif. Add &#039;:reverse&#039; to reverse the chosen order.
  --subgal-sort-by=ORDER
                        Sort order for sub galleries in a folder: filename or
                        mtime. Add &#039;:reverse&#039; to reverse the chosen order.

If you want to force lazygal into checking a directory's contents, simply touch the source directory to modify its modification time :

$ touch album_source/gallery_to_check

Download & Changelog

(full log of changes may be browsed in Lazygal's repository browser)

Lazygal is part of Debian (and thus Ubuntu universe), which should make it one aptitude install away if you use one of those.

Contributing

Code

Code may be downloaded using darcs :

darcs get --partial http://sousmonlit.dyndns.org/~niol/repository/lazygal/

It is browsable online in Lazygal's repository browser.

lazygal may be used directly in the source repository, by calling the lazygal.py script. Building simply prepares the translations and the man pages. Updating a source checkout of the lazygal rpeository is done using darcs pull in the source directory.

There should be an up to date snapshot of the repository available in the Snapshots directory.

Patches are very welcome and darcs makes it really easy to exchange changesets.

Translations

To start a new translation, for example cs_CZ, you can proceed as follows. The first script requires intltool-update and xgettext from the GNU gettext package.

$ devscripts/update-po
$ cp locale/lazygal.pot locale/cz_CZ.po
$ $EDITOR locale/cz_CZ.po

(do not bother committing or sending in changes to lazygal.pot, they contain a lot of noise because of changes in line numbers)

Another side-note : in templates, translatable strings are declared in a character noisy way (I hope to fix this one day). As an example :

<p><a href="..">Parent</a></p>

becomes

<p><a href="..">${_(&#039;Parent&#039;)}</a></p>

Bugs & feature requests

This project has too few users/contributors to justify the use of a dedicated bug tracking application.

For now, bug reports and feature requests may go in :