added optional hashtag param to {% paginate %}
[django-pagination.git] / docs / install.txt
1 Installing the latest development version of django-pagination
2 ---------------------------------------------------------------
3
4 To install, first check out the latest version of the application from
5 subversion:
6
7     svn co http://django-pagination.googlecode.com/svn/trunk django-pagination
8
9 Now, link the inner ``pagination`` project to your Python path:
10
11     sudo ln -s `pwd`/pagination SITE_PACKAGES_DIR/pagination
12
13 If you don't know the location of your site packages directory, this hack might
14 do the trick for you:
15
16     sudo ln -s `pwd`/pagination `python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()"`/pagination
17     
18 Now it's installed!  Please see usage.txt for information on how to use this
19 application in your projects.
20
21 Installing via setup.py
22 -----------------------
23
24 Included with this application is a file named ``setup.py``.  It's possible to
25 use this file to install this application to your system, by invoking the
26 following command:
27
28     sudo python setup.py install
29
30 Once that's done, you should be able to begin using django-pagination at will.
31
32 Installing via setuptools
33 -------------------------
34
35 If you have setuptools_ installed, you can simply run the following command
36 to install django-pagination:
37
38     sudo easy_install django-pagination
39
40 .. _setuptools: http://peak.telecommunity.com/DevCenter/setuptools