easy_thumbnails - миниатюры

# settings.py

INSTALLED_APPS = (
    ...
    'easy_thumbnails',
)

Кофнигурирование

THUMBNAIL_ALIASES

Словарь, набор псевдонимов для определенной цели.

Цель - имя_приложения[.имя_модели[.имя_поля]].

THUMBNAIL_ALIASES = {
    "some_app.some_model.some_field": {
        "small": {
            # THUMBNAIL_DEFAULT_OPTIONS
        }
    }
}

THUMBNAIL_BASEDIR

Имя папки хранения миниатюр, находящейся в папке, где хранятся выгруженные файлы.

По умолчанию пустая строка.

THUMBNAIL_DEFAULT_OPTIONS

Словарь, параметры миниатюр по умолчанию.

По умолчанию None.

  • background - число, цвет фона края изображения при его увеличении

  • bw - булево, черно-белая миниатюра

  • crop - строка, обрезка изображения, величины задаются в процентах и через запятую.

    Первая - обрезка слева, если число отрицательное - справа.

    Вторая - обрезка сверху, если число отрицательное - снизу.

    Или можно задать smart для умной обрезки.

  • detail - булево, добавляет резкость

  • replace_alpha - число, цвет, которым будет заменены полупрозрачные участки изображения.

  • sharpen - булево, делает изображение более резким

  • size - кортеж, размеры миниатюр

  • target - кортеж, задает координаты центра изображения в процентах,

    относительно которого будет выполняться обрезка.

    По умолчанию - (50, 50)

  • upscale - булево, увеличивать слишком маленькие изображения

THUMBNAIL_DEFAULT_OPTIONS = {

    # обрезать слева на 10%
    "crop": "10, 0",

    # ширина будет вычислена согласно пропорции
    "size": (200, 0),

    # 50, 0
    "target": (None, 0),
}

THUMBNAIL_EXTENSIONS

Расширение файлов миниатюр.

По умолчанию jpg.

THUMBNAIL_HIGH_RESOLUTION

Булево, генерить миниатюры для экранов 4К и Retina.

По умолчанию False.

THUMBNAIL_PREFIX

Префикс для имен файлов миниатюр.

По умолчанию пустая строка.

THUMBNAIL_QUALITY

Качетсво jpg миниатюр, от 1 до 95.

По умолчанию 85.

THUMBNAIL_SUBDIR

Имя папки хранения миниатюр, находящейся в папке, где хранятся оригинальные файлы.

По умолчанию пустая строка.

THUMBNAIL_TRANSPARENCY_EXTENSION

Расширение файлов миниатюр, имеющих полупрозрачность.

По умолчанию png.

Шаблон

{% load thumbnail %}

<!-- вывод миниатюры по алиасу -->
<img src="{{ some_record.thumbnail|thumbnail_url:'some_alis' }}">

<!-- вывод дефолтного изображения -->
<img src="{{ some_record.thumbnail|default:'default.jpg' }}">


{% thumbnail some_record.thumbnail 200x100 sharpen %}

{% thumbnail some_record.thumbnail 'some_alias' %}