.. default-domain:: py

================================================
django-tables2 - An app for creating HTML tables
================================================

Its features include:

- Any iterable can be a data-source, but special support for Django QuerySets is included.
- The built in UI does not rely on JavaScript.
- Support for automatic table generation based on a Django model.
- Supports custom column functionality via subclassing.
- Pagination.
- Column based table sorting.
- Template tag to enable trivial rendering to HTML.
- Generic view mixin.


About the app:

- `Available on pypi <https://pypi.python.org/pypi/django-tables2>`_
- Tested against currently supported versions of Django
  `and the python versions Django supports <https://docs.djangoproject.com/en/dev/faq/install/#what-python-version-can-i-use-with-django>`_
- `Documentation on readthedocs.org <https://django-tables2.readthedocs.io/en/latest/>`_
- `Bug tracker <http://github.com/jieter/django-tables2/issues>`_


Table of contents
-----------------

.. toctree::
    :maxdepth: 1
    :caption: Getting started

    pages/installation
    pages/tutorial
    pages/table-data

.. toctree::
    :maxdepth: 1
    :caption: Customization

    pages/custom-data
    pages/ordering
    pages/column-attributes
    pages/column-headers-and-footers
    pages/swapping-columns
    pages/pagination
    pages/table-mixins
    pages/custom-rendering
    pages/query-string-fields
    pages/localization-control
    pages/generic-mixins
    pages/pinned-rows
    pages/filtering
    pages/export

.. toctree::
    :maxdepth: 1
    :caption: Reference

    pages/reference
    pages/faq
    pages/upgrade-changelog
    pages/glossary