django-autocomplete / docs / installation.rst

Full commit
tyrion cc8bd50 

tyrion 9b78904 

tyrion cc8bd50 

tyrion 9b78904 
tyrion cc8bd50 

tyrion 9b78904 

Luke Plant f315ec8 

tyrion 9b78904 


Installing the stable version

You can install Django AutoComplete with `pip`_ or `easy_install`_::

    pip install django-autocomplete
    easy_install django-autocomplete

Alternatively you can download the `last stable release`_ from the Python
Package Index and run ``python install`` from a terminal to
install it.

.. _`pip`:
.. _`easy_install`:
.. _`last stable release`:

Installing the development version

To get the latest updates and bug fixes install the developement version.
You can do this by cloning the Mercurial repository with::

    $ hg clone

Then you have to put the :file:`autocomplete` directory under your

To update your local repository run the following commands from the
:file:`django-autocomplete` directory::

    $ hg pull
    $ hg update

Serving the media files

In order to work properly Django AutoComplete needs some javascript files.
These files are contained in the :file:`autocomplete/media` directory and
*must* be served from your ``{{ STATIC_URL }}``. This is easiest to achieve
by adding ``'autocomplete'`` to your ``INSTALLED_APPS`` and using
the built-in support for static files in Django 1.3 and above.

.. note::

    Remember to put ``{{ }}`` in your template's <head> otherwise
    the Javascript won't be loaded.

.. seealso::

    `Static Files <>`_
        How to correctly serve static files.

        How to customize the media files of Django AutoComplete.

.. _`How to serve static files`: