X-Git-Url: https://git.mdrn.pl/django-pagination.git/blobdiff_plain/2070c8aa195202070e433ee75b2a6dc32db68f36..fbc082c4e7ebf4f9a56e5792460edfa78ab9b878:/docs/index.html?ds=sidebyside 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 @@ + + + +
+ + +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.
+