分类与归档

29134 91 2017年4月13日

侧边栏已经正确地显示了最新文章列表、归档、分类等信息。现在来完善归档和分类功能,当用户点击归档下的某个日期或者分类下的某个分类时,跳转到文章列表页面,显示该日期或者分类下的全部文章。

归档页面

要显示某个归档日期下的文章列表,思路和显示主页文章列表是一样的,回顾一下主页视图的代码:

blog/views.py

def index(request):
    post_list = Post.objects.all().order_by('-created_time')
    return render(request, 'blog/index.html', context={'post_list': post_list})

主页视图函数中我们通过 Post.objects.all() 获取全部文章,而在我们的归档和分类视图中,我们不再使用 all 方法获取全部文章,而是使用 filter 来根据条件过滤。先来看归档视图:

blog/views.py

def archives(request, year, month):
    post_list = Post.objects.filter(created_time__year=year,
                                    created_time__month=month
                                    ).order_by('-created_time')
    return render(request, 'blog/index.html', context={'post_list': post_list})

这里我们使用了模型管理器(objects)的 filter 函数来过滤文章。由于是按照日期归档,因此这里根据文章发表的年和月来过滤。具体来说,就是根据 created_timeyearmonth 属性过滤,筛选出文章发表在对应的 year 年和 month 月的文章。注意这里 created_time 是 Python 的 date 对象,其有一个 yearmonth 属性,我们在 页面侧边栏:使用自定义模板标签 使用过这个属性。Python 中类实例调用属性的方法通常是 created_time.year,但是由于这里作为函数的参数列表,所以 Django 要求我们把点替换成了两个下划线,即 created_time__year。同时和 index 视图中一样,我们对返回的文章列表进行了排序。此外由于归档的下的文章列表的显示和首页是一样的,因此我们直接渲染了index.html 模板。

写好视图函数后就是配置好 URL:

blog/urls.py

from django.conf.urls import url

from . import views

app_name = 'blog'
urlpatterns = [
    url(r'^$', views.index, name='index'),
    url(r'^post/(?P<pk>[0-9]+)/$', views.detail, name='detail'),
    + url(r'^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$', views.archives, name='archives'),
]

这个归档视图对应的 URL 的正则表达式和 detail 视图函数对应的 URL 是类似的,这在之前我们讲过。两个括号括起来的地方是两个命名组参数,Django 会从用户访问的 URL 中自动提取这两个参数的值,然后传递给其对应的视图函数。例如如果用户想查看 2017 年 3 月下的全部文章,他访问 /archives/2017/3/,那么 archives 视图函数的实际调用为:archives(request, year=2017, month=3)

在模板找到归档列表部分的代码,修改超链接的 href 属性,让用户点击超链接后跳转到文章归档页面:

templates/base.html

{% for date in date_list %}
<li>
  <a href="{% url 'blog:archives' date.year date.month %}">
    {{ date.year }} 年 {{ date.month }} 月
  </a>
</li>
{% endfor %}

这里 {% url %} 这个模板标签的作用是解析视图函数 blog:archives 对应的 URL 模式,并把 URL 模式中的年和月替换成 date.yeardate.month 的值。例如 blog:archives 表示 blog 应用下的 archives 函数,这个函数对应的 URL 模式为 ^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$,假设 date.year=2017date.month=5,那么 {% url 'blog:archives' date.year date.month %} 模板标签返回的值为/archives/2017/5/。

为什么要使用 {% url %} 模板标签呢?事实上,我们把超链接的 href 属性设置为 /archives/{{ date.year }}/{{ date.month }}/ 同样可以达到目的,但是这种写法是硬编码的。虽然现在 blog:archives 视图函数对应的 URL 模式是这种形式,但是如果哪天这个模式改变了呢?如果使用了硬编码的写法,那你需要把每一处 /archives/{{ date.year }}/{{ date.month }}/ 修改为新的模式。但如果使用了 {% url %} 模板标签,则不用做任何修改。

测试一下,点击侧边栏归档的日期,跳转到归档页面,发现报了个错误,提示没有安装 pytz。激活虚拟环境,使用 pip install pytz 安装即可。

重启一下开发服务器,再次测试,发现可以显示归档下的文章列表了。

分类页面

同样的写好分类页面的视图函数:

