Skip to content

hamole/django-daguerre

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README

Django Daguerre makes it easy to adjust images on-the-fly without slowing down your templates and without needing to generate everything ahead of time with a cron job. You don't need to make any changes to your models; it Just Works.

{% load daguerre %}
<img src="{% adjust my_model.image "fill" width=200 height=400 %}" />

{% adjust_bulk my_queryset "method.image" "fill" width=200 height=400 as adjusted_list %}
{% for my_model, image in adjusted_list %}
  <img src="{{ image }}" />
{% endfor %}
code

http://github.com/littleweaver/django-daguerre

docs

http://readthedocs.org/docs/django-daguerre/

build status

build-image

Requirements

  • Python 2.7+, 3.3+
  • Pillow 2.3.0+
  • Django 1.7+
  • Six 1.5.2+

Daguerre may work with earlier versions of these packages, but they are not officially supported.

Upgrading from 1.0.X

Daguerre 2.1 and up use native Django migrations. If you are migrating from Daguerre 1.0, and you have manually created data (for example Areas) that you want to preserve, you must first upgrade to Daguerre 2.0, run the migrations included in that version, and then upgrade to Daguerre 2.1.

This migration path would look as follows:

$ cd path/to/my/project
$ pip install django-daguerre==2.0.0
$ python manage.py migrate daguerre
$ pip install -U django-daguerre
$ python manage.py migrate daguerre 0001 --fake
$ python manage.py migrate daguerre

If you don't have any manual data to preserve, and if it would not adversely affect your site, you can also use the following migration path:

$ cd path/to/my/project
$ python manage.py migrate daguerre zero # Or manually delete the daguerre tables
$ pip install -U django-daguerre
$ python manage.py migrate daguerre
$ python manage.py daguerre clean

Installation

You can install the latest version of Daguerre using pip:

$ pip install django-daguerre

You can clone the repository yourself at https://github.com/littleweaver/django-daguerre.

python

Setup

Ensure that 'daguerre' is in your project's INSTALLED_APPS:

INSTALLED_APPS = (
    'daguerre',
    ...
)

Add the following or similar anywhere in your URLconf:

urlpatterns = patterns('',
    url(r'^daguerre/', include('daguerre.urls')),
    ...
)

Testing

We recommend running tox from the repository's root directory, but you can also run test_project/manage.py test daguerre.

About

On-the-fly image manipulation for Django.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 75.3%
  • JavaScript 18.1%
  • Makefile 3.1%
  • Shell 2.8%
  • CSS 0.7%