GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


       lazygal - static web gallery generator


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


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

       lazygal works so: you should have an original store of files - possibly
       containg subdirectories (their names serving as headings if not using
       the album metadata feature). This is the source file hierarchy. It will
       never be modified by lazygal. Then, when launching:

       $ lazygal -o /var/www/MyAlbum /home/user/SourceDir

       lazygal will analyze the contents of the source hierarchy and will
       (re)create the target hierarchy, with all the bells and whistles
       defined by the templates. Only missing parts or parts that are not up
       to date will be generated. There is a limitation to this mechanism
       though: although updates in the source directory, in the metadata or in
       the themes are detected, changes in command line options and
       configuration files since last generation are not and the user should
       manually delete files that need to be generated again.


       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.

           Don't output anything except for errors.

           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 to apply to the theme.

           Common variables to load all templates with, e.g.
           --template-vars='footer=foo bar,color=baz'. For longer variable
           contents, it is easier to use a configuration file (see

       -f --force-gen-pages
           Force rebuild of web pages, regardless of the modification times of
           their dependencies. This is handy when changing a configuration
           option affecting these (theme, directory flattening, etc.).

           Clean destination directory of files that should not be there
           (default is to print a warning but not to delete).

           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. Refer to the IMAGE RESIZE DESCRIPTION section for
           more information on the available syntax.

       -T THUMBNAIL_SIZE --thumbnail-size=THUMBNAIL_SIZE
           Size of thumbnails, eg. 150x113. Refer to the IMAGE RESIZE
           DESCRIPTION section for more information on the available syntax.

       -q QUALITY --quality=QUALITY
           Quality of generated JPEG images (default is 85).

       -O --original
           Include original photos in output.

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

           Do not copy original photos in output directory, instead create
           symlinks to their original locations. This is useful when you plan
           transferring the whole directory which lazygal generated to some
           other location, perhaps with rsync, and you wish to avoid creating
           an extra copy of each photo.

               This option is not available on Windows; if you try to use it
               on that operating system, lazygal will immediately exit with an
               exit status of 1.

           Publication URL (only useful for feed generation).

       -m --generate-metadata
           Generate metadata description files where they don't exist in the
           source tree instead of generating the web gallery. This disables
           all other options.

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

           If set, lazygal will only export the pictures that have one of
           their (IPTC) tags matching TAG. It is also possible to use an
           equivalent of AND and OR boolean tests to filter tags. For more
           details, read below the section TAG FILTERING.

           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.

           Sort order for subgalleries, among 'exif' (EXIF date of the latest
           picture in sub-gallery), 'mtime' or 'dirname' (default is
           'dirname'). Add ':reverse' to reverse the sort order (e.g.

           Level below which the directory tree is flattened. Default is no
           flattening ('No').

           This option makes the program include the web gallery index of
           child galleries in their parent's gallery index, if their level is
           greater than the supplied LEVEL. The level of the album root is 0.

           Index pages with multiple galleries (which happens when this
           section is used) show the pictures links in gallery sections.

           The following examples show the produced indexes for a sample album
           (2 sub-galleries, 1 sub-sub-gallery, 1 picture in each one of

           Example 1. --dir-flattening-depth=No (default)

                             index.php <- sub-gallery links
                             subgal1/index.php <- index with img1
                             subgal1/subsubgal1/index.php <- index with img2
                             subgal2/index.php <- index with img3

           Example 2. --dir-flattening-depth=0

                             index.php <- contains index for all pics

           Example 3. --dir-flattening-depth=1

                             index.php <- contains index for all pics
                             subgal1/index.php <- index with img1 and img2
                             subgal2/index.php <- index with img3

       -z --make-dir-zip
           Make a zip archive of original pictures for each directory.

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

           What type of web album thumbnails to generate. By default, lazygal
           generates the well-loved "messy" thumbnails with randomly selected
           pictures from the album each rotated by a random amount and pasted
           together. This default can also be forced by specifying 'messy' as

           On the other hand, specifying 'tidy' as the value of this option
           forces lazygal to skip the rotations, resulting in more regularly
           shaped thumbnails which can also be more densely packed. This can
           be an advantage if not all users of your albums have huge screens

           Do not remove GPS data from EXIF tags. By default the location tags
           are removed for privacy reasons. However, there are situations when
           having the location data makes sense and is desired. This is mostly
           meant to be used with holiday photos.


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

           Files to put in the web gallery shared directory, e.g. CSS,
           Javascript, images or other resources common to all galleries.

           The XHTML template for the theme browse page (displaying one

       theme/dirindex.thtml or theme/dynindex.thtml
           The XHTML template for the directory index page (pictures and
           sub-galleries links).

       Depending on which index file is present, the theme will be:

       dirindex.thtml: fully static
           one HTML page per picture, per size and one index per size, or

       dynindex.thtml: dynamic
           only one index per directory is to be generated.

       theme/*.thtml must be valid XML. See for
       syntax. Dependencies for statically included templates (i.e. with
       filenames not computed from variables) are automatically computed: when
       an included template is modified, the software will automatically
       figure out which pages to re-generate. Missing template files will be
       searched for in the default theme.

       theme/SHARED_* files (common resources for the shared directory) are
       renamed to strip the SHARED_ prefix and:

       ·   Processed using the Genshi text template engine (see
           for syntax.) if their file extension starts with t,

       ·   Copied to the web album destination otherwise.

       Using the theme manifest theme/manifest.json file, it is possible to
       include files from other directories to be copied into the web album
       shared files.

       Example 4. manifest.json

               "shared": [
                   # copy as shared/lib.js
                   { "path": "../lib-2.1.js", "dest": "lib.js" },

                   # copy as shared/js/lib-2.1.js
                   { "path": "../lib-2.1.js", "dest": "js/" }

       Please refer to the examples supplied in /usr/share/lazygal/themes.


       If a directory from the source album contains a file named
       album_description, it is processed as a source of album metadata. The
       format is borrowed from another album generating tool - Matew. Each
       line is treated as one possible tag, unknown lines are simply ignored.
       Example content of this file follows:

       Example 5. album_description

           Album name "My album"
           Album description "Description, which can be very long."
           Album image identifier relative/path/to/image.jpg

       Otherwise, the user can provide metadata in the following files.

           The title to use for this album directory.

           The description for this album directory. HTML tags are used
           verbatim from this file.

           The image to use at the top of the album picture stack.

           The description to use for this particular image. Please note that
           HTML tags are taken as provided in this file for output in the

       Lazygal also extracts information from many metadata tags in image
       files. Regarding image description, Lazygal searches for comments in
       this order:

        1. pic.jpeg.comment file

        2. Exif.Photo.UserComment

        3. Exif.Image.ImageDescription

        4. Iptc.Application2.ObjectName

        5. JPEG comment


           User configuration directory.

           User themes directory.


       Multiple configuration files are processed by lazygal. The
       configuration is initially set up with the defaults. The defaults can
       be found in the lazygal source distribution in lazygal/defaults.conf.

       Then, the configuration files are processed in the following order,
       each newly defined value overloading formerly defined values.

       Finally, any command-line-provided parameter takes precedence on any
       configuration file value.

           User configuration file. See lazygal.conf(5) for format.

           Album root configuration file. See lazygal.conf(5) for format.

           Web gallery configuration file. Only the webgal and template-vars
           sections are red in these files. The configuration applies to the
           gallery representing the directory of the configuration file, and
           all of its sub-directories, unless another configuration file in a
           sub-directory overloads some of the defined configuration values.
           See lazygal.conf(5) for format.


       The size string follows the same syntax as ImageMagick's.

           Height and width both scaled by specified percentage.

           Height and width individually scaled by specified percentages.

           Width given, height automatically selected to preserve aspect

           Height given, width automatically selected to preserve aspect

           Maximum values of height and width given, aspect ratio preserved.

           Minimum values of width and height given, aspect ratio preserved.

           Width and height emphatically given, original aspect ratio ignored.

           Change as per the supplied dimensions but only if an image
           dimension exceeds a specified dimension.

           Change dimensions only if both image dimensions exceed specified

           Resize image to have specified area in pixels. Aspect ratio is


       Tag filtering supports regular expression matching thanks to the 're'
       module of Python. All the filter matchings can be indicated to lazygal
       by successive uses of the 'filter-by-tag' option, or by giving a
       coma-separated list of keywords.

       We illustrate here how more elaorated tag filtering can be done.

       We want to export only the images that have the tags 'lazygal' AND

                   $ lazygal --filter-by-tag=lazygal --filter-by-tag=hiking


                   $ lazygal --filter-by-tag=lazygal,hiking

       We want to export the images that have the tags 'lazygal' OR 'hiking'.

                   $ lazygal --filter-by-tag="(lazygal|hiking)"

       We want to export the images that have one of the tags 'hiking_2012',
       'hiking_2013', 'hiking_France', etc.

                   $ lazygal --filter-by-tag="hiking_.*"

       We want to export the images that have the tag 'lazygal', AND one of
       the tags 'hiking_2012', 'hiking_2013', 'hiking_France', etc.

                   $ lazygal --filter-by-tag="lazygal,hiking_.*"



       More information is available on the program website:


       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 © 2010

  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to
Page load time: 0.113 seconds. Last modified: November 04 2018 12:49:43.