画日记编程

演示视频
项目概况
先决条件
第 1 步：设置你的 Django 日记
- 初始化 Django
- 创建数据库
- 成为超级用户
- 运行开发 Web 服务器
第 2 步：将您的日记条目添加到后端
- 连接条目应用程序
- 创建条目模型
- 注册入门模型
- 迁移入口模型
第 3 步：在前端显示您的日记条目
- 创建列表和详细信息视图
- 创建您的模板
- 将路线添加到您的视图
第 4 步：让你的 Django 日记看起来不错
- 添加样式表
- 扩展子模板
第 5 步：在前端管理您的日记条目
- 添加视图
- 创建模板
- 创建 URL
第 6 步：改善您的用户体验
- 处理您的成功
- 获取消息
- 改善您的导航
- 设计您的消息
第 7 步：锁定你的 Django 日记
- 重用您的 Django 管理员登录
- 添加注销链接
- 限制访问您的视图
下一步
结论

一个日记是个人安全的空间。在 Django 的帮助下，您可以在自己的计算机上创建日记，而无需将数据存储在其他人的云端。通过跟随下面的项目，您将看到在 Django 中构建一个正常运行的Web 应用程序的速度有多快，而无需任何外部依赖。

在本教程中，您将学习如何：

设置Django 项目
使用标准SQLite数据库
使用 Django管理站点
创建模型和基于类的视图
嵌套和样式模板
通过身份验证保护您的日记

本教程将指导您逐步完成最终日记。如果您刚刚开始使用 Django 并希望完成您的第一个真正的项目，那么本教程适合您！

在您日记的主页上，您会看到一个条目列表。您可以滚动浏览它们并通过单击按钮创建新的。本教程中提供了样式，因此您可以专注于代码的 Django 部分。这是一个快速演示视频，展示了它的实际效果：

在本教程结束时，您将能够完美地浏览您的日记，以按需创建、阅读、更新和删除条目。

本教程分为多个步骤。这样，您就可以休息并按照自己的节奏继续。在每一步中，您都将处理日记项目的特定领域：

设置你的 Django 日记项目
在后端创建条目
在前端显示条目
添加样式
在前端管理条目
改善您的用户体验
实施认证

通过跟随，您将探索 Web 应用程序的基础知识以及如何添加 Django 项目的常见功能。完成本教程后，您将创建自己的个人日记应用程序，并将有一个Django 项目蓝图来构建。

您不需要任何先前的 Django 知识即可完成此项目。如果您想了解有关本教程中遇到的主题的更多信息，您将在此过程中找到指向资源的链接。

但是，您应该习惯于使用命令行并且具备Python 和类的基本知识。尽管了解虚拟环境和会有所帮助，但您将在学习本教程时学习如何设置所有内容。

通过创建项目目录并设置虚拟环境来启动项目。此设置将使您的代码与您机器上的任何其他项目隔离。您可以随意命名项目文件夹和虚拟环境。在本教程中，项目文件夹命名为，虚拟环境命名为：

您的提示现在以括号中的虚拟环境名称开头。这是虚拟环境被激活的指示符。对于本教程的其余部分，必须激活您的虚拟环境。以下所有步骤都将在此目录或其子目录中进行。

注意：要在Windows上激活您的虚拟环境，您可能需要运行以下命令：

对于其他平台和 shell，您可能需要使用不同的命令。

对您的日记唯一的其他要求是 Django 本身。安装本教程的特定版本：

此命令安装 Django 和 Django 需要的一些依赖项。这就是您所需要的一切。

满足所有要求后，是时候启动 Django 项目本身了。使用 Django 的命令行实用程序创建基本项目结构：

不要忘记在上述命令的末尾添加点 ( )。点阻止 Django 为您的日记项目创建另一个目录。

Django 刚刚创建了一个文件和一个以五个文件命名的文件夹。您不必确切了解他们的工作。如果你好奇，你可以看一看这些文件。它们在开头都包含一个解释，描述它们为什么存在。在本教程中，您只需要编辑其中两个：

文件在教程中编辑？ ❌ ❌ ❌ ✅ ✅ ❌

从现在开始，该文件将接管命令行中的管理任务。您将在本教程中遇到其中一些。

现在你的 Django 日记项目的基础已经准备好了，你需要一个地方来存储你日记的未来内容。为此，您必须创建一个数据库。

如果没有提供其他数据库配置，Django默认支持多个数据库并使用SQLite数据库。您只需要一个SQLite数据库，因为您是连接到它的唯一用户，并且您的 Django 日记项目只会在本地运行。

