你好，我是悦创。

然后，我们将实现一个用户身份验证系统。首先创建一个注册页面，供用户创建账户，并让有些页面只能供已登录的用户访问。接下来，修改一些视图函数，使得用户只能看到自己的数据。我们还将学习如何确保用户数据的安全。

你好，我是悦创。

Django 模板语言包含了很多 内置 tags 和 filters，设计目的是满足应用需要占位逻辑需求。极少情况下，你可能发现需要的功能未被核心模板集覆盖。你能通过 Python 代码自定义 tags 和 filters 扩展集成模板引擎，通过 {% load %} 标签使其可用。

1. 在模型中指定排序

为了让文章（Post）按发布时间逆序排列，让最新发表的文章排在文章列表的最前面，我们对返回的文章列表进行了排序，即各个视图函数中都有类似于 Post.objects.all().order_by('-created_time') 这样的代码，导致了很多重复。因为只要是返回的文章列表，基本都是逆序排列的，所以可以在 Post 模型中指定 Post 的自然排序方式。

django 允许我们在 models.Model 的子类里定义一个名为 Meta 的内部类，通过这个内部类指定一些属性的值来规定这个模型类该有的一些特性，例如在这里我们要指定 Post 的排序方式。首先看到 Post 的代码，在 Post 模型的内部定义的 Meta 类中，指定排序属性 ordering：

1. 创建评论应用

你好，我是悦创。

相对来说，评论是另外一个比较独立的功能。django 提倡，如果功能相对比较独立的话，最好是创建一个应用，把相应的功能代码组织到这个应用里。我们的第一个应用叫 blog，它里面放了展示博客文章列表和详情等相关功能的代码。而这里我们再创建一个应用，名为 comments，这里面将存放和评论功能相关的代码。首先进入到项目根目录，然后输入如下命令创建一个新的应用：

➜  gossip_django git:(main) ✗ pipenv run python manage.py startapp comments

你好，我是悦创。

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

1. 归档页面

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

# filename: 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})

你好，我是悦创。

我们的博客侧边栏有四项内容：最新文章、归档、分类和标签云。这些内容相对比较固定和独立，且在各个页面都会显示，如果像文章列表或者文章详情一样，从视图函数中获取这些数据然后传递给模板，则每个页面对应的视图函数里都要写一段获取这些内容的代码，这会导致很多重复代码。更好的解决方案是直接在模板中获取，为此，我们使用 django 的一个新技术：自定义模板标签来完成任务。

1. 使用模板标签的解决思路

我们前面已经接触过一些 django 内置的模板标签，比如比较简单的 {% static %} 模板标签，这个标签帮助我们在模板中引入静态文件。还有比较复杂的如 {% for %} {% endfor%} 标签。

你好，我是悦创。

博客文章的模型有一个 excerpt 字段，这个字段用于存储文章的摘要。目前为止，还只能在 django admin 后台手动为文章输入摘要。每次手动输入摘要比较麻烦，对有些文章来说，只要摘取正文的前 N 个字符作为摘要，以便提供文章预览就可以了。因此我们来实现如果文章没有输入摘要，则自动摘取正文的前 N 个字符作为摘要，这有两种实现方法。

1. 覆写 save 方法

第一种方法是通过覆写模型的 save 方法，从正文字段摘取前 N 个字符保存到摘要字段。在 创作后台开启，请开始你的表演 中我们提到过 save 方法中执行的是保存模型实例数据到数据库的逻辑，因此通过覆写 save 方法，在保存数据库前做一些事情，比如填充某个缺失字段的值。

你好，我是悦创。

上一篇中我们使用了 Markdown 来为文章提供排版支持。Markdown 在解析内容的同时还可以自动提取整个内容的目录结构，现在我们来使用 Markdown 为文章自动生成目录。

1. 在文中插入目录

先来回顾一下博客的 Post（文章）模型，其中 body 是我们存储 Markdown 文本的字段：

# filename: blog/models.py

from django.db import models

class Post(models.Model):
    # Other fields ...
    body = models.TextField()

1. 概述

1.1 宗旨

Markdown 的目标是实现「易读易写」。

可读性，无论如何，都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，而最大灵感来源其实是纯文本电子邮件的格式。

你好，我是悦创。

为了让博客文章具有良好的排版，显示更加丰富的格式，我们使用 Markdown 语法来书写博文。

Markdown 是一种 HTML 文本标记语言，只要遵循它约定的语法格式，Markdown 的解析工具就能够把 Markdown 文档转换为标准的 HTML 文档，从而使文章呈现更加丰富的格式，例如标题、列表、代码块等等 HTML 元素。

由于 Markdown 语法简单直观，不用超过 5 分钟就可以轻松掌握常用的标记语法，因此大家青睐使用 Markdown 书写 HTML 文档。下面让我们的博客也支持使用 Markdown 写作。

你好，我是悦创。

首页展示的是所有文章的列表，当用户看到感兴趣的文章时，他点击文章的标题或者继续阅读的按钮，应该跳转到文章的详情页面来阅读文章的详细内容。现在让我们来开发博客的详情页面，有了前面的基础，开发流程都是一样的了：首先配置 URL，即把相关的 URL 和视图函数绑定在一起，然后实现视图函数，编写模板并让视图函数渲染模板。

