Django搭建我的博客：使用 Bootstrap 4 改写模板文件

时间 2020-01-30

标签 django 搭建我的博客使用 bootstrap 改写模板文件栏目 Python 繁體版

原文原文链接

上一章咱们的网站页面实在太粗糙，你确定不会拿来作真正的博客首页。所以这章咱们要借助Bootstrap的力量，改写一个大气的博客。css

配置Bootstrap 4

Bootstrap是用于网站开发的开源前端框架（“前端”指的是展示给最终用户的界面），它提供字体排印、窗体、按钮、导航及其余各类组件，旨在使动态网页和Web应用的开发更加容易。html

Bootstrap有几个版本都比较流行，咱们选择最新版本的Bootstrap 4：下载地址，并解压。前端

而后在项目根目录下新建目录static/bootsrap/，用于存放Bootstrap静态文件。静态文件一般指那些不会改变的文件。Bootstrap中的css、js文件，就是静态文件。python

把刚才解压出来的css和js两个文件夹复制进去。jquery

由于bootstrap.js依赖 jquery.js 和 popper.js 才能正常运行，所以这两个文件咱们也须要一并下载保存。附上官网下载连接（进入下载页面，复制粘贴代码到新文件便可）：git

2018-10-29 新增：
不清楚popper.js如何下载的戳这个连接：程序员

https://unpkg.com/popper.js@1.14.4/dist/umd/popper.jsgithub

进去后页面显示很长一段代码，把这段代码所有拷贝；在项目中新建名叫popper.js的文件，把刚拷贝的代码复制进去就能够了。不少开源js文件都是经过这样的方式下载。django

如今咱们的static/目录结构像这样：bootstrap

my_blog
│
├─article
└─my_blog
│ ...
└─static
    └─bootstrap
    │   ├─css # 文件夹
    │   └─js # 文件夹
    └─jquery
    │   └─jquery-3.3.1.js # 文件
    └─popper
        └─popper-1.14.4.js # 文件

由于在Django中须要指定静态文件的存放位置，才可以在模板中正确引用它们。所以在settings.py的末尾加上：

my_blog/settings.py

...

STATICFILES_DIRS = (
    os.path.join(BASE_DIR, "static"),
)

再确认一下settings.py中有没有STATIC_URL = '/static/'字段，若是没有把它也加在后面。

编写模板

在根目录下的templates/中，新建三个文件：

base.html是整个项目的模板基础，全部的网页都从它继承；
header.html是网页顶部的导航栏；
footer.html是网页底部的注脚。

这三个文件在每一个页面中一般都是不变的，独立出来能够避免重复写一样的代码，提升维护性。

如今templates\的结构像下面这个样子：

templates
│
├─base.html
├─header.html
├─footer.html
└─article
    └─list.html # 上一章建立的

加上以前的list.html，接下来就要从新写这4个文件了。

由于前端知识很是博大精深，而且也不是Django学习的重点，本教程不会展开篇幅去讲。若是以前没接触过前端知识也不要紧，这里能够先复制粘贴，不影响后面Django的学习。

你能够试着改写其中的某段代码，看看会对页面产生什么样的影响；遇到不懂的就在Bootstrap官方文档找答案。慢慢就会明白它的运行机制，毕竟Bootstrap真的是很是简单易用的工具。

这里会一次性写大量代码，不要着急慢慢看，理解了就很简单了。

首先写base.html：

templates/base.html

<!-- 载入静态文件 -->
{% load staticfiles %}

<!DOCTYPE html>
<!-- 网站主语言 -->
<html lang="zh-cn">

<head>
    <!-- 网站采用的字符编码 -->
    <meta charset="utf-8">
    <!-- 预留网站标题的位置 -->
    <title>{% block title %}{% endblock %}</title>
    <!-- 引入bootstrap的css文件 -->
    <link rel="stylesheet" href="{% static 'bootstrap/css/bootstrap.min.css' %}">
</head>

<body>
    <!-- 引入导航栏 -->
    {% include 'header.html' %}
    <!-- 预留具体页面的位置 -->
    {% block content %}{% endblock content %}
    <!-- 引入注脚 -->
    {% include 'footer.html' %}
    <!-- bootstrap.js 依赖 jquery.js 和popper.js，所以在这里引入 -->
    <script src="{% static 'jquery/jquery-3.3.1.js' %}"></script>
    <script src="{% static 'popper/popper-1.14.4.js' %}"></script>    
    <!-- 引入bootstrap的js文件 -->
    <script src="{% static 'bootstrap/js/bootstrap.min.js' %}"></script>