最好的部分是您可以使用单个命令创建 SQLite 数据库。通过运行migrations，您可以将数据库架构的更改应用到数据库中：

当您查看项目目录时，您应该会看到一个文件。拍拍自己的肩膀：您刚刚创建了一个数据库！

要将项目的当前状态与本教程的可下载文件进行比较，请单击以下链接：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

与本节相关的文件在目录中。

作为您个人日记的所有者，您已经获得了. 使用以下命令声明它：

系统会提示您选择用户名、提供电子邮件地址并设置密码。这是你日记的关键，所以一定要记住它。

您将经常使用的另一个命令是. 此命令运行轻量级开发 Web 服务器：

您可以指定IP 地址和端口。默认情况下，服务器在端口上运行并且只能在您的计算机上访问。在服务器运行的情况下，您可以在浏览器中使用或访问您的 Django 项目：

这是您日记的主页。到目前为止，只能看到火箭。这意味着安装成功。

重要提示：每次在浏览器中访问日记项目时，如果尚未运行，则必须先启动本地开发 Web 服务器。

通过访问并使用您的凭据登录来完成本教程的第一步：

这是您自己的Django 管理站点！它是 Django最强大的功能之一。只需进行一些调整，您就可以立即管理内容和用户。目前，在 Django 管理站点中没有什么可看的。是时候改变它了！

一个 Django 项目包含一个或多个应用程序。应用程序的范围应该是有限的。一开始，区分项目和应用程序可能会令人困惑。但是在大型 Django 项目中，这种关注点分离可以保持代码库干净。这种结构的另一个优点是您可以将应用程序重用于其他项目。

在您的终端中，Django 开发 Web 服务器可能仍在运行。通过在终端中按Ctrl+C来停止它。

提示：打开第二个终端窗口以在一个窗口中控制服务器并在另一个窗口中运行命令：

导航到您的项目并激活虚拟环境后，您可以在第二个终端窗口中运行该项目即将执行的命令。

在本教程中，您只需要一个额外的应用程序。该应用程序的主要目的是处理您的日记条目，所以让我们调用该应用程序。运行命令以创建应用程序：

此命令在您的项目中创建一个包含一些预定义文件的文件夹。在本教程后面，您只需要编辑其中的三个：

文件在教程中编辑？ ❌ ✅ ❌ ✅ ❌ ✅

如您所见，其中一些与目录中的文件具有相同的名称。通过单击下面的链接，您可以将您的文件夹结构与目录中的结构进行比较：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

到目前为止，Django 不知道您刚刚创建的应用程序。要将应用程序连接到 Django 日记项目，请在中的列表开头添加配置类的路径：

该应用程序插入到项目，现在，Django的发现它的配置。这些配置之一是描述您的日记条目在数据库中的外观的模型。

您已经创建了数据库。现在是时候定义存储日记条目的数据库表了。在 Django 中，您可以使用模型类来做到这一点。就像 Python 中的常规类一样，模型名称应该是单数和大写。当您的应用程序被调用时，您的模型将被调用。

模型的字段是日记条目将具有的元素。在前面，这些字段将显示为表单。在后面，它们将是您的数据库表的列。本教程中的日记条目包含三个字段：

是标题。
是正文正文。
是创建日期和时间。

在中，首先从导入。然后在同一个文件中创建类，如下所示：

通过导入模块，您可以将其用作第9 行中的参数。这样，如果您在创建条目时未为其定义特定值，则默认情况下将使用当前日期和时间。稍后在为日记条目创建表单时，您将使用此行为。

除了, , 和之外，Django 会自动添加一个唯一的主键。该字符串表示与主键条目的将是默认。添加时，您可以自定义显示的内容。对于日记条目，标题是更好的字符串表示形式。

您必须调整的另一个变量是. 否则，Django 会拼出你的as和 not的复数形式。

要在 Django 管理站点中查看模型，您需要在以下位置注册它：

当您忘记在管理站点中注册模型时，Django 不会抛出错误。毕竟，并非每个模型都需要在用户界面中进行管理。但是对于日记中最小的可行产品，您将利用内置的 Django 管理站点。

添加新类并在管理站点上注册后，您需要为 Django制作迁移文件并运行它们。使用，您可以创建迁移文件，其中包含 Django 构建数据库的说明。使用，您可以实现它们：

迁移完成后，运行开发 Web 服务器，移动到浏览器，然后访问 Django 管理站点：

