Metadata-Version: 1.1
Name: django-thumbs
Version: 0.4
Summary: Django-Thumbs is the easiest way to create thumbnails for your images with Django. Works with any StorageBackend.
Home-page: https://github.com/skitoo/django-thumbs
Author: Antonio Melé
Author-email: antonio.mele@gmail.com
License: New BSD License
Description: =============
        Django-thumbs
        =============
        
        The easiest way to create thumbnails for your images with Django. Works with any StorageBackend.
        
        
        Features
        ========
          
        * Easy to integrate in your code (no database changes, works as an ImageField)
        * Works perfectly with any StorageBackend
        * Generates thumbnails after image is uploaded into memory
        * Deletes thumbnails when the image file is deleted
        * Provides easy access to the thumbnails' URLs (similar method as with ImageField)
        
        
        Requirements
        ============
        
        * Python 2.5+
        * Django 1.1+
        * PIL (Python Image Library)
        
        
        Getting It
        ==========
        
        You can get Django-Thumbs by using pip or easy_install:
        
        ::
        
          $ pip install django-thumbs
          or
          $ easy_install django-thumbs
        
        If you want to install it from source, grab the git repository from github and run setup.py:
        
        ::
        
          $ git clone git://github.com/skitoo/django-thumbs.git
          $ cd django-thumbs
          $ python setup.py install
        
        
        Installation
        ============
        
        * Import it in your models.py and replace ImageField with ImageWithThumbsField in your model
        * Add a sizes attribute with a list of sizes you want to use for the thumbnails
        * Make sure your have defined MEDIA_URL in your settings.py
        * That's it!
        
        Working example
        ===============
        
        ::
        
            from django.db import models
            from django_thumbs.db.models import ImageWithThumbsField
        
            class Person(models.Model):
                photo = ImageWithThumbsField(upload_to='images', sizes=((125,125),(200,200)))
                second_photo = ImageWithThumbsField(upload_to='images')
        
        In this example we have a Person model with 2 image fields.
        
        You can see the field second_photo doesn't have a sizes attribute. This field works exactly the same way as a normal ImageField.
        
        The field photo has a sizes attribute specifying desired sizes for the thumbnails. This field works the same way as ImageField but it also creates the desired thumbnails when uploading a new file and deletes the thumbnails when deleting the file.
        
        With ImageField you retrieve the URL for the image with: someone.photo.url With ImageWithThumbsField you retrieve it the same way. You also retrieve the URL for every thumbnail specifying its size: In this example we use someone.photo.url_125x125 and someone.photo.url_200x200 to get the URL of both thumbnails.
        
        Uninstall
        =========
        At any time you can go back and use ImageField again without altering the database or anything else. Just replace ImageWithThumbsField with ImageField again and make sure you delete the sizes attribute. Everything will work the same way it worked before using django-thumbs. Just remember to delete generated thumbnails in the case you don't want to have them anymore.
        
        
Keywords: django thumbs image
Platform: OS Independent
Classifier: Development Status :: 4 - Beta
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.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
