# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-django-pure-pagination
VERSION=		0.3.0
KEYWORDS=		python devel
VARIANTS=		py35 py36
SDESC[py35]=		Django advanced paginator (PY 35)
SDESC[py36]=		Django advanced paginator (PY 36)
HOMEPAGE=		https://github.com/jamespacileo/django-pure-pagination/
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPI/d/django-pure-pagination
DISTFILE[1]=		django-pure-pagination-0.3.0.tar.gz:main
DF_INDEX=		1
SPKGS[py35]=		single
SPKGS[py36]=		single

OPTIONS_AVAILABLE=	PY35 PY36
OPTIONS_STANDARD=	none
VOPTS[py35]=		PY35=ON PY36=OFF
VOPTS[py36]=		PY35=OFF PY36=ON

DISTNAME=		django-pure-pagination-0.3.0

GENERATED=		yes

[PY35].USES_ON=				python:py35

[PY36].USES_ON=				python:py36

post-patch:
	${REINPLACE_CMD} 's/[\d128-\d255]//g' ${WRKSRC}/README.rst

[FILE:2828:descriptions/desc.single]
======================
django-pure-pagination
======================

.. image::
https://travis-ci.org/hovel/django-pure-pagination.svg?branch=master
    :target: https://travis-ci.org/hovel/django-pure-pagination

Description
======================

:Author:
    James Pacileo `@ignighted <http://twitter.com/ignighted>`_

:Version:
    0.3.0

:Description:
    django-pure-pagination provides advanced pagination features and is
fully compatible with existing code based on Django's core pagination
module. (aka no need to rewrite code!)

:Requirements:
    Django 1.7+

:Contributors:
    `juandecarrion (Juande Carrion) <https://github.com/juandecarrion>`_,
`twidi (Stéphane Angel) <https://github.com/twidi>`_, `bebraw (Juho
Vepsäläinen) <https://github.com/bebraw>`_, `lampslave ()
<https://github.com/lampslave>`_, `GeyseR (Sergey Fursov)
<https://github.com/GeyseR>`_, `zeus (Pavel Zhukov)
<https://github.com/zeus>`_


Introduction
============

The django app offers advanced pagination features without forcing major
code changes within an existing project.

Django-pure-pagination is based upon Django's core pagination module and
is therefore compatible with the existing api.

`Documentation for Django core pagination module
<http://docs.djangoproject.com/en/dev/topics/pagination/>`_

Features
--------

1. Uses same API as **django.core.pagination** and therefore is fully
compatible with existing code.

2. Has dynamic query string creation, which takes into consideration
existing GET parameters.

3. Out-of-the-box html rendering of the pagination

4. Additional methods make it easier to render more advanced pagination
templates.


Installation
------------

Install package from PYPI:

::

    pip install django-pure-pagination

or clone and install from repository:

::

    git clone git@github.com:jamespacileo/django-pure-pagination.git
    cd django-pure-pagination
    python setup.py install

Add `pure_pagination` to INSTALLED_APPS

::

    INSTALLED_APPS = (
        ...
        'pure_pagination',
    )

Finally substitute **from django.core.paginator import Paginator** with
**from pure_pagination import Paginator**

Settings
--------

A few settings can be set within settings.py

::

    PAGINATION_SETTINGS = {
        'PAGE_RANGE_DISPLAYED': 10,
        'MARGIN_PAGES_DISPLAYED': 2,

        'SHOW_FIRST_PAGE_WHEN_INVALID': True,
    }

**PAGE_RANGE_DISPLAYED** is the number of pages neighbouring the current
page which will be displayed (default is 10)

**MARGIN_PAGES_DISPLAYED** is the number of pages neighbouring the first
and last page which will be displayed (default is 2)

Set **SHOW_FIRST_PAGE_WHEN_INVALID** to True when you want to just show
first page when provided invalid page instead of 404 error

.. image:: http://i.imgur.com/LCqrt.gif

Usage example
-------------



[FILE:114:distinfo]
02b42561b8afb09f1fb6ac6dc81db13374f5f748640f31c8160a374274b54713        10857 django-pure-pagination-0.3.0.tar.gz