From fbc082c4e7ebf4f9a56e5792460edfa78ab9b878 Mon Sep 17 00:00:00 2001 From: floguy Date: Sun, 13 Jul 2008 22:02:56 +0000 Subject: [PATCH 1/1] OK rst2a is caching too long, so I have generated docs in docs/index.html git-svn-id: https://django-pagination.googlecode.com/svn/trunk@20 7f1efe38-554e-0410-b69d-834cb44da2d5 --- docs/index.html | 352 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 352 insertions(+) create mode 100644 docs/index.html diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..d838d18 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,352 @@ + + + + + + +How to use django-pagination + + + +

How to use django-pagination

django-pagination allows for easy Digg-style pagination without modifying +your views.

There are really 5 steps to setting it up with your projects (not including +installation, which is covered in INSTALL.txt in this same directory.)

List this application in the INSTALLED_APPS portion of your settings +file. Your settings file might look something like:
+
```
+INSTALLED_APPS = (
+    # ...
+    'pagination',
+)
+
```
+

Install the pagination middleware. Your settings file might look something +like:

+MIDDLEWARE_CLASSES = (
+    # ...
+    'pagination.middleware.PaginationMiddleware',
+)
+

Add this line at the top of your template to load the pagination tags:
+
+
{% load pagination_tags %}
+
+
Decide on a variable that you would like to paginate, and use the +autopaginate tag on that variable before iterating over it. This could +take one of two forms (using the canonical object_list as an example +variable):
+
+
{% autopaginate object_list %}
+
+
This assumes that you would like to have the default 20 results per page. +If you would like to specify your own amount of results per page, you can +specify that like so:
+
+
{% autopaginate object_list 10 %}
+
+
Note that this replaces object_list with the list for the current page, so +you can iterate over the object_list like you normally would.
+
Now you want to display the current page and the available pages, so +somewhere after having used autopaginate, use the paginate inclusion tag:
+
+
{% paginate %}
+
+
This does not take any arguments, but does assume that you have already +called autopaginate, so make sure to do so first.
+

That's it! You have now paginated object_list and given users of the site +a way to navigate between the different pages--all without touching your views.

+ + \ No newline at end of file -- 2.20.1