Metadata-Version: 1.1
Name: django-webp-doubles
Version: 0.1
Summary: A Django app to create webp-doubles.
Home-page: https://www.example.com/
Author: Gosudareva Elizaveta
Author-email: eleriya-25@yandex.ru
License: MIT
Description: ====================
        DJANGO WEBP DOUBLES
        ====================
        
        Приложение django-webp-doubles предназначено для осуществления отдачи webp-изображений
        без существенных изменений в кодовую базу django-проектов:
        
        1. Создание webp-изображений,
        для каждого jpg/png-изображения.
        
        2. webp-дубль сохраняется с тем же названием и в ту же папку, что и оригинал,
        напр. /some/path/image.jpg и /some/path/image.webp.
        
        3. Прокси-сервер (в данном случае nginx), используемый для отдачи статики и медиа,
        оценивает, поддерживает ли обращающийся браузер webp-изображения,
        и если да - отдает webp-изображение, в противном случае - jpg-оригинал.
        
        
        Установка
        ---------
        
        1. Добавьте приложение в INSTALLED_APPS:
        
        .. code-block::
        
            INSTALLED_APPS = [
                ...
                'webp_images',
            ]
        
        
        2. Перечислите модели и их поля, содержащие изображения, для которых необходима поддержка webp-изображений в настройках проекта:
        
        .. code-block::
        
            MODELS_WITH_IMAGES_FOR_WEBP = {
                'core.Gallery': ['desktop_image', 'mobile_image', ],
                'core.GalleryItem': ['image', ],
                'core.News': ['main_image', ],
                'core.Page': ['image', ],
                ...
            }
        
        Допустимо указывать поля типа: ImageField и FilerImageField.
        
        3. Запустите комманду ``python manage.py create_webp_doubles``, чтобы сформировать webp-дубли уже сохраненных изображений.
        Данный шаг необходим только при установке приложения в уже работающий проект с сохраненными изображения.
        В дальнейшем, webp-дубли будут формироваться автоматически при сохраненнии моделей.
        
        4. Добавьте в конфигурацию nginx-сервера следующий сервис:
        
        .. code-block::
        
            server {
                listen 9001;
                allow 127.0.0.1;
                deny all;
        
                # подразумевается, что
                # static - /usr/share/nginx/html/static
                # media -  /usr/share/nginx/html/media
                root   /usr/share/nginx/html;
        
                if ($uri ~ ^/(\d+|-)x(\d+|-)/) {
                    set $w $1;
                    set $h $2;
                }
        
                # Замена оригинального изображения на webp-дубль, при условии поддержки браузером webp-формата
                if ($http_accept ~* "webp") {
                    rewrite ^(.*)\.(jpg|jpeg|png)$ $1.webp last;
                }
        
                # Обрезка webp-изображений
                location ~ ^/(?:\d+|-)x(?:\d+|-)/crop(/(static|media)/.*)\.(?:webp|WEBP)$ {
                    try_files $1.webp $1.jpg $1.jpeg $1.png;
                    image_filter_buffer 20M;
                    image_filter crop $w $h;
                    image_filter_interlace on;
                    expires max;
        
                    break;
                }
        
                # Ресайзинг webp-изображений
                location ~ ^/(?:\d+|-)x(?:\d+|-)(/(static|media)/.*)\.(?:webp|WEBP)$ {
                    try_files $1.webp $1.jpg $1.jpeg $1.png;
                    image_filter_buffer 20M;
                    image_filter resize $w $h;
                    image_filter_interlace on;
                    expires max;
        
                    break;
                }
        
                # Обрезка оригинальных изображений
                location ~ ^/(?:\d+|-)x(?:\d+|-)/crop(/(static|media)/.*)\.(?:jpg|JPG|jpeg|JPEG|gif|GIF|png|PNG)$ {
                    rewrite ^/[\w\d-]+/crop(.*)$ /$1;
                    image_filter_buffer 20M;
                    image_filter crop $w $h;
                    image_filter_interlace on;
                    expires max;
        
                    break;
                }
        
                # Ресайзинг оригинальных изображений
                location ~ ^/(?:\d+|-)x(?:\d+|-)(/(static|media)/.*)\.(?:jpg|JPG|jpeg|JPEG|gif|GIF|png|PNG)$ {
                    rewrite ^/[\w\d-]+/(.*)$ /$1;
                    image_filter_buffer 20M;
                    image_filter resize $w $h;
                    image_filter_interlace on;
                    expires max;
        
                    break;
                }
        
                location ~ ^(/(static|media)/.*)\.webp$ {
                    try_files $1.webp $1.jpg $1.jpeg $1.png;
                    expires max;
                }
            }
        
        5. Разместите перенаправления в данный сервис в основных частях конфигурации:
        
        .. code-block::
        
            server {
                ...
        
                location ~ ^/(static|media|(?:\d+|-)x(?:\d+|-))/.*\.(jpg|JPG|jpeg|JPEG|gif|GIF|png|PNG|webp|WEBP)$ {
                    proxy_pass        http://127.0.0.1:9001;
                    proxy_set_header Accept $http_accept;
                    expires max;
                }
        
                ...
        
            }
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
