🦋

HelloDjango - Django博客教程（第二版）

博客从“裸奔”到“有皮肤”

2019-08-0734271 阅读38 评论

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

首页视图函数

上一节我们阐明了 django 的开发流程。即首先配置 URL，把 URL 和相应的视图函数绑定，一般写在 urls.py 文件里，然后在工程的 urls.py 文件引入。其次是编写视图函数，视图中需要渲染模板，我们也在 settings.py 中进行了模板相关的配置，让 django 能够找到需要渲染的模板。最后把渲染完成的 HTTP 响应返回就可以了。相关的配置和准备工作都在之前完成了，这里我们只需专心编写视图函数，让它实现我们想要的功能即可。

首页的视图函数其实很简单，代码像这样：

blog/views.py

from django.shortcuts import render
from .models import Post

def index(request):
    post_list = Post.objects.all().order_by('-created_time')
    return render(request, 'blog/index.html', context={'post_list': post_list})

我们曾经在前面的章节讲解过模型管理器 objects 的使用。这里我们使用 all() 方法从数据库里获取了全部的文章，存在了 post_list 变量里。all 方法返回的是一个 QuerySet（可以理解成一个类似于列表的数据结构），由于通常来说博客文章列表是按文章发表时间倒序排列的，即最新的文章排在最前面，所以我们紧接着调用了 order_by 方法对这个返回的 queryset 进行排序。排序依据的字段是 created_time，即文章的创建时间。- 号表示逆序，如果不加 - 则是正序。 接着如之前所做，我们渲染了 blog\index.html 模板文件，并且把包含文章列表数据的 post_list 变量传给了模板。

处理静态文件

我们的项目使用了从网上下载的一套博客模板（点击这里下载全套模板）。这里面除了 HTML 文档外，还包含了一些 CSS 文件和 JavaScript 文件以让网页呈现出我们现在看到的样式。同样我们需要对 django 做一些必要的配置，才能让 django 知道如何在开发服务器中引入这些 CSS 和 JavaScript 文件，这样才能让博客页面的 CSS 样式生效。

按照惯例，我们把 CSS 和 JavaScript 文件放在 blog 应用的 static 目录下。因此，先在 blog 应用下建立一个 static 文件夹。同时，为了避免和其它应用中的 CSS 和 JavaScript 文件命名冲突（别的应用下也可能有和 blog 应用下同名的 CSS 、JavaScript 文件），我们再在 static 目录下建立一个 blog 文件夹，把下载的博客模板中的 css 和 js 文件夹连同里面的全部文件一同拷贝进这个目录。最终我们的 blog 应用目录结构应该是这样的：

blog\
    __init__.py
    static\
        blog\
            css\
                .css 文件...
            js\
                .js 文件...
    admin.py
    apps.py
    migrations\
        __init__.py
    models.py
    tests.py
    views.py

用下载的博客模板中的 index.html 文件替换掉之前我们自己写的 index.html 文件。如果你好奇，现在就可以运行开发服务器，看看首页是什么样子。

未正确引入静态资源的博客首页

如图所示，你会看到首页显示的样式非常混乱，原因是浏览器无法正确加载 CSS 等样式文件。需要以 django 的方式来正确地处理 CSS 和 JavaScript 等静态文件的加载路径。CSS 样式文件通常在 HTML 文档的 head 标签里引入，打开 index.html 文件，在文件的开始处找到 head 标签包裹的内容，大概像这样：

templates/blog/index.html

<!DOCTYPE html>
<html>
  <head>
      <title>Black &amp; White</title>

      <!-- meta -->
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">

      <!-- css -->
      <link rel="stylesheet" href="css/bootstrap.min.css">
      <link rel="stylesheet" href="http://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
      <link rel="stylesheet" href="css/pace.css">
      <link rel="stylesheet" href="css/custom.css">

      <!-- js -->
      <script src="js/jquery-2.1.3.min.js"></script>
      <script src="js/bootstrap.min.js"></script>
      <script src="js/pace.min.js"></script>
      <script src="js/modernizr.custom.js"></script>
  </head>
  <body>
      <!-- 其它内容 -->
      <script src="js/script.js"></script>
  </body>
</html>

