forked from varia/varia.website
many many many Varia's websites, work in progress: https://many.vvvvvvaria.org
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
manetta
7535649f56
|
5 years ago | |
---|---|---|
.. | ||
test_data | 5 years ago | |
Readme.md | 5 years ago | |
__init__.py | 5 years ago | |
test_thumbnails.py | 5 years ago | |
thumbnailer.py | 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 beoriginalname_thumbnailname.ext
unlessTHUMBNAIL_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 inTHUMBNAIL_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