分类与归档

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

归档页面

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

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 --


74 条评论 / 44 人参与
爱包子的鱼

分类数量

···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`


玄虚

时间 

建议数据库使用 UTC 时间 (django.utils.timezone.now()),而不是本地时间(datetime.datetime.now()),本地时间由 Django 自动转换。这样方便后期修改时区。

设置 settings.py 文件,配置 USE_TZ=True,即启用 UTC 时间。

解决 filter 时同时出现 year、month 无法查询的问题

不同数据库需求不一样

SQLite: install pytz — conversions are actually performed in Python.  

PostgreSQL: no requirements (see Time Zones).  

Oracle: no requirements (see Choosing a Time Zone File).  

MySQL: install pytz and load the time zone tables with mysql_tzinfo_to_sql.安装完 pytz 后,MySQL 需要导入时区 

Linux 和 MacOS: 

sudo mysql_tzinfo_to_sql /usr/share/zoneinfo/ | mysql -u root mysql 

Windows

先停止 mysqld.exe,到 https://dev.mysql.com/downloads/timezones.html 下载对应版本的时区文件,覆盖 mysql 安装目录下的 data\mysql 文件夹下的同名文件,重新启动 mysql.exe。 


BigOrange128 玄虚

请问POSIX 和 Non POSIX版本有什么区别,需要下载哪一个,测试可以解决这个问题吗?


vectorChange BigOrange128

POSIX 是系统接口的一个标准

如果你是windows的话,就是non posix

如果是其他系统,比如linux的话,就是遵守这个标准的,所以选的是posix,至于苹果之类的我就不是很清楚了


跬步郎的小步人生

'''

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'),

'''

请教博主,这两句如果用path来写的话,应该是怎么写法。我用的是python3.6+django2.04,django2.0以后是不是都不用url来写地址了?


追梦人物 [博主] 跬步郎的小步人生

请参考 django 2.0 关于 url pattern 的文档


light 跬步郎的小步人生
path('archives/<int:year>/<int:month>/', views.archives, name='archives'),
path('category/<int:pk>/', views.category, name='category'),

Gaterny

Exception Value:Cannot resolve keyword 'created_time_month' into field. Choices are: author, author_id, body, category, category_id, comment, created_time, excerpt, id, modified_time, tags, .....

点击归档跳转后报错,是怎么回事呢


追梦人物 [博主] Gaterny

created_time_month -> created_time__month 


吉超

一种使用regroup实现归档显示文章数量的方法

<div class="widget widget-archives">        <h3 class="widget-title">归档</h3>        {% archives as archiveslist %}
{% regroup archiveslist by create_time.year as year_post_group %}
<ul> {% for year in year_post_group %}
<li>{{ year.grouper }} 年
{% regroup year.list by create_time.month as month_post_group %}
<ul> {% for month in month_post_group %}
<li><a href="{% url 'blog:archives' year.grouper month.grouper %}">{{ month.grouper }} 月({{ month.list | length }})</a></li> {% endfor %}
</ul> </li> {% endfor %}
</ul> </div>

类似于这样

归档 

2018 年

6 月(1) 

1 月(6)


Dad Liu 吉超

你好,测试的时候出现了问题

create_time.year去掉created_time.时才会正确显示,下面的month同样,请问这是为什么?


隔壁王大爷200201 吉超

同一楼一样问题


EnjoyDark 吉超

兄弟,应该是{% regroup year.list by year month_post_group %},把create_time.year改成 year


EnjoyDark Dad Liu

吉超

1


Oak_Suen_Germany

test


Oak_Suen_Germany Oak_Suen_Germany

测试回复


Oak_Suen_Germany Oak_Suen_Germany

测试二级回复


NiceAir

博主你好,我想在侧边标签加上作者一栏,于是我就照着其他标签写了代码,可是在blog_tags.py这里处理的有问题,导致返回的是文章而不是作者。请指教一下

@register.simple_tag()
def get_author():
  return Post.objects.all()

cashlu NiceAir

你写的代码里return的所有Post对象。应该是Author对象才对。


gruiyuan

关于归档过滤不到月份的问题的问题,如果settings.py设置USE_TZ=True的话,可以使用系统的时区数据来填充mysql时区表,linux下命令如下:

shell> mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql


因为进入django命令行执行

>> print (Post.objects.filter(created_time__month=11 ).query)

可看到sql语句用来时区转换函数’CONVERT_TZ‘,然而mysql由于无法将’UTC‘,’Asia/Shanghai'等转化为具体时差,从而使得sql语句执行结果返回null


ELI gruiyuan

eli@eli-X450JF:~$ mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p 

Enter password: ERROR 1046 (3D000) at line 1: No database selected


请问需要指定数据库吗?


墨磨墨磨叽墨迹河H ELI

USE_TZ=True的话是指定默认时区而不是中国的时区所以会有八个小时的差异,只需要改成False就可以了


大圣______

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

---------------------

'blog:category'   ,我这里去掉“blog:”才正常,否则会报'blog' is not a registered namespace

urls.py 里加过app_name = 'blog',但也没用,有同样的么?


piupiuqm

post类的created_time用DateTimeField会报错,'datetime.date' object has no attribute 'tzinfo',导致不能顺利归档,而用DateField就没有问题。


fshgrym

alidationError at /archives/2017/10/['’2017‘ 必须为合法的日期格式,请使用 YYYY-MM-DD 格式。']

这个是什么问题呢


fshgrym fshgrym

已经解决,视图写少了year


Ramik0

请问一下,这个是什么错误0 0

 File "C:\Users\taota\Desktop\Workspace\blogproject\blog\urls.py", line 9, in <module>    + url(r'^category/(?P<pk>[0-9]+)/$', views.category, name='category'),TypeError: bad operand type for unary +: 'RegexURLPattern'


AAlion Ramik0

一样状况,应该是少了什么东西,我先把“+”去掉然后可以出来网址,但是网页还是错的,根据错误提示再改,发现其他错误了,最后还是把“+”加上了


whatghost_o

请问一下,归档时过滤不到月份是怎么一回事呢?

post_list = Post.objects.filter(created_time__year=year,created_time__month=month).order_by('-created_time')filter中有月份month时QuerySet为空,post_list = Post.objects.filter(created_time__year=year).order_by('-created_time')这样时QuerySet有值不为空。

使用filter过滤时间,只认年份不认月份是怎么回事呢?


whatghost_o whatghost_o

估计是我用了mysql的缘故


whatghost_o whatghost_o

把setting.py里的USE_TZ 设置成False就行了


Keh丶 whatghost_o

我也是这个问题,同MySQL,测试了一个小时,查数据库。。。最后被你解决了,表示非常感谢!!!


luoliang whatghost_o

我今天改了mysql没有这个问题,正常归档了文章!


林63930

请教下博主,在最新文章链接部分,你用的是{{ post.get_absolute_url }}来获取每个文章的url,而分类用的是{% url ‘blog: archives’ date.year date.month %},归档用的也是类似于分类,请问最新文章链接为什么不能用{% %}?两者区别在哪?


追梦人物 [博主] 林63930

没有区别,都是做同一个事情,只是 get abs url 进一步封装为模型方法,这样调用起来更加方便。


edsszw

安装pytz的作用是?


追梦人物 [博主] edsszw

django 处理时区需要依赖 pytz 这个模块


hxp-358
请教下博主,我手动输入分类和归档的链接可以正常跳转到正确页面,但是点击相应链接时只是在当前链接后再添加了一个井号,不跳转,也没有任何变化。不知道为啥 {% url %}标签没有起作用?

追梦人物 [博主] hxp-358
你用浏览器查看一下 a 标签的 href 是否是需要跳转的 url,有可能是你 url 写错了。注意 url 标签两边要加引号。

木二Lin
对比了下没有不一样的地方,但是老出现这个错误
Reverse for 'archives' with arguments '(2017, 8)' and keyword arguments '{}' not found. 0 pattern(s) tried: []

追梦人物 [博主] 木二Lin
看一看 archives 的代码以及模板中的相关代码

xueshichaoya
"这里 {% url %} 这个模板标签的作用是解析视图函数 blog:archives 对应的 URL 模式,并把 URL 模式中的年和月替换成 date.year,date.month 的值"

博主,这里{% url %}是解析视图函数(views.archives)吗?我个人理解哦:这里只是单纯的解析出了链接网址,视图函数这个时候还没有被调用。我改了rl(r'^archives/为rl(r'^archivesoooo/,然后鼠标右键复制归档链接网址是archivesoooo/,所以模板里‘blog:archives’应该是解析url,和视图函数无关,感觉这里说视图函数容易让人混淆啊。想了半天这里2333

追梦人物 [博主] xueshichaoya
对的,所以我说的是视图函数对应的 url 模式。

iicy
发现了一个bug,我在创建文章的时候填了创建和修改时间为2017-6-1 00:00 然后归档显示的是五月,然后点进去是没有文章的,然后改成六月一号则会出现六月的归档,然后点进去有两篇文章。请问这个是数据库的bug还是Python的问题?

追梦人物 [博主] iicy
这可能是时区问题(O_O)?具体也不清楚了。。

JamesLi
django.urls.exceptions.NoReverseMatch: Reverse for 'archives' with arguments '(2017, 7)' not found. 1 pattern(s) tried: ['archives/(?P[0-9]{4})/(P[0-9]{1,2})/$']

我这里出现了这个问题,但是我不知道该如何解决!求教如何排查?

追梦人物 [博主] JamesLi
仔细对比和示例项目中的 url 配置的不同,你这个是 django 找不到路由,说明很可能 url 配置写错了。

xueshichaoya 追梦人物 [博主]
第二个?P<>少了问号

种棵面包树
加入created_time__month=month 以后查不到数据了,是怎么回事?

种棵面包树 种棵面包树
USE_TZ = False 解决了!

一条具有时间跨度的单身狗1 种棵面包树
感谢兄弟,我也是,一开始以为是传值有问题,手动赋值发现还是查不到结果,但是只要一个年份的话发现又可以,完全没王 timezone 上面想,唉!

pursedream
请问报这个错是为什么?NoReverseMatch at /
Reverse for 'archives' with arguments '('', '')' and keyword arguments '{}' not found. 1 pattern(s) tried: ['archives/(?P[0-9]{4})/(?P[0-9]{1,2})/$']

urls是url(r'^archives/(?P[0-9]{4})/(?P[0-9]{1,2})/$', views.archives, name='archives'),

base.html是{{data.year}}年{{data.month}}月

pursedream pursedream
我傻了。。。。已解决

huchenwenbao pursedream
哎呀,,,我也出现这个问题 你是怎么解决的啊???

YoJohnDoe huchenwenbao

他urls.py 里 正则表达式没写<year> <month>


qingzhou412
还有{% url 'blog:category' category.pk %} category.pk 的值是从里获取到的啊

追梦人物 [博主] qingzhou412
同样的道理 for category in category_list

qingzhou412
{% url 'blog:archives' date.year date.month %} date.year, date.month是从哪里获取得到的啊?

追梦人物 [博主] qingzhou412
在循环中呀,我们使用模板标签获得了 date_list 模板变量。

JustBreaking
突然想到一个问题,分类和归档视图函数中,为什么用 index.html 而不用detail.html

追梦人物 [博主] JustBreaking
因为显示的是文章列表,而不是单篇文章。

JustBreaking 追梦人物 [博主]
之前搞混了,把归档想象成右侧边栏index和detail共有的了,实际上点击跳转后还是index.html模板

zhu520469
您好,看了您的文章,感觉很棒。请教下我现在侧边栏的归档日期出来了,显示了正确的归档分类,但点击进去是空的,我检查了blog.views和其他地方,都没有发现明显的错误,感觉像是月份没有日期没有匹配到,不知道哪里出了问题。

追梦人物 [博主] zhu520469
仔细对比一下 url 模式有没有写对?

zhu520469 追梦人物 [博主]
解决了,settings里面的 USE_TZ = False ,这样就可以了。

追梦人物 [博主] zhu520469
你使用的是 mysql 么?sqlite3 应该不会出现这种问题。

zhu520469 追梦人物 [博主]
是的,用的mysql

黑色的忧虑2011 zhu520469
赞一个!