目前，没有列出任何条目。通过单击添加条目为您的日记至少创建一个条目来完成此步骤。不知道写什么？也许想想你的 Django 日记项目有一个功能齐全的后端是多么棒！

您现在可以在 Django 管理站点中添加新条目。但是当你在浏览器中访问你的日记首页时，它仍然显示了抖动的火箭。在这一步中，您将学习如何在前端显示您的日记条目。

如果您想查看此步骤结束时的代码外观，请单击以下链接：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

与此步骤相关的文件在目录中。

Django 中有两种视图：基于函数的视图和基于类的视图。两者都接受网络请求并返回网络响应。一般来说，基于函数的视图给你更多的控制，但也有更多的工作。基于类的视图给你更少的控制，但也更少的工作。

减少工作听起来不错。但这并不是您在日记中使用基于类的视图的唯一原因。您的 Django 日记将使用 Web 应用程序的典型视图，例如显示数据库项目列表或其详细信息。这就是为什么基于类的视图是日记视图的不错选择。

Django 提供了许多开箱即用的通用视图。在这种情况下，您将创建a和 a 的子类并将它们连接到您的模型中：

正如所承诺的，此时没有太多代码需要您编写。第12 行的查询将返回按主键排序的所有条目。增强它会以升序返回您的条目，最新的条目位于列表顶部。

当你写这样的视图时，Django 会在后台做一些假设，比如视图要渲染的模板的名称和位置。

使用模板，您可以动态生成 HTML。Django 期望您刚刚创建的基于类的视图的模板位于具有特定名称的特定位置。为您的模板创建子文件夹：

当然，模板的路径看起来有点奇怪。但是通过这种方式，您可以确保 Django 会找到完全正确的模板，即使其他应用程序共享相同的模型名称。在中，您将存储模型的所有模板文件。首先创建并添加以下内容：

在 Django 模板中，您甚至可以动态引用 CSS 类。当您查看第 5 行时，您可以看到已添加到其中。这显示了具有特殊格式的时间戳。这样，元素将工作日作为一个类，您可以稍后在 CSS 中为每个工作日指定一个独特的颜色。

在循环内部，您可以访问模型的字段。为了不让列表中的信息过多，您只会在访问条目的详细信息页面时显示内容。使用作为文件名创建此详细信息页面并添加以下内容：

一个模板期望的是一个条目对象。这就是为什么您可以直接在此处访问它而无需循环。

要查看正在运行的模板，您需要将视图连接到URL。Django 使用一个文件来分派来自浏览器中用户的传入请求。项目文件夹中已经存在这样的文件。对于条目应用程序，您必须首先创建它并将路径添加到和：

第8 行和第 13 行的函数必须至少有两个参数：

一个路由字符串模式，其中包含一个 URL 模式
对视图的引用，它是基于类的视图的函数

此外，您可以将参数作为kwargs传递并提供name。使用名称，您可以在 Django 项目中轻松引用视图。因此，即使您决定更改 URL 模式，也不必更新模板。

现在，对于网址的应用程序已经到位，你需要将它们连接到列表中。当您打开时，您将看到您的 Django 日记项目使用的。到目前为止，只有到的路由，它是默认添加的，因此您可以访问 Django 管理站点。要在访问时显示日记条目，首先需要将根 URL 分派到应用程序：

创建新模板后，手动重新启动 Django 开发 Web 服务器。然后访问并欣赏您的观点：

您可以通过点击相应的链接列表或访问看到一个条目的详细信息，其中是一个现有的条目。

现在一切就绪，可以在前端查看您的条目。不过，您的日记看起来仍然有些单调。让我们在下一步中改变它！

在此步骤中，您将为日记添加一些样式。如果你想看一下这一步完成的代码，那就点击下面的链接，查看目录：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

虽然你的写作很有创意，但日记的设计目前有点基础。你可以开始通过创建一个调味的东西了基础模板，在与此内容：

使用模板继承，您不必在模板中重复标记。相反，您扩展您的子模板。然后 Django 在视图中提供它们时会自动将它们合并在一起。

通过在模板文件的开头插入，您可以使用模板标签和 CSS 文件的相对路径来引用静态文件。建立在扩大框下方查看CSS代码，你会添加到文件中。

diary.css 的内容显示隐藏

如前所述，条目列表中的每个元素都将其工作日作为一个类。通过样式和不同，您可以轻松地在列表中发现周末。

现在是时候将子模板与父模板连接起来了。更新它看起来像这样：

