Django 博客开发教程 11 - 分类与归档

happyhuangjinjin 发布于2019-07-31 10:57 / 1120人阅读

摘要：侧边栏已经正确地显示了最新文章列表归档分类等信息。重启一下开发服务器，再次测试，发现可以显示归档下的文章列表了。在分类与归档追梦人物的博客的评论区留言。将问题的详细描述通过邮件发送到，一般会在小时内回复。

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

归档页面

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

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_time 的 year 和 month 属性过滤，筛选出文章发表在对应的 year 年和 month 月的文章。注意这里 created_time 是 Python 的 date 对象，其有一个 year 和 month 属性，我们在页面侧边栏：使用自定义模板标签使用过这个属性。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[0-9]+)/$", views.detail, name="detail"),
    + url(r"^archives/(?P[0-9]{4})/(?P[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 %}

  
    {{ date.year }} 年 {{ date.month }} 月
  

{% endfor %}

这里 {% url %} 这个模板标签的作用是解析视图函数 blog:archives 对应的 URL 模式，并把 URL 模式中的年和月替换成 date.year，date.month 的值。例如 blog:archives 表示 blog 应用下的 archives 函数，这个函数对应的 URL 模式为 ^archives/(?P[0-9]{4})/(?P[0-9]{1,2})/$，假设 date.year=2017，date.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[0-9]+)/$", views.detail, name="detail"),
    url(r"^archives/(?P[0-9]{4})/(?P[0-9]{1,2})/$", views.archives, name="archives"),
    + url(r"^category/(?P[0-9]+)/$", views.category, name="category"),
]

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

修改相应模板：

templates/base.html

{% for category in category_list %}

  {{ category.name }}

{% endfor %}

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

总结

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

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

在分类与归档 - 追梦人物的博客的评论区留言。

将问题的详细描述通过邮件发送到 djangostudyteam@163.com，一般会在 24 小时内回复。

更多Django 教程，请访问追梦人物的博客。

海外云主机云服务器阿里云双11归档存储组团优惠阿里云双11归档存储有折扣吗 Django教程 django开发环境

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/44394.html

Django 学习小组：博客开发实战第四周——标签云与文章归档

摘要：本教程内容已过时，更新版教程请访问博客开发入门教程。表示降序排列，默认是升序排列。学习小组简介学习小组是一个促进新手互相学习互相帮助的组织。我们会将每周的详细开发文档和代码通过邮件列表发出。本教程内容已过时，更新版教程请访问： django 博客开发入门教程。通过前四周的时间我们开发了一个简单的个人 Blog，教程地址：第一周：Django 学习小组：博客开发实战第一周教程 ——...

RichardXG 2019-07-25 10:32 评论0 收藏0
Django 博客开发教程 10 - 页面侧边栏：使用自定义模板标签

摘要：我们的博客侧边栏有四项内容最新文章归档分类和标签云。更好的解决方案是直接在模板中获取，为此，我们使用的一个新技术自定义模板标签来完成任务。注意要在使用任何下的模板标签以前导入它。在页面侧边栏使用自定义模板标签追梦人物的博客的评论区留言。我们的博客侧边栏有四项内容：最新文章、归档、分类和标签云。这些内容相对比较固定，且在各个页面都会显示，如果像文章列表或者文章详情一样，从视图函数中获取...

summerpxy 2019-07-31 10:57 评论0 收藏0
Django 学习小组：博客开发实战第二周教程 —— 实现博客详情页面和分类页面

摘要：本节接上周的文档学习小组博客开发实战第一周教程编写博客的首页面，我们继续给博客添加功能，以及改善前面不合理的部分。返回该视图要显示的对象。目前小组正在完成第一个项目，本文即是该项目第二周的相关文档。本教程内容已过时，更新版教程请访问： django 博客开发入门教程。上周我们完成了博客的 Model 部分，以及 Blog 的首页视图 IndexView。本节接上周的文档 Djan...

ingood 2019-07-25 10:29 评论0 收藏0
Django 学习小组：博客开发实战第五周教程 —— 实现评论功能

摘要：本教程内容已过时，更新版教程请访问博客开发入门教程。我们的评论表单放在中，评论成功后返回到原始提交页面。学习小组简介学习小组是一个促进新手互相学习互相帮助的组织。本教程内容已过时，更新版教程请访问： django 博客开发入门教程。通过前四周的时间我们开发了一个简单的个人 Blog，前几期教程地址：第一周：Django 学习小组：博客开发实战第一周教程 —— 编写博客的 Mode...

CoderStudy 2019-08-01 15:24 评论0 收藏0
Django 学习小组：博客开发实战第五周教程 —— 实现评论功能

摘要：本教程内容已过时，更新版教程请访问博客开发入门教程。我们的评论表单放在中，评论成功后返回到原始提交页面。学习小组简介学习小组是一个促进新手互相学习互相帮助的组织。本教程内容已过时，更新版教程请访问： django 博客开发入门教程。通过前四周的时间我们开发了一个简单的个人 Blog，前几期教程地址：第一周：Django 学习小组：博客开发实战第一周教程 —— 编写博客的 Mode...

kumfo 2019-07-25 10:33 评论0 收藏0