blog/views.py

import markdown

from django.shortcuts import render, get_object_or_404

# 引入 Category 类
from .models import Post, Category

def category(request, pk):
    # 记得在开始部分导入 Category 类
    cate = get_object_or_404(Category, pk=pk)
    post_list = Post.objects.filter(category=cate).order_by('-created_time')
    return render(request, 'blog/index.html', context={'post_list': post_list})

这里我们首先根据传入的 pk 值(也就是被访问的分类的 id 值)从数据库中获取到这个分类。get_object_or_404 函数和 detail 视图中一样,其作用是如果用户访问的分类不存在,则返回一个 404 错误页面以提示用户访问的资源不存在。然后我们通过 filter 函数过滤出了该分类下的全部文章。同样也和首页视图中一样对返回的文章列表进行了排序。

URL 配置如下:

blog/urls.py

from django.conf.urls import url

from . import views

app_name = 'blog'
urlpatterns = [
    url(r'^$', views.index, name='index'),
    url(r'^post/(?P<pk>[0-9]+)/$', views.detail, name='detail'),
    url(r'^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$', views.archives, name='archives'),
    + url(r'^category/(?P<pk>[0-9]+)/$', views.category, name='category'),
]

这个分类页面对应的 URL 模式和文章详情页面对应的 URL 模式十分类似,你可以自己分析分析它是如何工作的,在此就不赘述了。

修改相应模板:

templates/base.html

{% for category in category_list %}
<li>
  <a href="{% url 'blog:category' category.pk %}">{{ category.name }}</a>
</li>
{% endfor %}

同样,{% url %} 模板标签的用法和写归档页面时的用法是一样的。现在尝试点击相应的链接,就可以跳转到归档或者分类页面了。

总结

本章节的代码位于:Step11: category and archive

如果遇到问题,请通过下面的方式寻求帮助。

  • 在下方评论区留言。
  • 将问题的详细描述通过邮件发送到 djangostudyteam@163.com,一般会在 24 小时内回复。
  • Pythonzhcn 社区的新手问答版块 发布帖子。

-- EOF --

最后更新:2018-11-11 12:21:12

91 条评论 / 51 人参与
BigOrange128

关于时区问题的具体解决方法,根据楼上玄虚大佬的提示,查阅资料后整理了一下。

http://139.224.13.65/post/13/


白土梁 BigOrange128

我mysql也是按月份归档不出来,还不像你们是按月份空的,我直接就是报错

按年份能查出来

In [58]: Page.objects.filter(created_time__year=2019) 

Out[58]: <QuerySet [<Page: test44444444>]> 

按月份直接报错

In [59]: Page.objects.filter(created_time__month=6)
Out[59]: ---------------------------------------------------------------------------
TypeError                                 Traceback (most recent call last)
D:\IDE\python3\lib\site-packages\IPython\core\formatters.py in __call__(self, obj)
    700                 type_pprinters=self.type_printers,
    701                 deferred_pprinters=self.deferred_printers)
--> 702             printer.pretty(obj)
    703             printer.flush()
    704             return stream.getvalue()
前边还有一堆报错
D:\IDE\python3\lib\site-packages\django\db\models\lookups.py in process_lhs(self, compiler, connection, lhs)
    155         db_type = self.lhs.output_field.db_type(connection=connection)
    156         lhs_sql = connection.ops.field_cast_sql(
--> 157             db_type, field_internal_type) % lhs_sql
    158         lhs_sql = connection.ops.lookup_cast(self.lookup_name, field_internal_type) % lhs_sql
    159         return lhs_sql, list(params)

TypeError: not all arguments converted during string formatting

setting里边已经设置false了:

TIME_ZONE = 'Asia/Shanghai'
USE_I18N = Tru
USE_L10N = True
USE_TZ = False

是不是跟我同时设置了数据库的时区有关系,有没有大佬给个建议?我用sqlite试过了是没问题的可以正常归档

mysql> SELECT @@global.time_zone;
+--------------------+
| @@global.time_zone |
+--------------------+
| Asia/Shanghai      |
+--------------------+
1 row in set (0.00 sec)

白土梁 白土梁

view.py

def archives(request, year, month):
page_list = Page.objects.filter(created_time__year=year, created_time__month=month).order_by('-created_time')
return render(request, 'blog/index.html', context={'page_list': page_list})

