Installation

Install the django-templatequery package from the Python Package Index with one of the following commands:

easy_install django-templatequery

or:

pip intall django-templatequery

If you want to use the templatetags that come with django-templatequery you need to put 'django_templatequery' to the end of your INSTALLED_APPS setting.

Please note: It maybe is a risk to make the templatetags available for template designers. It is possible that they have access to models which they shouldn't have. Only do this if you trust the people that work on your templates!

Usage

to be written ...

Playing around

If you just want to play around with the code without installing in your system you can use the example project the code repository contains. Branch the code from launchpad with a simple bzr branch django-templatequery and cd to django-templatequery/example. Here you have a pretty standard django project with a manage.py and a settings.py.

Start coding

In the case you want to contribute to the code I recommend the following steps:

1. get a copy of the development repository from launchpad with bzr branch lp:django-templatequery
2. cd into the branch directory
3. run python bootstrap.py and python bin/buildout (this will setup the development environtment using buildout)
4. check if the testsuite is passing: bin/test
5. dive into the code below src/ and start hacking.