many many many Varia's websites, work in progress: https://many.vvvvvvaria.org

Luke Murphy 8ab74a15e2 Add foobar		5 years ago
..
test_data	Add foobar	5 years ago
Readme.md	Add foobar	5 years ago
__init__.py	Add foobar	5 years ago
test_thumbnails.py	Add foobar	5 years ago
thumbnailer.py	Add foobar	5 years ago

Readme.md

Thumbnail Creation of images

This plugin creates thumbnails for all of the images found under a specific directory, in various thumbnail sizes. It requires PIL to function properly since PIL is used to resize the images, and the thumbnail will only be re-built if it doesn't already exist (to save processing time).

Installation

Set up like any other plugin, making sure to set PLUGIN_PATH and add thumbnailer to the PLUGINS list.

PIL or Pillow is required. If you choose Pillow, you need to install some additional external libraries to add support for image types like jpg.

Configuration

IMAGE_PATH is the path to the image directory. It should reside inside your content directory, and defaults to "pictures".
THUMBNAIL_DIR is the path to the output sub-directory where the thumbnails are generated.
THUMBNAIL_SIZES is a dictionary mapping size name to size specifications. The generated filename will be originalname_thumbnailname.ext unless THUMBNAIL_KEEP_NAME is set.
THUMBNAIL_KEEP_NAME is a Boolean that, if set, puts the file with the original name in a thumbnailname folder, named like the key in THUMBNAIL_SIZES.
THUMBNAIL_KEEP_TREE is a Boolean that, if set, saves the image directory tree.
THUMBNAIL_INCLUDE_REGEX is an optional string that is used as regular expression to restrict thumbnailing to matching files. By default all files not starting with a dot are respected.

Sizes can be specified using any of the following formats:

wxh will resize to exactly wxh cropping as necessary to get that size
wx? will resize so that the width is the specified size, and the height will scale to retain aspect ratio
?xh same as wx? but will height being a set size
s is a shorthand for wxh where w=h