1. 设计文章详情页的 URL

回顾一下我们首页视图的 URL，在 blog/urls.py 文件里，我们写了：

# filename: blog/urls.py

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

你好，我是悦创。

在此之前我们完成了 django 博客首页视图的编写，我们希望首页展示发布的博客文章列表，但是它却抱怨：暂时还没有发布的文章！如它所言，我们确实还没有发布任何文章，本节我们将使用 django 自带的 admin 后台来发布我们的博客文章。

1. 创建 admin 后台管理员账户

要想进入 django admin 后台，首先需要创建一个超级管理员账户。我们在 Django 迁移、操作数据库 中已经创建了一个后台账户，但如果你没有按照前面的步骤创建账户的话，可以进入项目根目录，运行 pipenv run python manage.py createsuperuser 命令新建一个：

你好，我是悦创。

在此之前我们已经编写了博客的首页视图，并且配置了 URL 和模板，让 django 能够正确地处理 HTTP 请求并返回合适的 HTTP 响应。不过我们仅仅在首页返回了一句话：欢迎访问我的博客。这是个 Hello World 级别的视图函数，我们需要编写真正的首页视图函数，当用户访问我们的博客首页时，他将看到我们发表的博客文章列表，就像 演示项目 里展示的这样。

1. 首页视图函数

上一节我们阐明了 django 的开发流程。即首先配置 URL，把 URL 和相应的视图函数绑定，一般写在 urls.py 文件里，然后在工程的 urls.py 文件引入。

1. Django 处理 HTTP 请求

你好，我是悦创。

Web 应用的交互过程其实就是 HTTP 请求与响应的过程。无论是在 PC 端还是移动端，我们通常使用浏览器来上网，上网流程大致来说是这样的：

1. 我们打开浏览器，在地址栏输入想访问的网址，比如 https://bornforthis.cn/（当然你也可能从收藏夹里直接打开网站，但本质上都是一样的）。
2. 浏览器知道我们想要访问哪个网址后，它在后台帮我们做了很多事情。主要就是把我们的访问意图包装成一个 HTTP 请求，发给我们想要访问的网址所对应的服务器。通俗点说就是浏览器帮我们通知网站的服务器，说有人来访问你啦，访问的请求都写在 HTTP 报文里了，你按照要求处理后告诉我，我再帮你回应他！
3. 服务器处理了HTTP 请求，然后生成一段 HTTP 响应给浏览器。浏览器解读这个响应，把相关的内容在浏览器里显示出来，于是我们就看到了网站的内容。比如你访问了我的博客主页 https://bornforthis.cn/，服务器接收到这个请求后就知道用户访问的是首页，首页显示的是全部文章列表，于是它从数据库里把文章数据取出来，生成一个写着这些数据的 HTML 文档，包装到 HTTP 响应里发给浏览器，浏览器解读这个响应，把 HTML 文档显示出来，我们就看到了文章列表的内容。

你好，我是悦创。

我们已经编写了博客数据库模型的代码，但那还只是 Python 代码而已，django 还没有把它翻译成数据库语言，因此实际上这些数据库表还没有真正的在数据库中创建。

1. 迁移数据库

为了让 django 完成翻译，创建好这些数据库表，我们再一次请出我的工程管理助手 manage.py。切换到 manage.py 文件所在的目录（项目根目录）下，分别运行 pipenv run python manage.py makemigrations 和 pipenv run python manage.py migrate 命令：

1. 设计博客的数据库表结构

博客最主要的功能就是展示我们写的文章，它需要从某个地方获取博客文章数据才能把文章展示出来，通常来说这个地方就是数据库。

我们把写好的文章永久地保存在数据库里，当用户访问我们的博客时，django 就去数据库里把这些数据取出来展现给用户。

博客的文章应该含有标题、正文、作者、发表时间等数据。一个更加现代化的博客文章还希望它有分类、标签、评论等。为了更好地存储这些数据，我们需要合理地组织数据库的表结构。

我们的博客初级版本主要包含博客文章，文章会有分类以及标签。一篇文章只能有一个分类，但可以打上很多标签。

1. 建立博客应用

我们已经建立了 django 博客的项目工程，并且成功地运行了它。不过到目前为止这一切都还只是 django 为我们创建的项目初始内容，django 不可能为我们初始化生成博客代码，这些功能性代码都得由我们自己编写。

Django 鼓励我们把自己编写的代码组织到应用（Application）里，并且最好是一个应用只提供一种功能。例如我们要开发的 django 博客，相关的代码都放在 blog 这个应用里。其实应用也没什么特殊的，不过是把功能相关的代码组织到一个文件夹里，这个文件夹就成了一个应用（姑且可以这样理解）。

我们可以在 django 工程目录下手动地建立一个文件夹，为它取个名字，并且告诉 django 说这是一个应用。但是我们不必做这些无聊的工作，django 已经为我们提供了自动创建应用的命令。

1. 开发环境说明

本教程写作时开发环境的系统平台为 MacOS，Python 版本为 3.10.10 （64 位），Django 版本为 4.1.7。

建议尽可能地与教程的开发环境保持一致（尤其是 Python 与 Django 版本），避免不必要的麻烦。Python 版本必须为 Python 3.10 或以上，django 版本号必须为 django 4.1.x。