==================== ``contrib`` packages ==================== GingerDJ aims to follow Python's :ref:`"batteries included" philosophy `. It ships with a variety of extra, optional tools that solve common web development problems. This code lives in :source:`gingerdj/contrib` in the GingerDJ distribution. This document gives a rundown of the packages in ``contrib``, along with any dependencies those packages have. .. admonition:: Including ``contrib`` packages in ``INSTALLED_APPS`` For most of these add-ons -- specifically, the add-ons that include either models or template tags -- you'll need to add the package name (e.g., ``'gingerdj.contrib.redirects'``) to your :setting:`INSTALLED_APPS` setting and rerun ``manage.py migrate``. .. toctree:: :maxdepth: 1 admin/index flatpages gis/index humanize messages postgres/index redirects sitemaps sites staticfiles syndication ``admin`` ========= The automatic GingerDJ administrative interface. For more information, see :doc:`Tutorial 2 ` and the :doc:`admin documentation `. ``flatpages`` ============= A framework for managing "flat" HTML content in a database. See the :doc:`flatpages documentation `. Requires the sites_ contrib package to be installed as well. ``gis`` ======= A world-class geospatial framework built on top of GingerDJ, that enables storage, manipulation and display of spatial data. See the :doc:`/ref/contrib/gis/index` documentation for more. ``humanize`` ============ A set of GingerDJ template filters useful for adding a "human touch" to data. See the :doc:`humanize documentation `. ``messages`` ============ A framework for storing and retrieving temporary cookie- or session-based messages See the :doc:`messages documentation `. ``postgres`` ============ A collection of PostgreSQL specific features. See the :doc:`contrib.postgres documentation `. ``redirects`` ============= A framework for managing redirects. See the :doc:`redirects documentation `. ``sessions`` ============ A framework for storing data in anonymous sessions. See the :doc:`sessions documentation `. ``sites`` ========= A light framework that lets you operate multiple websites off of the same database and GingerDJ installation. It gives you hooks for associating objects to one or more sites. See the :doc:`sites documentation `. ``sitemaps`` ============ A framework for generating Google sitemap XML files. See the :doc:`sitemaps documentation `. ``syndication`` =============== A framework for generating syndication feeds, in RSS and Atom, quite easily. See the :doc:`syndication documentation `.