12. 分類與歸檔

本教程內容已過時,更新版教程請訪問: 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 模板標簽的用法和寫歸檔頁面時的用法是一樣的。現在嘗試點擊相應的鏈接,就可以跳轉到歸檔或者分類頁面了。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容