.. Django Grappelli documentation master file, created by
   sphinx-quickstart on Sun Dec  5 19:11:46 2010.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.
.. |grappelli| replace:: Grappelli
.. |filebrowser| replace:: FileBrowser
.. |grappelliversion| replace:: 2.12.2

.. _index:

Documentation
=============

**A jazzy skin for the Django admin interface**.

This documentation covers version |version| of |grappelli|. |grappelli| is a grid-based alternative/extension to the `Django <http://www.djangoproject.com>`_ administration interface.

.. note::
    |grappelli| |version| requires Django 2.1. More on :ref:`versions`.

Installation & Setup
--------------------

.. toctree::
   :maxdepth: 2

   quickstart
   customization

Dashboard
---------

.. toctree::
   :maxdepth: 2

   dashboard_setup
   dashboard_api

Internals
---------

.. toctree::
   :maxdepth: 2

   internals

Help
----

.. toctree::
   :maxdepth: 2

   help
   contributing
   changelog

Code
----

https://github.com/sehmaschine/django-grappelli

Website
-------

http://www.grappelliproject.com

Discussion
----------

Use the `Grappelli Google Group <http://groups.google.com/group/django-grappelli>`_ to ask questions or discuss features.

.. _versions:

Versions and Compatibility
--------------------------

**Grappelli is always developed against the latest stable Django release and is NOT tested with Django's master branch.**

* Grappelli 2.12.1 (November 1st, 2018): Compatible with Django 2.1
* Grappelli 2.11.2 (November 1st, 2018): Compatible with Django 2.0
* Grappelli 2.10.4 (November 1st, 2018): Compatible with Django 1.11

Current development branches:

* Grappelli 2.12.2 (Development version for Django 2.1, see branch Stable/2.12.x)
* Grappelli 2.11.3 (Development version for Django 2.0, see branch Stable/2.11.x)
* Grappelli 2.10.5 (Development version for Django 1.11, see branch Stable/2.10.x)

Older versions are available at GitHub, but are not supported anymore.
Support for 2.10.x and 2.9.x is limited to security issues and very important bugfixes.