blog_tag.py

def archives():
return Page.objects.dates('created_time', 'month', order='DESC')

smallsnail

楼主之前是把blogproject文件下的settings中的时区设置为上海的,再安装pytz,没有问题,而我之前设置的是成都,安装pytz后识别不了,给大家说声,这个问题也是好半天才解决,,,


硬核玩家陆一默

'archives' did not receive value(s) for the argument(s): 'request', 'year', 'month'

楼主这个情况是什么 感觉像是参数没传进去 但是代码都一样的

{% archives as date_list %}

问题出在这一样


硬核玩家陆一默 硬核玩家陆一默

我用的是mysql数据库


追梦人物 [博主] 硬核玩家陆一默

archives是视图函数,你无法在模板中调用。


SamK6517433923

请问, 这里为什么使用{% url %}模板标签 而不使用前几章节提到get_absolute_url自定义方法? 在HTML里面都是在href使用到, 两者有什么区别,现在有点混乱了。

下面是自己的理解,请纠正一下,谢谢大神

get_absolute_url方法

html设定文章标题点击触发时,将调用get_absolute_url自定义方法,该方法调用blog:detail 视图函数并传参pk值,视图函数再渲染模板

{% url %}模板标签

html设定按时间分类归档点击触发时,将调用blog:archives 视图函数并传参year 和 month ,视图函数再渲染模板


追梦人物 [博主] SamK6517433923

本质上 {% url %}模板标签和 get_absolute_url 方法都调用了同一个底层方法。定义 get_absolute_url 是因为和某个特定的 model 相关,是为了调用方便,在模板中使用时其实完全可以用 {% url %}模板标签替换。


SamK6517433923 追梦人物 [博主]

好的,谢谢大神!


DewangYang

请问,为什么说在函数的参数列表要替换为两个下划线:“Python 中类实例调用属性的方法通常是 created_time.year,但是由于这里作为函数的参数列表,所以 Django 要求我们把点替换成了两个下划线,即 created_time__year。”?


追梦人物 [博主] DewangYang

因为如果写成 created_time.year=2018 不就成了赋值么?而 django 其实要做 created_time.year=2018 的查询操作,created_time__year=2018 在底层会转为 sql 查询操作。


nonozone

为啥我把detail.html里的文章分类链接改成

<a href="{% url 'blog:category' category.pk %}">

就出错了呢?


nonozone

django2.1.4

归档url 出错,提示:

Could not parse the remainder: 'date.year' from ''blog:archives'date.year'

这是哪里出了问题呢


nonozone nonozone

艾玛,知道问题在哪儿了。


<a href="{% url 'blog:archives' date.year date.month %}">

'blog:archives' 后面一定要有一个空格...


爱包子的鱼

分类数量

···html

<h3 class="widget-title">分类</h3>{% get_categories as category_list %}<ul>    {% for category in category_list %}    <li>        <a href="{% url 'blog:category' category.pk %}">{{ category.name }}<span class="post-count">({{ category.post_set.count }})</span></a>    </li>    {% empty %}    还没有分类    {% endfor %}</ul>

```


爱包子的鱼 爱包子的鱼
<h3 class="widget-title">分类</h3>
{% get_categories as category_list %}
<ul>
    {% for category in category_list %}
    <li>
        <a href="{% url 'blog:category' category.pk %}">{{ category.name }}<span class="post-count">({{ category.post_set.count }})</span></a>
    </li>
    {% empty %}
    还没有分类
    {% endfor %}
</ul>

Arrowarcher 爱包子的鱼

兄弟强啊,{{ category.post_set.count }}这个确实有用


Arrowarcher Arrowarcher

反查询


xuyy2

我也遇到了无法识别month的问题,更改mysql 的timezone 也不成功;

然后我把代码改了下,能成功的显示了

def archives(request, year, month): 

dayMax = 30 

months = [1, 3, 5, 7, 8, 10, 12]

if int(month) in months: 

 dayMax = 31 

 post_list = Post.objects.filter( 

 created_time__range=(

datetime.date(int(year), int(month), 1), 

datetime.date(int(year), int(month), dayMax)

)).order_by('-created_time')


xuyy2

`hello world`