CSS 样式文件的路径在 link 标签的 href 属性里，而 JavaScript 文件的路径在 script 标签的 src 属性里。可以看到诸如 `href="css/bootstrap.min.css" 或者 src="js/jquery-2.1.3.min.js" 这样的引用，由于引用文件的路径不对，所以浏览器引入这些文件失败。我们需要把它们改成正确的路径。把代码改成下面样子，正确地引入 static 文件下的 CSS 和 JavaScript 文件：

templates/blog/index.html

+ {% load static %}
<!DOCTYPE html>
<html>
  <head>
      <title>Black &amp; White</title>

      <!-- meta -->
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">

      <!-- css -->
      - <link rel="stylesheet" href="css/bootstrap.min.css">
      <link rel="stylesheet" href="http://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
      - <link rel="stylesheet" href="css/pace.css">
      - <link rel="stylesheet" href="css/custom.css">
      + <link rel="stylesheet" href="{% static 'blog/css/bootstrap.min.css' %}">
      + <link rel="stylesheet" href="{% static 'blog/css/pace.css' %}">
      + <link rel="stylesheet" href="{% static 'blog/css/custom.css' %}">

      <!-- js -->
      - <script src="js/jquery-2.1.3.min.js"></script>
      - <script src="js/bootstrap.min.js"></script>
      - <script src="js/pace.min.js"></script>
      - <script src="js/modernizr.custom.js"></script>
      + <script src="{% static 'blog/js/jquery-2.1.3.min.js' %}"></script>
      + <script src="{% static 'blog/js/bootstrap.min.js' %}"></script>
      + <script src="{% static 'blog/js/pace.min.js' %}"></script>
      + <script src="{% static 'blog/js/modernizr.custom.js' %}"></script>
  </head>
  <body>
      <!-- 其它内容 -->
      - <script src="js/script.js' %}"></script>
      + <script src="{% static 'blog/js/script.js' %}"></script>
  </body>
</html>

这里 - 表示删掉这一行，而 + 表示增加这一行。（增加了哪些内容看仔细一点，千万别漏掉）

我们把引用路径放在了一个奇怪的符号里，例如：href="{% static 'blog/css/bootstrap.min.css' %}"。用 {% %} 包裹起来的叫做模板标签。我们前面说过用 {{ }} 包裹起来的叫做模板变量，其作用是在最终渲染的模板里显示由视图函数传过来的变量值。而这里我们使用的模板标签的功能则类似于函数，例如这里的 static 模板标签，它把跟在后面的字符串 'css/bootstrap.min.css' 转换成正确的文件引入路径。这样 css 和 js 文件才能被正确加载，样式才能正常显示。

注意：

为了能在模板中使用 {% static %} 模板标签，别忘了在最顶部 {% load static %} 。static 模板标签位于 static模块中，只有通过 load 模板标签将该模块引入后，才能在模板中使用 {% static %} 标签。

替换完成后你可以刷新页面并看看网页的源代码，看一看 {% static %} 模板标签在页面渲染后究竟被替换成了什么样的值。例如我们可以看到

<link rel="stylesheet" href="{% static 'blog/css/pace.css' %}">

这一部分最终在浏览器中显示的是：

<link rel="stylesheet" href="/static/blog/css/pace.css">

这正是 pace.css 文件所在的路径，其它的文件路径也被类似替换。可以看到 {% static %} 标签的作用实际就是把后面的字符串加了一个 /static/ 前缀，比如 {% static 'blog/css/pace.css' %} 最终渲染的值是 /static/blog/css/pace.css。而 /static/ 前缀是我们在 settings.py 文件中通过 STATIC_URL = '/static/' 指定的。事实上，如果我们直接把引用路径写成 /static/blog/css/pace.css 也是可以的，那么为什么要使用 {% static %} 标签呢？想一下，目前 URL 的前缀是 /static/，如果哪一天因为某些原因，我们需要把 /static/ 改成 /resource/，如果你是直接写的引用路劲而没有使用 static 模板标签，那么你可能需要改 N 个地方。如果你使用了 static 模板标签，那么只要在 settings.py 处改一个地方就可以了，即把 STATIC_URL = '/static/' 改成 STATIC_URL = '/resource/'。

提示

有时候按 F5 刷新后页面还是很乱，这可能是因为浏览器缓存了之前的结果。按 Shift + F5（有些浏览器可能是 Ctrl + F5）强制刷新浏览器页面即可。如果还是不行，重启一下开发服务器以及清除浏览器缓存。

注意这里有一个 CSS 文件的引入

<link rel="stylesheet" href="http://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">

我们没有使用模板标签，因为这里的引用的文件是一个外部文件，不是我们项目里 static\blog\css 目录下的文件，因此无需使用模板标签。

正确引入了静态文件后样式显示正常了。

正确引入静态资源后的博客首页

修改模板

目前我们看到的只是模板中预先填充的一些数据，我们得让它显示从数据库中获取的文章数据。下面来稍微改造一下模板：

在模板 index.html 中你会找到一系列 article 标签：

templates/blog/index.html

...
<article class="post post-1">
  ...
</article>

<article class="post post-2">
  ...
</article>

<article class="post post-3">
  ...
</article>
...

这里面包裹的内容显示的就是文章数据了。我们前面在视图函数 index 里给模板传了一个 post_list 变量，它里面包含着从数据库中取出的文章列表数据。就像 Python 一样，我们可以在模板中循环这个列表，把文章一篇篇循环出来，然后一篇篇显示文章的数据。要在模板中使用循环，需要使用到前面提到的模板标签，这次使用 {% for %} 模板标签。将 index.html 中多余的 article 标签删掉，只留下一个 article 标签，然后写上下列代码：

templates/blog/index.html

...
{% for post in post_list %}
  <article class="post post-{{ post.pk }}">
    ...
  </article>
{% empty %}
  <div class="no-post">暂时还没有发布的文章！</div>
{% endfor %}
...

可以看到语法和 Python 的 for 循环类似，只是被 {% %} 这样一个模板标签符号包裹着。{% empty %} 的作用是当 post_list 为空，即数据库里没有文章时显示 {% empty %} 下面的内容，最后我们用 {% endfor %} 告诉 django 循环在这里结束了。

你可能不太理解模板中的 post 和 post_list 是什么。post_list 是一个 QuerySet（类似于一个列表的数据结构），其中每一项都是之前定义在 blog\models.py 中的 Post 类的实例，且每个实例分别对应着数据库中每篇文章的记录。因此我们循环遍历 post_list ，每一次遍历的结果都保存在 post 变量里。所以我们使用模板变量来显示 post 的属性值。例如这里的 {{ post.pk }}（pk 是 primary key 的缩写，即 post 对应于数据库中记录的 id 值，该属性尽管我们没有显示定义，但是 django 会自动为我们添加）。

现在我们可以在循环体内通过 post 变量访问单篇文章的数据了。分析 article 标签里面的 HTML 内容，h1 显示的是文章的标题，

<h1 class="entry-title">
    <a href="single.html">Adaptive Vs. Responsive Layouts And Optimal Text Readability</a>
</h1>

我们把标题替换成 post 的 title 属性值。注意要把它包裹在模板变量里，因为它最终要被替换成实际的 title 值。

<h1 class="entry-title">
    <a href="single.html">{{ post.title }}</a>
</h1>

下面这 5 个 span 标签里分别显示了分类（category）、文章发布时间、文章作者、评论数、阅读量。

<div class="entry-meta">
  <span class="post-category"><a href="#">django 博客教程</a></span>
  <span class="post-date"><a href="#"><time class="entry-date"
                                            datetime="2012-11-09T23:15:57+00:00">2017年5月11日</time></a></span>
  <span class="post-author"><a href="#">追梦人物</a></span>
  <span class="comments-link"><a href="#">4 评论</a></span>
  <span class="views-count"><a href="#">588 阅读</a></span>
</div>

再次替换掉一些数据，由于评论数和阅读量暂时没法替换，因此先留着，我们在之后实现了这些功能后再来修改它，目前只替换分类、文章发布时间、文章作者：

<div class="entry-meta">
  <span class="post-category"><a href="#">{{ post.category.name }}</a></span>
  <span class="post-date"><a href="#"><time class="entry-date"
                                            datetime="{{ post.created_time }}">{{ post.created_time }}</time></a></span>
  <span class="post-author"><a href="#">{{ post.author }}</a></span>
  <span class="comments-link"><a href="#">4 评论</a></span>
  <span class="views-count"><a href="#">588 阅读</a></span>
</div>

这里 p 标签里显示的是摘要

<div class="entry-content clearfix">
  <p>免费、中文、零基础，完整的项目，基于最新版 django 1.10 和 Python 3.5。带你从零开始一步步开发属于自己的博客网站，帮助你以最快的速度掌握 django
    开发的技巧...</p>
  <div class="read-more cl-effect-14">
    <a href="#" class="more-link">继续阅读 <span class="meta-nav">→</span></a>
  </div>
</div>

替换成 post 的摘要：

<div class="entry-content clearfix">
  <p>{{ post.excerpt }}</p>
  <div class="read-more cl-effect-14">
    <a href="#" class="more-link">继续阅读 <span class="meta-nav">→</span></a>
  </div>
</div>

再次访问首页，它显示：暂时还没有发布的文章！好吧，做了这么多工作，但是数据库中其实还没有任何数据呀！接下来我们就实际写几篇文章保存到数据库里，看看显示的效果究竟如何。

-- EOF --

Django 的接客之道 创作后台开启，请开始你的表演
38 评论
登录后回复
思北202206
2023-01-07 19:21:13

这里的post_list后边的post请求的意思，还是规定语法
blog/views.py

from django.shortcuts import render
from .models import Post

def index(request):
post_list = Post.objects.all().order_by('-created_time')
return render(request, 'blog/index.html', context={'post_list': post_list})

回复
Feko
2022-07-26 16:26:53

通过+1

回复
huoxinyang
2021-04-12 17:42:21

有写好的前端页面吗，有点看不懂

回复
cao-weiwei
2021-01-30 23:57:00

请教一个关于Django项目中目录结构的问题：static和templates目录我看到有的人在project层级和app层级下都创建了，这个目录层级结构有什么通用的标准吗，谢谢！

回复
foundkey
2020-11-04 11:27:07

博客中的图片都是本地路径，无法显示啊。

回复
xiejie2333
2020-10-31 17:39:48

blogproject/settings.py中应该需要添加
STATICFILES_DIRS = (
os.path.join(BASE_DIR, 'static'),
)

回复
Jake_2014-16
2020-09-27 11:29:15

写的非常好

回复
DoubleZha
2020-05-28 23:00:32

出现了一个js文件 Not Found 的错误，能看看是怎么回事吗，路径和文件都跟文中一样。
```[28/May/2020 22:50:53] "GET /static/blog/css/pace.css HTTP/1.1" 304 0
[28/May/2020 22:50:53] "GET /static/js/bootstrap.min.js HTTP/1.1" 404 1681
[28/May/2020 22:50:53] "GET /static/js/modernizr.custom.js HTTP/1.1" 404 1690
[28/May/2020 22:50:53] "GET /static/blog/css/bootstrap.min.css HTTP/1.1" 304 0
Not Found: /blog/js/script.js
[28/May/2020 22:50:53] "GET /static/js/pace.min.js HTTP/1.1" 404 1666
[28/May/2020 22:50:53] "GET /static/css/custom.css HTTP/1.1" 404 1666
[28/May/2020 22:50:53] "GET /blog/js/script.js HTTP/1.1" 404 2159
[28/May/2020 22:50:53] "GET /static/js/jquery-2.1.3.min.js HTTP/1.1" 404 1690

