Quickstart¶
Installation¶
pip install pillow # default image engine, not necessary if another engine is used
pip install python-thumbnails
Dependencies¶
This project has configurable parts that depends on other modules. In order to
use those the dependencies need to be installed, e.g. to use the PillowEngine
which is the default image engine one has to install pillow.
Usage¶
Using python-thumbnails can be as little effort as calling get_thumbnail
. It
works without configuration, even in Django projects.
from thumbnails import get_thumbnail
get_thumbnail('path/to/image.png', '300x300', crop='center')
Configuration¶
It is possible to put settings in a Python module and specify it with the
environment variable THUMBNAILS_SETTINGS_MODULE
.
Django projects¶
This project integrates with Django without any specific configuration, put your thumbnails settings
within your Django settings and you should be good to go. However, if you want to use the
templatetag it is necessary to add thumbnails
to installed apps:
INSTALLED_APPS = (
# your other apps
'thumbnails',
)
Flask projects¶
Use THUMBNAILS_SETTINGS_MODULE
as described above. Better integrations with
Flask is planned in feature versions.