django-autocomplete / docs / installation.rst

Installation

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 setup.py install from a terminal to install it.

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 http://bitbucket.org/tyrion/django-autocomplete/

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

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 {{ form.media }} in your template's <head> otherwise the Javascript won't be loaded.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.