```

回复
DoubleZha DoubleZha
2020-05-28 23:03:39

这是我 blog/static 的 tree

blog/static
└── blog
    ├── css
    │   ├── css文件···
    └── js
        ├── bootstrap.min.js
        ├── jquery-2.1.3.min.js
        ├── modernizr.custom.js
        ├── pace.min.js
        └── script.js

回复
DoubleZha DoubleZha
2020-05-30 22:02:10

是我有 index.html 有一处没有修改，现已解决。

回复
HuangChangHuai DoubleZha
2020-06-14 09:42:44

看响应状态码,304是已经缓存在浏览器没有更新的情况下不进行传输;
404错误一般是路径没有正确,看树之后:
image.png

回复
Maoning Guan
2020-05-28 19:37:11

您好博主，为什么在index.html文件里面引入这个for循环{% for post in post_list %}，会出现以下错误：
FieldError at /
Cannot resolve keyword 'create_time' into field. Choices are: author, author_id, body, category, category_id, created_time, excerpt, id, modified_time, tags, title

这是前面建模型的时候，字段的定义有什么问题吗？

回复
Maoning Guan Maoning Guan
2020-05-28 19:41:36

仅仅是这样修改而已：
...
{% for post in post_list %}
article标签代码
{% empty %}
div标签代码
{% endfor %}
...
article标签里面的内容还没加入post的字段。

回复
Maoning Guan Maoning Guan
2020-05-28 19:51:21

没事了，是视图函数那边写错了：
post_list = Post.objects.all().order_by('-create_time')

'-create_time'少了'd'

回复
nonozone
2020-05-09 20:55:59

为什么我把css和js的地址替换成 static之后，源码访问这些文件，都是404？文件不存在，但是路径都没错压。

回复
nonozone nonozone
2020-05-09 23:56:59

哦，我知道了，原来要在static下面还建议一个blog 目录...

回复
mmmhxy
2020-04-24 19:32:50

请问为什么我修改完之后其他一切正常，就是最上边显示出来一排往模板里加的+-符号？

回复
追梦人物 mmmhxy
2020-05-05 11:07:19
  • 表示添加这行
  • 表示删除这行
回复
bestarMing
2020-03-27 18:20:57

static文件是放在blog应用下的，templates放在根目录下的。打开网址按F12css和js文件都没有匹配不到，哪里出错了呢？

回复
追梦人物 bestarMing
2020-04-10 19:56:42

相关代码看看呢？

回复
Ipfirn
2020-03-09 16:09:04

更改到<link rel="stylesheet" href="{% static 'blog/css/bootstrap.min.css' %}">出现了错误

回复
Ipfirn Ipfirn
2020-03-09 16:25:26

对不起，解决了

回复
bestarMing Ipfirn
2020-03-27 18:21:28

请问怎么解决的呢？

回复
Ipfirn
2020-03-09 14:19:01

博主，为什么从网站下载的网页模块，除

<!DOCTYPE html>
<html>
  <head>
      <title>Black &amp; White</title>

      <!-- meta -->
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">

      <!-- css -->
      <link rel="stylesheet" href="css/bootstrap.min.css">
      <link rel="stylesheet" href="http://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
      <link rel="stylesheet" href="css/pace.css">
      <link rel="stylesheet" href="css/custom.css">

      <!-- js -->
      <script src="js/jquery-2.1.3.min.js"></script>
      <script src="js/bootstrap.min.js"></script>
      <script src="js/pace.min.js"></script>
      <script src="js/modernizr.custom.js"></script>
  </head>
  <body>
      <!-- 其它内容 -->
      <script src="js/script.js"></script>
  </body>
</html>

以外还有其他内容?

回复
Ipfirn Ipfirn
2020-03-09 16:25:49

没有看见其它内容

回复
闫帅Mac
2019-11-12 21:24:56

增加 category是点击保存，整个页面会崩溃
IntegrityError at /admin/blog/category/add/
NOT NULL constraint failed: blog_category.name
Request Method: POST
Request URL: http://127.0.0.1:8000/admin/blog/category/add/
Django Version: 2.2.3
Exception Type: IntegrityError
Exception Value:
NOT NULL constraint failed: blog_category.name
Exception Location: C:\django_project\env\lib\site-packages\django\db\backends\sqlite3\base.py in execute, line 383
Python Executable: C:\django_project\env\Scripts\python.exe
Python Version: 3.7.2

大佬，这个是啥问题

回复
追梦人物 闫帅Mac
2020-02-25 11:51:55

没有录入 name 吧，所以数据库报非 null 限制。

回复
zhouzhixiangyi
2019-11-04 18:35:39

post_list没传啊，显示不了啊

回复
miaocbin
2019-11-03 18:00:01

是要加这么一段到settings.py里面才能正常显示。
STATICFILES_URLS = [
os.path.join(BASE_DIR, "blog/static")
]

回复
Chen_github
2019-10-31 11:27:53

博主，我按你的教程操作一直引用不了，后来我有查了下资料，要在settings里添加STATICFILES_DIRS = 静态文件的路径，你看下是不是要完善下教程，防止我们这样的小白搞不定。。。

回复
追梦人物 Chen_github
2019-11-03 13:20:09

不是，开发环境开发服务器会自动处理 app 下的静态文件，无需设置；线上环境使用 nginx，通过 collectstatic 收集静态文件到 STATIC_ROOT 下，也无需设置这个选项。STATICFILES_DIRS 仅用于非 app 下的静态文件，这个项目里用不到。

回复
Chen_github 追梦人物
2019-11-03 21:03:51

我看了下官方文档，django会自动从注册应用下查找static这个文件，如果静态文件放应用下确实不用再设置，我是将静态文件放项目根目录了才不行的！

回复
Vincent Xue
2019-09-16 17:25:31

demo html似乎挂了呢

回复
追梦人物 Vincent Xue
2019-09-17 11:30:35

https 挂了，http 可以访问。

回复
719923505
2019-09-04 10:43:32
  1. {% load static %}这个static是指static这个文件吗，要加载这个里面的文件，如果换了文件名，load后面的也要改成相应的？还是这个是固定的模板标签，这样的标签都有哪些？
  2. STATIC_URL = '/static/' 改成 STATIC_URL = '/resource/'，index.html里面的为什么不用修改？
回复
MRCUTELZK 719923505
2019-09-25 09:45:21

load static是模板的语法，与你自定义的静态文件夹名字无关，在tornado里面也是一样的，如果你不想静态文件夹名字为static，把setting中的static_url的‘/static/’改成你的名字就好

回复
方世玉17927
2019-08-30 14:12:07

这里面的图片都没有显示出来

回复
Ipfirn 方世玉17927
2020-03-09 14:13:07

是的，博主可能是把图片路径改成了本地路径，所以没有显示

回复

目录