.. _Python: https://www.python.org/ .. _Django: https://www.djangoproject.com/ .. _sorl-thumbnail: https://github.com/jazzband/sorl-thumbnail

==================
Django smart media

A suit of tools to use a FileField to upload image with light SVG support, include thumbnail preview in field and a template tag around sorl-thumbnail_ library.

Dependencies

Python_>=3.9;
Django_>=4.0,<5.1;
sorl-thumbnail_>=12.9.0;

Overview

Concretely this contains:

Form widgets to build HTML for a FileField either with or without clearable
mode. Both mode have a version to include needed layout assets (CSS and Javascript)
and another one without assets;
Form fields which already set a "smart" widget;
Templates to build the widgets HTML;
CSS and Javascript for the widget layout;
Field validator;
Model signals to purge stale files;
Model field with all "smart" features;
A template tag to make thumbnail safely with SVG image (original SVG is just used
without Sorl raising issue for a non bitmap image);
Some helpers to ease some specific implementations;

Although this can work with ImageField, SVG support will only work with FileField since ImageField rely on PIL that does not support SVG format.

Links

Read the documentation on Read the docs <https://django-smart-media.readthedocs.io/>_;
Download its PyPi package <https://pypi.python.org/pypi/django-smart-media>_;
Clone it on its Github repository <https://github.com/sveetch/django-smart-media>_;