.. django-formrenderingtools documentation master file, created by
   sphinx-quickstart on Sat Apr 24 20:02:32 2010.

#########################
django-formrenderingtools
#########################

Customize layout of `Django forms`_ in templates, not in Python code.

Rather than using {{ form.as_p }} and Python code, set up and reuse templates
to render Django's form elements.

As an example, to reproduce Django's ``{{ form.as_p }}``:

.. code-block:: django

  {% load form_layouts %}
  <form>
    {% form layout="as_p" %}
    <input type="submit">
  </form>

For the impatient, jump to the :doc:`/demo` to discover and try the application
in a sandbox.

.. note::

   Django-formrenderingtools is not intended to customize widgets.
   Have a look at `django-floppyforms
   <http://pypi.python.org/pypi/django-floppyforms>`_ for this purpose.


********
Contents
********

.. toctree::
   :maxdepth: 2

   overview
   install
   demo
   reference/index
   migrate
   best_practices
   contribute
   about/index


*********
Resources
*********

* `Online documentation`_
* `PyPI page`_
* `Source code repository`_
* `Bugtracker`_


*******************
Credits and license
*******************

This application is published under the BSD license. See :doc:`about/LICENSE`
and :doc:`about/AUTHORS` for details.


.. _`Django forms`:
   https://docs.djangoproject.com/en/1.4/topics/forms/#customizing-the-form-template
.. _`Online documentation`:
   http://packages.python.org/django-formrenderingtools/
.. _`PyPI page`: http://pypi.python.org/pypi/django-formrenderingtools
.. _`Source code repository`:
   http://bitbucket.org/benoitbryon/django-formrenderingtools
.. _`Bugtracker`:
   http://bitbucket.org/benoitbryon/django-formrenderingtools/issues