</body>

</html>

模板中要加上 {% load staticfiles %} 以后，才可以使用 {% static 'path' %} 引用静态文件。
HTML语法中，全部的内容都被标签包裹；标签及标签中的属性能够对内容进行排印、解释说明等做用。
<head></head>标签内包含网页的元数据，是不会在页面内显示出来的。<body></body>标签内才是网页会显示的内容。
留意Bootstrap的css、js文件分别是如何引入的
jquery.js 和 popper.js 要在 bootstrap.js 前引入。**

而后是header.html：

templates/header.html

<!-- 定义导航栏 -->
<nav class="navbar navbar-expand-lg navbar-dark bg-dark">
  <div class="container">

    <!-- 导航栏商标 -->
    <a class="navbar-brand" href="#">个人博客</a>

    <!-- 导航入口 -->
    <div>
      <ul class="navbar-nav">
        <!-- 条目 -->
        <li class="nav-item">
          <a class="nav-link" href="#">文章</a>
        </li>
      </ul>
    </div>

  </div>
</nav>

标签内的class属性是Bootstrap样式的定义方法。试着改写或删除其中一些内容，观察页面的变化。

而后改写以前的list.html：

templates/article/list.html

<!-- extends代表此页面继承自 base.html 文件 -->
{% extends "base.html" %}
{% load staticfiles %}

<!-- 写入 base.html 中定义的 title -->
{% block title %}
    首页
{% endblock title %}

<!-- 写入 base.html 中定义的 content -->
{% block content %}

<!-- 定义放置文章标题的div容器 -->
<div class="container">
    <div class="row mt-2">

        {% for article in articles %}
        <!-- 文章内容 -->
        <div class="col-4 mb-4">
        <!-- 卡片容器 -->
            <div class="card h-100">
                <!-- 标题 -->
                <h4 class="card-header">{{ article.title }}</h4>
                <!-- 摘要 -->
                <div class="card-body">
                    <p class="card-text">{{ article.body|slice:'100' }}...</p>
                </div>
                <!-- 注脚 -->
                <div class="card-footer">
                    <a href="#" class="btn btn-primary">阅读本文</a>
                </div>
            </div>
        </div>
        {% endfor %}

    </div>
</div>
{% endblock content %}

留意{% block title %}和{% block content %}是如何与base.html中相对应起来的。
摘要中的{{ article.body|slice:'100' }}取出了文章的正文；其中的|slice:'100'是Django的过滤器语法，表示取出正文的前100个字符，避免摘要太长。

最后写入footer.html：

{% load staticfiles %}
<!-- Footer -->
<div>
    <br><br><br>
</div>
<footer class="py-3 bg-dark fixed-bottom">
    <div class="container">
        <p class="m-0 text-center text-white">Copyright &copy; www.dusaiphoto.com 2018</p>
    </div>
</footer>

呼，真是一大堆的东西啊。

让咱们来捋一捋发生了什么：

当咱们经过url访问list.html时，顶部的{% extends "base.html" %}告诉Django：“这个文件是继承base.html的，你去调用它吧。”
因而Django就老老实实去渲染base.html文件：
- 其中的{% include 'header.html' %}代表这里须要加入header.html的内容
- {% include 'footer.html' %}加入footer.html的内容
- {% block content %}{% endblock content %}代表这里应该加入list.html中的对应块的内容

运行服务器

老规矩，保存所有文件，进入虚拟环境，运行开发服务器，在浏览器中输入http://127.0.0.1:8000/article/article-list/，看到以下页面：

一个漂亮的博客界面就这样出如今眼前，很是神奇。

若是报错也不要着急，程序员就是不断与bug斗争的一个职业。仔细检查Django给出的错误提示，修复它，你必定行。

总结

本章咱们引入了前端框架Bootstrap 4，借助它从新组织了模板的结构，编写了一个漂亮的博客网站的首页。

下一章咱们将学习编写文章详情页面。

有疑问请在杜赛的我的网站留言，我会尽快回复。
或Email私信我：dusaiphoto@foxmail.com
项目完整代码：Django_blog_tutorial

转载请告知做者并注明出处。