该模板标签定义了一个子模板可以覆盖文档的一部分。要启用此功能，您必须声明您的子模板扩展了父模板并定义了一个具有相同名称的块元素。使用第3 行的模板标记，您将其定义为父级。并在第 5 行和第 18 行包装将放置在父级块中的标记。

做同样的事情：

这两个模板都从其父模板继承了 HTML 结构和样式。它们共享相同的标题和标题，以及由. 要查看此操作，请启动您的 Django 开发服务器并转到：

您现在可以有风格地阅读您的条目。但是，当您想要创建、更新或删除条目时，您必须转到 Django 管理站点。当您想快速记下一些想法时，点击次数太多了。在下一步中，您将通过将此功能添加到前端来改进您的工作流程。

当您构建和使用 Web 应用程序时，您会一直执行四个基本操作。这些操作非常常见，以至于它们经常被CRUD首字母缩写词所指代：

Create
Read
Update
Delete

在 Django 管理站点中，您已经可以执行所有这些操作。在前端，您目前只能阅读您的条目。为了类似于 Django 管理站点的功能，您将重复您已经为and所做的工作，添加一个视图、一个模板和一个 URL。

在已经导入和至今。更新您的导入语句，使其看起来像这样：

在底部添加您的三个子类：

这一次，将类连接到您的模型是不够的。对于and ，您还需要定义表单中应该显示哪些模型字段，如第 5 行和第 10行所示。您的第 18 行仅执行删除条目项的操作，因此您不需要定义其中的任何字段。

此外，您需要定义在提交视图表单后应该将用户重定向到何处。默认情况下，只返回的值。在中，您需要覆盖此方法。

通过在第 15 行中提供作为关键字参数，您在编辑后停留在条目详细信息页面上。您不使用 URL，而是使用reverse_lazy按名称引用它们，就像您在模板中所做的那样。

像以前一样，Django 查找具有特定名称的模板：

对于，它是。
对于，它是。
因为它会。

当 Django 找不到时，它会尝试作为后备。您可以通过创建一个处理两个视图的模板并添加一个基本提交表单来利用这一点：

当此模板由加载时，表单将为空，取消它会再次将您带到条目列表。当由加载时，它将预先填充条目的当前标题和内容。取消会将您带到条目详细信息页面。

有多种方法可以在模板中呈现表单。随着在第7行，Django会显示您在包裹在段落视图中定义的字段。每当您在 Django 表单中发布内容时，您还必须在其中包含第6 行中的模板标记。这是一种防止跨站点请求伪造的安全措施。

与其他模板一样，您在第 3 行添加以扩展基本模板。然后定义要包含在第4 行和第 18 行之间的标记中的内容。对in使用相同的模式：

当您要删除条目时，将显示此模板。在表单中提及和会提醒您按下确认键将删除哪个条目。

创建视图及其模板后，创建它们的路由以在前端访问它们。向in添加三个额外的路径：

对于，您只需要一个基本路径。像前面创建，并且需要一个主键，以确定哪个入口应更新或删除。

现在，您可以直接在前端创建、更新和删除日记条目。启动开发web服务器，访问测试。如果您想将您的代码与本教程中的代码进行比较，请单击以下链接：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

您可以在目录中找到与此步骤相关的文件。

使用您的日记，您可能会偶然发现一些让导航有点烦人的怪癖。在这一步中，您将一一解决它们。您会看到界面中的微小变化会对您的日记用户体验产生重大影响。

得到一些反馈总是很好的，尤其是当它是积极的时。使用消息框架，您可以快速定义在提交表单后显示的一次性闪现消息。要使用此功能，进口和到：

并且是阅读视图并且不处理表单。他们可能会在模板中显示一条消息，但不会发送一条消息。这意味着您不需要为它们创建子类。，并且，在另一方面，也通知添加到邮件存储，所以你需要调整它们的功能：

在第 3 行和第 9行继承in之后，您在第 7 行和第 12 行为它们定义 a 。特别是当您执行删除条目等破坏性操作时，提供一切正常的反馈至关重要。要在中显示消息，您必须添加自定义方法并手动将自定义添加到消息框架：

您在第 8 行需要这个额外的方法，因为该类不是. 这就是为什么你可以跳过添加在第3行。

点击下方链接，查看完整内容。您可以在目录中找到它：

获取源代码： 单击此处获取您将在本教程中使用 Django 和 Python 构建个人日记 Web 应用程序的源代码。

现在视图发送消息，您需要增强模板以显示它们。

