本教程內容已過時,更新版教程請訪問: Django 博客開發入門教程。
這是 Django 博客教程的第 12 篇,在閱讀此篇教程以前,請確保你已閱讀 Django 博客教程的前 11 篇:
1. Django 博客教程:前言
2. 搭建開發環境
3. 建立我們的 django 博客應用
4. 創建 django 博客的數據庫模型
5. 讓 django 完成翻譯——遷移數據庫模型
6. django 博客首頁視圖
7. 真正的 django 博客首頁視圖
8. 在 django admin 后臺發布我們的文章
9. 博客文章詳情頁
10. 支持 markdown 語法和代碼高亮
11. 頁面側邊欄
側邊欄已經正確地顯示了最新文章列表、歸檔、分類等信息。現在來完善歸檔和分類功能,當用戶點擊歸檔下的某個日期或者分類下的某個分類時,跳轉到文章列表頁面,顯示該日期或者分類下的全部文章。
思路和主頁文章列表的顯示是一樣的,回顧一下主頁的實現代碼:
blog/views.py
def index(request):
post_list = Post.objects.all()
return render(request, 'blog/index.html', context={'post_list': post_list})
主頁視圖函數中我們通過 Post.objects.all()
獲取全部文章,而在我們的歸檔和分類視圖中,我們不再使用 all 獲取全部文章,而是使用 filter 來根據條件過濾。先來看歸檔視圖:
blog/views.py
def archives(request, year, month):
post_list = Post.objects.filter(created_time__year=year, created_time__month=month)
return render(request, 'blog/index.html', context={'post_list': post_list})
這里我們使用了模型管理器(objects)的 filter 函數來過濾文章,由于是按照日期歸檔,因此這里根據文章發表的年和月來過濾,具體來說,就是根據 created_time 的 year 和 month 屬性過濾,篩選出文章發表在對應的 year 年 和 month 月的文章。注意這里 created_time 是 Python 的 Date 對象,其有一個 year 和 month 屬性,我們在上一節的模板中使用過這個屬性。Python 中實例調用屬性的方法通常是 created_time.year,但是由于這里作為函數的參數列表,所以 django 要求我們把點替換成了兩個斜杠,即 created_time__year。此外由于歸檔的顯示模板和 index 是一樣的(都是顯示文章列表),因此我們直接渲染了index 模板。
然后配置好 url:
blog/urls.py
from django.conf.urls import url
from . import views
app_name = 'blog'
urlpatterns = [
url(r'^$', views.index, name='index'),
url(r'^post/(?P<pk>[0-9]+)/$', views.detail, name='detail'),
+ url(r'^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$', views.archives, name='archives'),
]
這個 url 的正則表達式和 detail 對應的 url 是類似的,這在之前我們講過。兩個括號括起來的地方是兩個命名組參數,django 會從用戶訪問的 URL 中自動提取這兩個參數的值,然后傳遞給 archives 視圖函數。例如如果用戶訪問 /archives/2017/3/,那么 archives 視圖函數的實際調用為:archives(request, year=2017, month=3)
在模板找到歸檔列表部分的代碼,修改鏈接的 href 屬性:
templates/base.html
{% for date in date_list %}
<li>
<a href="{% url 'blog:archives' date.year date.month %}">
{{ date.year }} 年 {{ date.month }} 月
</a>
</li>
{% endfor %}
這里 URL 模板標簽的作用是解析視圖函數 blog:archives 對應的 url 格式,并把 url 格式中的年和月替換成 date.year,date.month 的值。
測試一下,點擊側邊欄歸檔的日期,跳轉到歸檔頁面,發現報了個錯誤,提示沒有安裝 pytz,進入虛擬環境,使用 pip install pytz
安裝一下。
重啟一下開發服務器,再次測試,發現可以顯示歸檔下的文章列表了。
同樣的寫好分類頁面的視圖函數:
blog/views.py
import markdown
from django.shortcuts import render, get_object_or_404
# 引入 Category 類
from .models import Post, Category
def category(request, pk):
cate = get_object_or_404(Category, pk=pk)
post_list = Post.objects.filter(category=cate)
return render(request, 'blog/index.html', context={'post_list': post_list})
這里我們首先根據傳入的 pk 值(也就是被訪問的分類的 id 值)從數據庫中獲取到這個分類。get_object_or_404 函數和 detail 視圖中一樣,其作用是如果用戶訪問的分類不存在,則返回一個 404 錯誤頁面以提示用戶訪問的資源不存在。然后我們通過 filter 函數過濾出了該分類下的全部文章。
url 配置:
blog/urls.py
from django.conf.urls import url
from . import views
app_name = 'blog'
urlpatterns = [
url(r'^$', views.index, name='index'),
url(r'^post/(?P<pk>[0-9]+)/$', views.detail, name='detail'),
url(r'^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$', views.archives, name='archives'),
+ url(r'^category/(?P<pk>[0-9]+)/$', views.category, name='category'),
]
這個分類頁面對應的 url 模式和文章詳情頁面對應的 url 模式十分類似,在此就不贅述了。
修改相應模板:
templates/base.html
{% for category in category_list %}
<li>
<a href="{% url 'blog:category' category.pk %}">{{ category.name }}</a>
</li>
{% endfor %}
同樣,url 模板標簽的用法和寫歸檔頁面時的用法是一樣的。現在嘗試點擊相應的鏈接,就可以跳轉到歸檔或者分類頁面了。