分类、归档和标签页

2019-09-0713436 阅读26 评论

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

归档页面

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

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 archive(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.urls import path

from . import views

app_name = 'blog'
urlpatterns = [
    path('', views.index, name='index'),
    path('posts/<int:pk>/', views.detail, name='detail'),
    path('archives/<int:year>/<int:month>/', views.archive, name='archive'),
]

这个归档视图对应的 URL 和 detail 视图函数对应的 URL 是类似的,这在之前我们讲过,django 会从用户访问的 URL 中自动提取 URL 路径参数转换器 <type:name> 规则捕获的值,然后传递给其对应的视图函数。例如如果用户想查看 2017 年 3 月下的全部文章,他访问 /archives/2017/3/,那么 URL 转换器就会根据规则捕获到 2017 和 3 这两个整数,然后作为参数传给 archive 视图函数, archive 视图函数的实际调用为:archive(request, year=2017, month=3)

接下来在 inclusions 文件夹下找到 archives 的模板,修改超链接的 href 属性,让用户点击超链接后跳转到文章归档页面:

inclusions/_archives.html

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

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

{% url %} 模板标签接收的第一个参数为被解析视图函数的端点值,这个端点值由 2 部分组成,中间由冒号分隔。第一部分为在应用的 urls.py 中指定的 app_name 的值(充当命名空间,这样即使不同 app 下有相同的视图函数名,也不会冲突),第二部分 path 函数中传入的 name 参数的值。比如在 blog 应用的 urls.py 模块,我们指定了 app_name = 'blog'archive 视图函数的 url 模式为 path('archives/<int:year>/<int:month>/', views.archive, name='archive'),因此对应的端点值为 blog:archive

{% url %} 模板标签接收的其它参数为 URL 路径参数,即 URL 模式中路径参数转换器需要捕获的值。例如 archive 视图函数对应的 URL 模式为 archives/<int:year>/<int:month>/,假设 date.year=2017date.month=5,那么 {% url 'blog:archive' date.year date.month %} 模板标签返回的值为 /archives/2017/5/。

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

测试一下,点击侧边栏归档的日期,跳转到归档页面,发现显示的就是归档下的文章列表。

分类页面

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

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

urlpatterns = [
    path('archives/<int:year>/<int:month>/', views.archive, name='archive'),
    path('categories/<int:pk>/', views.category, name='category'),
]

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

修改相应模板:

inclusions/_categories.html

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

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

标签页面

标签页和分类是完全一样的步骤,因此稍微修改一下分类相关的代码就可以用于标签了。

blog/views.py

from .models import Category, Post, Tag

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

可以看到和 category 几乎一样,只是这里根据 tag 来筛选文章。

然后是配置 url:

from django.urls import path

from . import views

app_name = 'blog'
urlpatterns = [
    ...
    path('categories/<int:pk>/', views.category, name='category'),
    path('tags/<int:pk>/', views.tag, name='tag'),
]

再修改一下 inclusions\_tags.html 模板中的跳转链接:

...
{% for tag in tag_list %}
  <li>
    <a href="{% url 'blog:tag' tag.pk %}">{{ tag.name }}</a>
  </li>
{% empty %}
    暂无标签!
{% endfor %}
...

侧边栏的功能这里差不多就都做完了。

-- EOF --

26 评论
登录后回复
Feko
2022-08-15 18:30:59

通过+1

回复
_北国烟雨
2020-06-10 22:23:08

请问一下这里可以通过插入万年历实现归档吗

回复
金兴
2020-04-23 22:52:52

{% url 'comments:comment' article_id %}与/comment/{{ article_id }}的区别不知道是咋回事 但是后者可以正常使用,前者报Reverse for 'comment' with arguments '('',)' not found. 1 pattern(s) tried: ['comment\/(?P[0-9]+)$']

回复
下_地_干_活 金兴
2020-06-27 23:13:07

前面那个改成
{% url 'comments:comments' article.id %} 试试

回复
sun98989898
2020-04-17 19:25:49

您好,我的归档那里点击时间没有出现文章,也没有报错,会是什么原因???

回复
sun98989898 sun98989898
2020-04-17 19:30:21

看到下面的评论已解决,我的数据库是MySQL,感谢。

回复
YAO ZELIANG
2020-04-05 01:35:50

回复
Chen_github
2020-02-25 21:02:22

好像分类旁边的文章数量没有改掉,自己动手实现去了

回复
clearlies
2019-11-15 18:20:41

归档部分代码图片.png
但是无法查询到数据,时间参数已经传递过来了图片.png
显示数据时空的,但是数据库有数据,图片.png
这个是因为时间的保存格式不对导致的吗?

回复
clearlies clearlies
2019-11-15 18:28:18

图片不能发送吗:
1、归档部分代码

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

2、终端显示日期已经传进来了,但是数据确查询不到:
2019 11

3、数据库里保存的时间数据:
2019-11-13 09:36:00.000000
2019-11-14 08:27:55.275822

回复
小清新 clearlies
2020-01-01 11:31:40

在settings.py里面,修改USE_TZ设置为False

回复
Chen_github 小清新
2020-02-25 01:33:35

这真是个神坑!我从头到尾看了半天逻辑就是没问题,但是就是拿到空数组,气死了...

回复
追梦人物 Chen_github
2020-02-25 11:06:44

~ ~,MySQL 数据库需要进行额外的时区设置。

回复
追梦人物 clearlies
2020-02-25 11:50:37

暂时不能发图片。
数据库是 Sqilte 还是 MySQL?
MySQL 需要进行额外的时区设置

回复
zhubiaook clearlies
2020-05-29 19:42:15

在自建的MySQL数据库中,时区表mysql.time_zone默认是空的,而Django配置文件settings中若配置了USE_TZ = True,则Django使用的数据库查询语句是带时区的。导致从MySQL中查询不到数据。
解决方法有两种:
1. 设置USE_TZ=False

# USE_TZ=False时的MySQL语句
print(Article.objects.filter(created_time__month=5).query)
SELECT
    `blog_article`.`id`,
    `blog_article`.`title`,
    `blog_article`.`body`,
    `blog_article`.`created_time`,
    `blog_article`.`modified_time`,
    `blog_article`.`abstract`,
    `blog_article`.`category_id`,
    `blog_article`.`author_id` 
FROM
    `blog_article` 
WHERE
    EXTRACT( MONTH FROM `blog_article`.`created_time` ) = 5


# USE_TZ=True时的MySQL语句
print(Article.objects.filter(created_time__month=5).query)  
SELECT
    `blog_article`.`id`,
    `blog_article`.`title`,
    `blog_article`.`body`,
    `blog_article`.`created_time`,
    `blog_article`.`modified_time`,
    `blog_article`.`abstract`,
    `blog_article`.`category_id`,
    `blog_article`.`author_id` 
FROM
    `blog_article` 
WHERE
    EXTRACT(MONTH FROM CONVERT_TZ( `blog_article`.`created_time`, 'UTC', 'Asia/Shanghai' )) = 5

2. 导入时区数据到MySQL中
Linux系统中,在Shell中执行以下命令导入时区到MySQL数据库中
$ mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql

回复
Snowden_Fu
2019-10-20 11:03:00

为啥按照课程走

{% url 'blog:tag' tag.pk %}
说int不可迭代

回复
追梦人物 Snowden_Fu
2019-10-21 11:30:26

提供更加详细的代码看看,尤其是 get_abdolute_url 方法

回复
Snowden_Fu 追梦人物
2019-10-22 08:47:17

    def get_absolute_url(self):
        return reverse('blog_app:detail', kwargs={'pk': self.pk})

跟这个关系不大吧

回复
追梦人物 Snowden_Fu
2019-10-22 15:07:13

嗯,这么看没有问题,tag 视图的 url 模式和代码看一下呢?

回复
Snowden_Fu 追梦人物
2019-10-23 10:26:42

找到问题了

tag_name = get_object_or_404(Tag, pk=pk)

没有pk=,楼主可以讲解一下为什么没有pk=就不行么,我看get_object_or_404源代码后面都是可选参数啊,为什么必须加pk呢?

回复
追梦人物 Snowden_Fu
2019-10-23 16:04:34

后面的关键字参数会作为过滤条件传给 orm 的查询语句,这个方法必须返回单个对象,所以必须传入恰当的条件筛选出一条记录来。

回复
Vincent Xue
2019-09-17 17:52:41

想请问一下作者,html文件和其文件夹的命名是遵循怎样的规范,有对应文档可以参照吗,谢谢!

回复
追梦人物 Vincent Xue
2019-09-17 23:10:30

没有什么规范,我个人习惯如下:
- 用于 include 的模板下划线开头,放在 inclusions 目录下
- 用于列表显示的模板,以 _list 结尾
- 用于显示详情的,以 _detail 结尾
- 基础模板命名为 base_xxx.html

回复
Vincent Xue 追梦人物
2019-09-17 23:24:54

非常感谢.期待step2的更新

回复
追梦人物 Vincent Xue
2019-09-17 23:26:26

step1 还有 10 多篇,更完就更 step2。

回复
飞鸿V
2019-09-09 09:15:34

三天一口气看完。。哈哈哈

回复