消息存储在消息存储器中。通过循环遍历它，您可以显示当前在消息存储中的所有消息。在 Django 模板中，您可以通过使用消息模板标签来实现这一点。您构建日记和构建模板的方式，您只需要将其添加到：

通过将消息列表包装在第 4 行和第 12 行，您可以确保只有在存储中有任何消息时才会有条件地显示它。

要创建、编辑或删除条目，您需要记住相应的 URL，然后在地址栏中键入它们。多么乏味！幸运的是，您可以通过向视图添加链接来解决此问题。从模板中的视图链接开始：

此标记将类似于其他日记条目列表项。立即向模板添加新段落以快速编辑或删除条目：

此代码在分别链接到和的条目详细信息下方添加了两个链接。

最后，通过添加和结尾来设置 flash 消息的样式：

通过在终端中按Ctrl+C停止开发 Web 服务器并重新启动它。然后访问以查看您的操作更改。如果消息看起来没有样式，您可能需要清除浏览器的缓存，以便重新加载样式表更改：

您现在拥有一个完全用 Django 构建的完全可用的日记 Web 应用程序。尽管您的日记仅存储在本地，但最好确保只有您可以访问它。让我们在开始记录之前添加该限制。

多么小的金锁是用于物理日记，登录表单是用于您的数字日志。此锁的关键是您已用于登录 Django 管理站点的名称和密码组合。

Django 提供的身份验证系统非常基础。对于其他有普通用户的项目，可以考虑定制。但是对于你的 Django 日记，重复使用 Django 管理站点的登录就足够了。稍后您会发现这一切正常。首先，让我们注意注销。

您通过访问一个特殊的 URL 来注销。Django 已经提供了一个带有名称的 URL，用于将您从 Django 管理站点注销。当您登录并从项目中的任何位置访问此 URL 时，Django 会自动将您注销。要快速访问此 URL，请在底部添加指向它的链接：

启动您的开发 Web 服务器，转到您的主页，然后单击注销链接。现在，当您访问时，您会看到登录表单。这意味着您已注销。但是，当您再次访问时，您的日记条目仍然可以访问。是时候改变它了！

在 Django 中，您可以定义允许谁查看哪些视图。默认情况下，它们对访问您网站的所有人开放。要确保视图需要经过身份验证的用户才能访问，请在顶部导入：

一旦视图类使用，它首先需要成功登录。此外，您必须定义 a以便 Django 在您未登录时知道将您重定向到何处。您可以创建一个继承并定义in的基类，而不是单独对所有类执行此操作：

现在，您可以在所有其他视图中进行继承，这些视图应该只能由经过身份验证的用户访问。编辑使您的类看起来像这样：

现在，当您访问时，您将被重定向到 Django 登录表单。登录后，您将被重定向到条目列表，并看到仅对您可见的所有内容：

就是这样！您已经成功地在 Django 中建立了自己的个人日记。如果您想将您的代码与项目的最终代码进行比较，请单击以下链接：

该项目的完整代码在目录中。

您构建的日记功能齐全，随时可用。但它也是一个很好的基础。也许您已经对如何进一步改进日记有了一些想法。或者，您可以尝试以下想法之一：

为您最近的条目添加一个页面。
给每个工作日一个颜色。
在 HTML标记中显示创建日期。
为条目创建一天选择的表情符号。
对条目列表进行分页。

在本教程中，您了解了 Django 提供的一些基本概念和模式。希望它激发了一些深入研究这个 Python Web 框架的兴趣。如果您想继续您的旅程并了解更多信息，您可以查看以下教程：

使用 Django 的第一步：设置 Django 项目
Django 入门第 1 部分：构建投资组合应用程序
在 Django Admin 中管理用户需要知道什么
使用 Python 自定义 Django Admin
使用 Django、Vue 和 GraphQL 构建博客

您可以将通过完成日记项目获得的知识应用于其他 Django 教程，并将您的 Web 应用程序技能提升到一个新的水平！

在本教程中，您使用 Django 从头开始创建了一个个人日记。您学习了如何构建一个可以日常使用的全功能 Web 应用程序。它利用了 Django 的许多优势，包括管理站点、基于类的视图、消息框架和模板系统。

这个 Django 项目也是您未来 Django 项目的完美基础。您在此日记项目中完成的步骤与其他项目基本相同，例如博客或待办事项应用程序。

在本教程中，您学习了如何：

设置Django 项目
使用标准SQLite数据库
使用 Django管理站点
创建模型和基于类的视图
嵌套和样式模板
通过身份验证保护您的日记

相关推荐