953
Django 博客開發教程 6 - 真正的 Django 博客首頁視圖
在此之前我們已經編寫了 Blog 的首頁視圖，並且配置了 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 & 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="https://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 staticfiles %}
<!DOCTYPE html>
<html>
<head>
<title>Black & 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="https://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 staticfiles %} 。static 模板標簽位於 staticfiles 模塊中，隻有通過 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="https://code.ionicframework.com/ionicons/2.0.1/css/ionicons.min.css">
我們沒有使用模板標簽，因為這裏的引用的文件是一個外部文件，不是我們項目裏 static\blog\css\ 目錄下的文件，因此無需使用模板標簽。
正確引入了靜態文件後樣式顯示正常了。
修改模板
目前我們看到的隻是模板中預先填充的一些數據，我們得讓它顯示從數據庫中獲取的文章數據。下麵來稍微改造一下模板：
在模板 index.html 中你會找到一係列 article 標簽：
templates/blog/index.html
...
<article >
...
</article>
<article >
...
</article>
<article >
...
</article>
...
這裏麵包裹的內容顯示的就是文章數據了。我們前麵在視圖函數 index 裏給模板傳了一個 post_list 變量，它裏麵包含著從數據庫中取出的文章列表數據。就像 Python 一樣，我們可以在模板中循環這個列表，把文章一篇篇循環出來，然後一篇篇顯示文章的數據。要在模板中使用循環，需要使用到前麵提到的模板標簽，這次使用 {% for %} 模板標簽。將 index.html 中多餘的 article 標簽刪掉，隻留下一個 article 標簽，然後寫上下列代碼：
templates/blog/index.html
...
{% for post in post_list %}
<article >
...
</article>
{% empty %}
<div >暫時還沒有發布的文章！</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 >
<a href="single.html">Adaptive Vs. Responsive Layouts And Optimal Text Readability</a>
</h1>
我們把標題替換成 post 的 title 屬性值。注意要把它包裹在模板變量裏，因為它最終要被替換成實際的 title 值。
<h1 >
<a href="single.html">{{ post.title }}</a>
</h1>
下麵這 5 個 span 標簽裏分別顯示了分類（category）、文章發布時間、文章作者、評論數、閱讀量。
<div >
<span ><a href="#">Django 博客教程</a></span>
<span ><a href="#"><time
datetime="2012-11-09T23:15:57+00:00">2017年5月11日</time></a></span>
<span ><a href="#">追夢人物</a></span>
<span ><a href="#">4 評論</a></span>
<span ><a href="#">588 閱讀</a></span>
</div>
再次替換掉一些數據，由於評論數和閱讀量暫時沒法替換，因此先留著，我們在之後實現了這些功能後再來修改它，目前隻替換分類、文章發布時間、文章作者：
<div >
<span ><a href="#">{{ post.category.name }}</a></span>
<span ><a href="#"><time
datetime="{{ post.created_time }}">{{ post.created_time }}</time></a></span>
<span ><a href="#">{{ post.author }}</a></span>
<span ><a href="#">4 評論</a></span>
<span ><a href="#">588 閱讀</a></span>
</div>
這裏 p 標簽裏顯示的是摘要
<div >
<p>免費、中文、零基礎，完整的項目，基於最新版 Django 1.10 和 Python 3.5。帶你從零開始一步步開發屬於自己的博客網站，幫助你以最快的速度掌握 Django
開發的技巧...</p>
<div >
<a href="#" >繼續閱讀 <span >→</span></a>
</div>
</div>
替換成 post 的摘要：
<div >
<p>{{ post.excerpt }}</p>
<div >
<a href="#" >繼續閱讀 <span >→</span></a>
</div>
</div>
再次訪問首頁，它顯示：暫時還沒有發布的文章！好吧，做了這麼多工作，但是數據庫中其實還沒有任何數據呀！接下來我們就實際寫幾篇文章保存到數據庫裏，看看顯示的效果究竟如何。
總結
本章節的代碼位於：Step6: real blog index view。
如果遇到問題，請通過下麵的方式尋求幫助。
- 在 真正的 Django 博客首頁視圖 - 追夢人物的博客 的評論區留言。
- 將問題的詳細描述通過郵件發送到 djangostudyteam@163.com，一般會在 24 小時內回複。
更多Django 教程，請訪問 追夢人物的博客。
最後更新：2017-05-31 12:02:32