django-pagination 1.0.7

如何使用django-pagination

django-pagination 允许您在不修改视图的情况下轻松实现Digg风格的分页。

设置此项目需要5个步骤（不包括安装，安装说明在相同目录下的INSTALL.txt中）。

1. 在您的设置文件的INSTALLED_APPS部分列出此应用程序。您的设置文件可能看起来像这样

   INSTALLED_APPS = (
       # ...
       'pagination',
   )

2. 安装分页中间件。您的设置文件可能看起来像这样

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

3. 如果您的设置中尚未添加，请添加请求上下文处理器。请注意，上下文处理器默认情况下是隐式设置的，因此要显式设置它们，您需要将此代码复制并粘贴到您的下方的值TEMPLATE_CONTEXT_PROCESSORS中

   ("django.core.context_processors.auth",
   "django.core.context_processors.debug",
   "django.core.context_processors.i18n",
   "django.core.context_processors.media",
   "django.core.context_processors.request")

4. 在您的模板顶部添加此行以加载分页标签

   {% load pagination_tags %}

5. 决定您想要分页的变量，并在迭代它之前使用autopaginate标签。这可能有两种形式（以object_list为例变量）

   {% autopaginate object_list %}

   这假设您希望每页有默认的20个结果。如果您希望指定每页的结果数量，可以像这样指定

   {% autopaginate object_list 10 %}

   请注意，这会将object_list替换为当前页面的列表，因此您可以像通常一样遍历object_list。

6. 现在，您想要显示当前页面和可用页面，所以在使用autopaginate之后，请在某个地方使用分页包含标签

   {% paginate %}

   这不需要任何参数，但它假设您已经调用了autopaginate，因此请确保先这样做。

就这样！您现在已经分页了object_list，并让网站用户能够在不同的页面之间导航——而无需触及您的视图。

可选设置

在django-pagination中，没有必需的设置。然而，有一小套可选设置，有助于更改分页标签的默认行为。以下是概述

PAGINATION_DEFAULT_PAGINATION

如果没有指定数字，则在页面上显示的项目默认数量。

PAGINATION_DEFAULT_WINDOW

显示当前页面的左右两侧的项目数量（考虑省略号）。

PAGINATION_DEFAULT_ORPHANS

允许的孤儿数量。根据Django文档，孤儿被定义为

The minimum number of items allowed on the last page, defaults to zero.

PAGINATION_INVALID_PAGE_RAISES_404

确定无效页面是否引发Http404或仅设置invalid_page上下文变量。如果为True，则前者执行，如果为False，则后者执行。