文章分页功能
文章多起来了,我们就需要一个分页功能了,像这样:
如何添加上这个功能呢?Django自带有分页功能的,但我们这里使用一个处理分页的第三方插件linaro-django-pagination。
安装方法
$ pip install linaro-django-pagination
设置
插件的设置是在settings.py中进行的,我们进行以下设置:
1.添加到INSTALL_APP,像这样:
INSTALLED_APPS = (
# …
‘linaro_django_pagination’,
)
2.安装中间件:
MIDDLEWARE_CLASSES = (
# …
‘linaro_django_pagination.middleware.PaginationMiddleware’,
)
3.设置TEMPLATE_CONTEXT_PROCESSORS
这里需要注意一下,Django 1.6之后,在settings.py已没有这一项了,而只作为了一个默认设置项存在的,你可以Shell中查看认项:
In [1]: from django.conf import settings
In [2]: settings.TEMPLATE_CONTEXT_PROCESSORS
Out[2]:
(‘django.contrib.auth.context_processors.auth’,
‘django.core.context_processors.debug’,
‘django.core.context_processors.i18n’,
‘django.core.context_processors.media’,
‘django.core.context_processors.static’,
‘django.core.context_processors.tz’,
‘django.contrib.messages.context_processors.messages’)
需要注意的是.media和.static这两项。如果你安照linaro-django-pagination文档设置的话,你会发现,你的静态文件无法被浏览器解析了。原因是模版中使用到的参数{{ STATIC_URL}}没有被传递进去,所以.static这项是必须添加上的。
在这里,你需要添加上:
“django.core.context_processors.request”,
4.设置每页显示项数
关于显示项目,可以有两个地方进行设置,一是在settings.py中,二是在模版文件中,方式分别为:
settings.py
PAGINATION_DEFAULT_PAGINATION = 2 # 默认值是20
在模版中
{% autopaginate object_list 10 %}
由于我们模版就一个地方使用到分页,所以我们就直接放到settings.py中。暂时设置为每页两项,主要是为了调试样式之类,等开发完成,再行修改即可。
使用
使用是在模版中进行的,分三步:
第一步,载入插件:
{% load pagination_tags %}
第二步,添加自动分页到项目遍历之前:
{% autopaginate posts %}
第三步,显示分页:
在你想要显示的地方,一般为整个项目遍历完成的地方:
{% paginate %}
整个代码如下:
{% extends “base.html” %}
{% load pagination_tags %}
{% block title %}{% if is_category %}“{{ cate_name|safe }}”文章列表{% else %}首页{% endif %}{% endblock %}
{% block content %}
{% if is_category %}
{% block rightside %}
{% include “blog/_side.html” %}
{% endblock %}
然后我们就可以看到分页了。
如何自定义分页样式
尽管我们看到了分页,而且也能正常使用的,但和我们的CSS样式不太配合得起来,因为我们可以自己重新来调整一下,使用自定义的模版,只需要在templates/下创建一个与插件模版相同的目录及文件名就行了。最简单的办法就是直接从插件中复制到我们的项目目录中来,然后再生新调整即可。
templates/pagination/pagination.html内容为:
{% if is_paginated %}
{% load i18n %}
- {% block previouslink %} {% if page_obj.has_previous %}
- {{ previous_link_decorator|safe }}{% trans "previous" %}
- {% else %} {% if display_disabled_previous_link %}
- {{ previous_link_decorator|safe }}{% trans "previous" %}
- {% endif %} {% endif %} {% endblock previouslink %} {% block pagelinks %} {% if display_page_links %} {% for page in pages %} {% if page %} {% ifequal page page_obj.number %}
- {{ page }}
- {% else %}
- {{ page }}
- {% endifequal %} {% else %}
- ...
- {% endif %} {% endfor %} {% endif %} {% endblock pagelinks %} {% block nextlink %} {% if page_obj.has_next %}
- {% trans "next" %}{{ next_link_decorator|safe }}
- {% else %} {% if display_disabled_next_link %}
- {% trans "next" %}{{ next_link_decorator|safe }}
- {% endif %} {% endif %} {% endblock nextlink %}