sorl-defined-thumbnail 0.0.1

sorl-defined-thumbnails
=======================

这是一个在标准sorl-thumbnails之上的插件，它将您的缩略图创建限制在预定义的大小集。

在您的设置中定义缩略图大小

SORL_DEFINED_THUMBNAILS = {
'small_cropped': {
'size': (50, 50),
'options': {
'crop': 'center'
}
},
'small': {
'size': (50, 50),
},
'medium': {
'size': (350, 350),
},
'medium_cropped': {
'size': (350, 350),
'options': {
'crop': 'center'
}
},
}


在您的`INSTALLED_APPS`中添加 **之前** `sorl.thumbnail`

INSTALLED_APPS = (
'defined_thumbnails',
'sorl.thumbnail',
)

这很重要，因为`{% thumbnail %}`模板标记将被新的一个覆盖。

用法
-----

此应用程序提供两个模板标记`{% dthumbnail %}`并覆盖了标准的`{% thumbnail %}`，因此现在它使用命名缩略图而不是任意参数。

现在在您的模板中做

{% load thumbnail %}

{% block content %}
{% thumbnail object.pic_field "medium" as thumb %}
<img src="{{thumb.url}}"/>
{% endthumbnail %}

{% endblock %}

您也可以继续使用标准语法

{% thumbnail object.pic_field "350x350" crop="center "as thumb %}

只要输入的参数与定义的大小匹配。

当使用严格模式时，如果参数与命名缩略图不匹配，模板标记将引发语法错误，否则它们将只会被记录。

或者，您可以使用`{% dthumbnail %}`标记，该标记类似于覆盖的`{% thumbnail %}`标记，但始终是严格的。此标记还接受`{% empty %}`并关闭`{% endthumbnail %}`。

迁移
---------

默认情况下，新的模板标记将允许您继续使用在`SORL_DEFINED_THUMBNAILS`中未定义的旧几何形状。
如果您想引发错误，将`SORL_DEFINED_STRICT`设置为`True`。

查找所有模板出现
-------------------------------

./manage.py thumbnail_tags find_bad

将在模板中显示所有`{% thumbnail %}`标签的实例。


查找所有要转换的模板
--------------------------------

此应用包含一个管理命令，将在所有应用目录和模板目录中查找`thumbnail`标签的匹配项。

./manage.py thumbnail_tags find_bad

它将打印出模板中`{% thumbnail %}`标签的所有使用情况


建议定义哪些尺寸
-----------------------------

./manage.py thumbnail_tags suggest_sizes

将统计模板中找到的所有`{% thumbnail %}`标签，并显示每种几何形状/选项组合的实例。

这应该有助于您找到在模板中需要创建的尺寸，以使改动最小。