Ticket #9215: pagination.diff

docs/topics/pagination.txt

@@ -75 +75 @@
-    objects such as Django's ``QuerySet`` to use a more efficient ``count()``
-    method when available.
-
+
+Implementation Example
+======================
+
+A working example of a view and accompanying template might look like this, 
+assuming you want to display a multi-page listing of an existing "Contacts" 
+model: 
+
+In :file:`views.py`: ::
+
+    from django.core.paginator import Paginator, InvalidPage, EmptyPage
+
+    def listing(request):
+        contact_list = Contacts.objects.all()
+        paginator = Paginator(contact_list, 25) # Show 25 contacts per page
+
+        # Make sure page request is an int. If not, deliver first page.
+        try:
+            page = int(request.GET.get('page', '1'))
+        except ValueError:
+            page = 1
+       
+        # If page request (9999) is out of range, deliver last page of results.
+        try:
+            contacts = paginator.page(page)
+        except (EmptyPage, InvalidPage):
+            contacts = paginator.page(paginator.num_pages)
+
+        return render_to_response(
+            'list.html', 
+            locals(), 
+            context_instance=RequestContext(request)
+        )
+
+In template :file:`list.html`, you'll want navigation between pages. 
+Note that you can simply output the page object as ``{{ contacts }}`` to
+render the "page *n* of pages" information.::
+
+    {% for contact in contacts.object_list %}
+        {{ contact.full_name|upper }}<br />
+        ...
+    {% endfor %}
+
+    <div class="pagination">
+        <span class="step-links">
+        {% if contacts.has_previous %}<a href="?page={{ contacts.previous_page_number }}" 
+            class="util-link">previous</a>{% endif %} 
+        <span class="current">
+            {{ contacts }}
+        </span>
+        {% if contacts.has_next %}<a href="?page={{ contacts.next_page_number }}" 
+            class="util-link">next</a>{% endif %} 
+        </span>
+    </div>
+    
+
-``Paginator`` objects
-=====================
-