sorl-thumbnail 12.5.0

测试

这些测试应该与毒物和脓毒性测试一起进行。运行tox将对所有环境运行所有测试。 但是，可以运行具有tox-e<；env>；的特定环境，这是所有环境的列表 可通过tox-l找到。这些测试需要在 文件。可以使用 回购协议中的流浪者文件。

获取代码

使用“pip”获取最新稳定版本的代码。

$ pip install sorl-thumbnail

在项目中安装

然后在的“已安装应用程序”部分注册“sorl.thumbnail” 项目的设置。

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.admin',
    'django.contrib.sites',
    'django.contrib.comments',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.contenttypes',

    'sorl.thumbnail',
)

模板使用

所有的例子都假设您首先在 您的模板。

{% load thumbnail %}

简单的用法。

{% thumbnail item.image "100x100" crop="center" as im %}
    <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
{% endthumbnail %}

请参见文档中Template examples部分的更多示例

模型使用

使用ImageField自动删除对键中自身的引用 值存储及其缩略图引用以及删除时的缩略图文件。

from django.db import models
from sorl.thumbnail import ImageField

class Item(models.Model):
    image = ImageField(upload_to='whatever')

参见文档中Model examples部分的更多示例

低水平api

您可以使用“获取缩略图”：

from sorl.thumbnail import get_thumbnail
from sorl.thumbnail import delete

im = get_thumbnail(my_file, '100x100', crop='center', quality=99)
delete(my_file)

请参阅文档中Low level API examples部分的更多示例

与其他缩略图结合使用

或者，您可以通过{%load sorl_thumbnail%}加载模板标记。 而不是传统的{%load thumbnail%}。它在 使用多个缩略图库的项目 templateTag模块的相同名称（thumbnail）：

{% load sorl_thumbnail %}
{% thumbnail item.image "100x100" crop="center" as im %}
    <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
{% endthumbnail %}