Metadata-Version: 1.1
Name: django-thumbnail-maker
Version: 0.0.4
Summary: Thumbnail maker for Django
Home-page: https://github.com/infinityxxx/django-thumbnail-maker
Author: Tamara Khalbashkeeva
Author-email: infinityxxx@gmail.com
License: BSD
Description: 
        Auto-generator of thumbnails for Django, using sorl-thumbnail.
        
        Features
        ========
        
        - Auto-genarates thumbnails using sorl-thumbnail while uploading (saving) images
        - You can use any engines & plugins you usually use with sorl-thumbnail
        - The application does not replace thumbnail templatetag and you can use everything you want from sorl-thumbnail
        - Command to auto-generate missing thumbnails
        
        How to Use
        ==========
        
        Get the code
        ------------
        
        Get the code for the latest stable release use pip::
        
           $ pip install django-thumbnail-maker
        
        Configure your project
        -----------------------
        
        Register ``'thumbnail_maker'``, in the ``INSTALLED_APPS`` section of
        your project's settings::
        
            INSTALLED_APPS = (
                'django.contrib.auth',
                'django.contrib.admin',
                'django.contrib.sites',
                'django.contrib.comments',
                'django.contrib.sessions',
                'django.contrib.messages',
                'django.contrib.contenttypes',
        
                'thumbnail_maker',
            )
        
        Set up required thumb formats in ``THUMBNAIL_MAKER_FORMATS`` dictionary.
        Keys are the names for your formats (could be any string).
        Values are tuples of length 2: first element is a geometry string (used in ``sorl-thumbnail``),
        second is a dictionary with options (``crop``, ``quality``, ``padding``, ``format``, etc.)::
        
            THUMBNAIL_MAKER_FORMATS = {
               'banner':   ('400x300', {'crop': 'center',
                                        'quality': 90}),
               '50x50':    ('50x50',   {}),
               'any_name': ('5x277',   {'padding': True})
           }
        
        Set up your model's field
        -------------------------
        
        Use ``ImageWithThumbnailsField`` and ``thumbs`` option, where ``thumbs`` is a tuple of thumb format names
        (keys from ``THUMBNAIL_MAKER_FORMATS`` dictionary)::
        
            from django.db import models
            from thumbnail_maker import ImageWithThumbnailsField
        
            class Item(models.Model):
                image = ImageWithThumbnailsField(
                    upload_to='somewhere',
                    thumbs=('banner', '50x50'),
                )
        
        
        Templates usage
        ---------------
        
        All of the examples assume that you first load the ``thumbnail_maker`` template tag in
        your template::
        
            {% load thumbnail_maker %}
        
        A simple usage::
        
            {% usethumbnail item.image "banner" as im %}
                <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
            {% endusethumbnail %}
        
            {% usethumbnail item.image "50x50" as im %}
                <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
            {% endusethumbnail %}
        
        You can also use string paths instead of image objects::
        
            {% usethumbnail "dummy/image.png" "50x50" as im %}
                <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}">
            {% endusethumbnail %}
        
        Management commands usage
        -------------------------
        
        Django-thumbnail-maker comes with a manage.py command to generate missing thumbs.
        You can use it while ::
        
            ./manage.py make_thumbnails <app>.<model> <field>
        
        In case you want to make all thumbs replacing old ones, use ``--force`` option::
            
            ./manage.py make_thumbnails --force <app>.<model> <field>
        
Platform: any
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia :: Graphics
