11 – 分類與歸檔

追夢人物發表於2019-01-18

側邊欄已經正確地顯示了最新文章列表、歸檔、分類等資訊。現在來完善歸檔和分類功能，當使用者點選歸檔下的某個日期或者分類下的某個分類時，跳轉到文章列表頁面，顯示該日期或者分類下的全部文章。

歸檔頁面

要顯示某個歸檔日期下的文章列表，思路和顯示主頁文章列表是一樣的，回顧一下主頁檢視的程式碼：

blog/views.py

def index(request):
    post_list = Post.objects.all().order_by(`-created_time`)
    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
                                    ).order_by(`-created_time`)
    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.html 模板。

寫好檢視函式後就是配置好 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 中自動提取這兩個引數的值，然後傳遞給其對應的檢視函式。例如如果使用者想檢視 2017 年 3 月下的全部文章，他訪問 /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 的值。例如 blog:archives 表示 blog 應用下的 archives 函式，這個函式對應的 URL 模式為 ^archives/(?P<year>[0-9]{4})/(?P<month>[0-9]{1,2})/$，假設 date.year=2017，date.month=5，那麼 {% url `blog:archives` date.year date.month %} 模板標籤返回的值為/archives/2017/5/。

為什麼要使用 {% url %} 模板標籤呢？事實上，我們把超連結的 href 屬性設定為 /archives/{{ date.year }}/{{ date.month }}/ 同樣可以達到目的，但是這種寫法是硬編碼的。雖然現在 blog:archives 檢視函式對應的 URL 模式是這種形式，但是如果哪天這個模式改變了呢？如果使用了硬編碼的寫法，那你需要把每一處 /archives/{{ date.year }}/{{ date.month }}/ 修改為新的模式。但如果使用了 {% url %} 模板標籤，則不用做任何修改。

測試一下，點選側邊欄歸檔的日期，跳轉到歸檔頁面，發現報了個錯誤，提示沒有安裝 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):
    # 記得在開始部分匯入 Category 類
    cate = get_object_or_404(Category, pk=pk)
    post_list = Post.objects.filter(category=cate).order_by(`-created_time`)
    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 %} 模板標籤的用法和寫歸檔頁面時的用法是一樣的。現在嘗試點選相應的連結，就可以跳轉到歸檔或者分類頁面了。

總結

本章節的程式碼位於：Step11: category and archive。

如果遇到問題，請通過下面的方式尋求幫助。

相關文章