<commit_before>=====================
django-image-cropping
=====================

.. image:: https://pypip.in/v/django-image-cropping/badge.png
    :target: https://pypi.python.org/pypi/django-image-cropping

.. image:: https://travis-ci.org/jonasundderwolf/django-image-cropping.png?branch=master
    :target: http://travis-ci.org/jonasundderwolf/django-image-cropping
    :alt: Build Status

.. image:: https://coveralls.io/repos/jonasundderwolf/django-image-cropping/badge.png?branch=master
    :target: https://coveralls.io/r/jonasundderwolf/django-image-cropping
    :alt: Coverage

django-image-cropping is an app for cropping uploaded images via Django's admin backend using `Jcrop
<https://github.com/tapmodo/Jcrop>`_.

Screenshot:

.. image:: http://www.jonasundderwolf.de/media/images/django_image_cropping_example.png

django-image-cropping is perfect when you need images with a specific size for your templates but want your
users or editors to upload images of any dimension. It presents a selection with a fixed aspect ratio so your users
can't break the layout with oddly-sized images.

The original images are kept intact and only get cropped when they are displayed.
Large images are presented in a small format, so even very big images can easily be cropped.

The necessary fields, widgets and a template tag for displaying the
cropped image in your templates are provided.

Also works with `FeinCMS <https://github.com/feincms/feincms>`_ content types!

Installation
============

#. Install django-image-cropping using ``pip``::

    pip install django-image-cropping

#. Add ``easy_thumbnails`` and ``image_cropping`` to your ``INSTALLED_APPS``.

#. Adjust the thumbnail processors for ``easy-thumbnails`` in your ``settings``::

    from easy_thumbnails.conf import Settings as thumbnail_settings
    THUMBNAIL_PROCESSORS = (
        'image_cropping.thumbnail_processors.crop_corners',
    ) + thumbnail_settings.THUMBNAIL_PROCESSORS<commit_msg>Update README [fixes #56]<commit_after>=====================
django-image-cropping
=====================

.. image:: https://pypip.in/v/django-image-cropping/badge.png
    :target: https://pypi.python.org/pypi/django-image-cropping

.. image:: https://travis-ci.org/jonasundderwolf/django-image-cropping.png?branch=master
    :target: http://travis-ci.org/jonasundderwolf/django-image-cropping
    :alt: Build Status

.. image:: https://coveralls.io/repos/jonasundderwolf/django-image-cropping/badge.png?branch=master
    :target: https://coveralls.io/r/jonasundderwolf/django-image-cropping
    :alt: Coverage

django-image-cropping is an app for cropping uploaded images via Django's admin backend using `Jcrop
<https://github.com/tapmodo/Jcrop>`_.

Screenshot:

.. image:: http://www.jonasundderwolf.de/media/images/django_image_cropping_example.png

django-image-cropping is perfect when you need images with a specific size for your templates but want your
users or editors to upload images of any dimension. It presents a selection with a fixed aspect ratio so your users
can't break the layout with oddly-sized images.

The original images are kept intact and only get cropped when they are displayed.
Large images are presented in a small format, so even very big images can easily be cropped.

The necessary fields, widgets and a template tag for displaying the
cropped image in your templates are provided.

Also works with `FeinCMS <https://github.com/feincms/feincms>`_ content types!

Installation
============

#. Install django-image-cropping using ``pip``::

    pip install django-image-cropping
    
#. If you haven't installed easy_thumbnails already, install it::

    pip install easy_thumbnails

#. Add ``easy_thumbnails`` and ``image_cropping`` to your ``INSTALLED_APPS``.

#. Adjust the thumbnail processors for ``easy-thumbnails`` in your ``settings``::

    from easy_thumbnails.conf import Settings as thumbnail_settings
    THUMBNAIL_PROCESSORS = (
        'image_cropping.thumbnail_processors.crop_corners',
    ) + thumbnail_settings.THUMBNAIL_PROCESSORS
{'fraction_non_alphanumeric': 0.12265547877591312, 'fraction_numerical': 0.0004935834155972359, 'mean_word_length': 4.621359223300971, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 14, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7672958', 'n_tokens_mistral': 1274, 'n_tokens_neox': 1199, 'n_words': 355}