Django搭建個人博客:使用 Bootstrap 4 改寫模板文件

上一章我們的網站頁面實在太粗糙,你肯定不會拿來做真正的博客首頁。因此這章我們要藉助Bootstrap的力量,改寫一個大氣的博客。

配置Bootstrap 4

Bootstrap是用於網站開發的開源前端框架(“前端”指的是展現給最終用戶的界面),它提供字體排印、窗體、按鈕、導航及其他各種組件,旨在使動態網頁和Web應用的開發更加容易。

Bootstrap有幾個版本都比較流行,我們選擇最新版本的Bootstrap 4:下載地址,並解壓。

然後在項目根目錄下新建目錄static/bootsrap/,用於存放Bootstrap靜態文件。把剛纔解壓出來的cssjs兩個文件夾複製進去,目錄結構像這樣:

my_blog
│
├─article
└─my_blog
│ ...
└─static
    └─bootstrap
        ├─css
        └─js

靜態文件通常指那些不會改變的文件。Bootstrap中的css、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文件 -->
    <script src="{% static 'bootstrap/js/bootstrap.min.js' %}"></script>
</body>

</html>
  • 模板中要加上 {% load staticfiles %} 之後,纔可使用 {% static 'path' %} 引用靜態文件。
  • HTML語法中,所有的內容都被標籤包裹;標籤及標籤中的屬性可以對內容進行排印、解釋說明等作用。
  • <head></head>標籤內包含網頁的元數據,是不會在頁面內顯示出來的。<body></body>標籤內纔是網頁會顯示的內容。
  • 留意Bootstrap的css、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

templates/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; 杜賽的博客網站 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,藉助它重新組織了模板的結構,編寫了一個漂亮的博客網站的首頁。

下一章我們將學習編寫文章詳情頁面。

轉載請告知作者並註明出處。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章