Django 学习小组：博客开发实战第二周教程 —— 实现博客详情页面和分类页面

2016-07-04 13:04:00

上周我们完成了博客的 Model 部分，以及 Blog 的首页视图 IndexView。

本节接上周的文档 Django 学习小组：博客开发实战第一周教程 —— 编写博客的首页面，我们继续给博客添加功能，以及改善前面不合理的部分。本教程将带你完成 Blog 的详情页面，即用户点击首页的文章标题或者阅读全文按钮将跳转到文章的详情页面来阅读整篇文章。其次将调整一些目录结构以使其在实践应用中更加合理。

提示：在阅读教程的过程中，如有任何问题请访问我们项目的 GithHub 或评论留言以获取帮助，本教程的相关代码已全部上传在 Github。如果你对我们的教程或者项目有任何改进建议，请您通过随时告知我们。更多交流请加入我们的邮件列表 django_study@groups.163.com。

重写URL

对于一个有多个 app 的项目，把所有的 urlpatterns 都放在项目的 urls.py 似乎不是一个很合适的选择，为此我们需要在 blog 文件夹下新建一个文件 urls.py ，把跟这个 app 相关的 urlpatterns 都放在这个文件里。
文件中的 urlpatterns 看不懂暂时没关系，下面很快就会介绍它。

blog/urls.py

from django.conf.urls import url
from blog import views

urlpatterns = [
url(r'^blog/$', views.IndexView.as_view(), name='index'),
url(r'^blog/article/(?P\d+)$', views.ArticleDetailView.as_view(), name='detail'),
url(r'^blog/category/(?P\d+)$', views.CategoryView.as_view(), name='category'),
]

使用(?P\d+)的形式捕获值给中得参数，比如(?P\d+)，当访问/blog/article/3时，将会将3捕获给article_id,这个值会传到views.ArticleDetailView,这样我们就可以判断展示哪个Article了

然后在项目的 urls.py 中包含（include）它:

DjangoBlog/blog_project/urls.py

from django.conf.urls import url, include
from django.contrib import admin
from blog import views

urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'', include('blog.urls', namespace='blog', app_name='blog'))
]

其中namespace参数为我们指定了命名空间，这说明这个urls.py中的url是blog app下的，这样即使不同的app下有相同url也不会冲突了。

这样，我们就重写了 URL，看起来是不是更有条理了？

新增文章详情页

class ArticleDetailView(DetailView):

Django有基于类的视图DetailView,用于显示一个对象的详情页，我们继承它

model = Article# 指定视图获取哪个modeltemplate_name = "blog/detail.html"# 指定要渲染的模板文件context_object_name = "article"# 在模板中需要使用的上下文名字pk_url_kwarg = 'article_id'# 这里注意，pk_url_kwarg用于接收一个来自url中的主键，然后会根据这个主键进行查询# 我们之前在urlpatterns已经捕获article_id# 指定以上几个属性，已经能够返回一个DetailView视图了，为了让文章以markdown形式展现，我们重写get_object()方法。def get_object(self):    obj = super(ArticleDetailView, self).get_object()    obj.body = markdown2.markdown(object.body)    return obj

get_object() 返回该视图要显示的对象。如果有设置 queryset，该queryset 将用于对象的源；否则，将使用get_queryset(). get_object()从视图的所有参数中查找 pk_url_kwarg 参数；如果找到了这个参数，该方法使用这个参数的值执行一个基于主键的查询。

新建一个模板 detail.html 来展示我们的文章详情

blog/templates/blog/detail.html

{% extends 'base.html' %}
{% block content %}

                1. 首页                1. >                1.                                                 {{ article.category.name }}                1. >                {{ article.title }}                {{ article.title }}                {{ article.last_modified_time|date:"Y年n月d日" }}                {{ article.body |safe }}

{% endblock %}
整个执行流程就是这样的：

假设用户要访问某篇文章，比如他点击了某篇文章的标题，在模板文件中（首页的模板，代码可以参见 GitHub 上的 index.html），他点击的就是这样一个标签：

标签是一个超链接，用户点击后会跳转到由 href 指定的 url，这里我们使用了 django 自带的模板标签 url 标签，它会自动解析 blog:detail 这个视图函数对应的 url，并且把 article.pk（文章的主键）传递给detail 视图函数。detail 的 url 是这样定义的：

url(r'^blog/article/(?P\d+)$', views.ArticleDetailView.as_view(), name='detail')
假设用户点击了第三篇文章，那么该 url 会被解析成：/blog/article/3，其中 3 被传递给了详情页面视图函数。

现在视图函数被调用，它首先根据传给它的参数获自动调用 get_object 方法取到文章的 model，然后根据 context_object_name = "article" 把 article 加入到上下文中（可以理解为携带着这个变量及其值并要传递给模板文件的对象，模板文件从这个对象中取出模板变量对应的值并替换。），之后渲染 template_name = "blog/detail.html" 指定的模板文件，至此用户就跳转到了文章详情页，效果如下：

新增分类视图

点击某个分类，展示该分类下所有文章，其逻辑和首页展示全部文章列表是一样的，唯一不同的是我们获取的不是全部文章，而是该分类下的文章。代码如下：

class CategoryView(ListView):

继承自ListView,用于展示一个列表

template_name = "blog/index.html"# 指定需要渲染的模板context_object_name = "article_list"# 指定模板中需要使用的上下文对象的名字def get_queryset(self):    # get_queryset 的作用已在第一篇中有介绍，不再赘述    article_list = Article.objects.filter(category=self.kwargs['cate_id'],status='p')    # 注意在url里我们捕获了分类的id作为关键字参数（cate_id）传递给了CategoryView，传递的参数在kwargs属性中获取。    for article in article_list:        article.body = markdown2.markdown(article.body, )    return article_list# 给视图增加额外的数据def get_context_data(self,  kwargs):    kwargs['category_list'] = Category.objects.all().order_by('name')    # 增加一个category_list,用于在页面显示所有分类，按照名字排序    return super(CategoryView, self).get_context_data( kwargs)

这里我们复用的是主页的模板（因为展示的东西都是一样的），点击相应的分类，展示该分类下所有文章。同样别忘了如果要用户点击分类按钮跳转到分类页面的话，要指定标签的 href 属性，善用 url 模板标签，防止硬编码 url，像这样：

分类显示效果如下，显示分类二下的全部文章：