This release is a pre-release and may not be stable for production use.
The powerful, yet easy to implement thumbnailing application for Django.
To install this application into your project, just add it to your INSTALLED_APPS setting (and run manage.py syncdb):
INSTALLED_APPS = (
...
'easy_thumbnails',
)
Template usage
To generate thumbnails in your template, use the {% thumbnail %} tag. To make this tag available for use in your template, use:
{% load thumbnail %}
Basic tag Syntax:
{% thumbnail [source] [size] [options] %}
source must be a File object, usually an Image/FileField of a model instance.
size can either be:
the size in the format [width]x[height] (for example, {% thumbnail person.photo 100x50 %}) or
a variable containing a valid size (i.e. either a string in the [width]x[height] format or a tuple containing two integers): {% thumbnail person.photo size_var %}.
options are a space separated list of options which are used when processing the image to a thumbnail such as sharpen, crop and quality=90.
Model usage
You can use the ThumbnailerField or ThumbnailerImageField fields (based on FileField and ImageField, respectively) for easier access to retrieve (or generate) thumbnail images.
By passing a resize_source argument to the ThumbnailerImageField, you can resize the source image before it is saved:
class Profile(models.Model):
user = models.ForeignKey('auth.User')
avatar = ThumbnailerImageField(
upload_to='avatars',
resize_source=dict(size=(50, 50), crop='smart'),
)
Lower level usage
Thumbnails are generated with a Thumbnailer instance. Usually you’ll use the get_thumbnailer method to generate one of these, for example:
from easy_thumbnails.files import get_thumbnailer
def square_thumbnail(source):
thumbnail_options = dict(size=(100, 100), crop=True, bw=True)
return get_thumbnailer(source).get_thumbnail(thumbnail_options)
See the docs directory for more comprehensive usage documentation.
2 maintainers
Metadata
2 maintainers
Release files for easy-thumbnails 1.0-alpha-19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| easy-thumbnails-1.0-alpha-19.tar.gz | 38.8 kB | Details |
Release files / easy-thumbnails-1.0-alpha-19.tar.gz
| Download URL | easy-thumbnails-1.0-alpha-19.tar.gz |
|---|---|
| Size | 38.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4a6cbc94c66c913820b0cd88b8d3dfdd3e1bceb30db1e5509b7a567a50dd9bc8
|
|
BLAKE2b-256 checksum How to use checksums |
d6e99a03c176890395e3a82435f7f9b2f3a13ef4c0fcb82ae3594b36b5db2095
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
