本教程內(nèi)容已過時,更新版教程請訪問: Django 博客開發(fā)入門教程彤枢。
這是 Django 博客教程的第 12 篇,在閱讀此篇教程以前贷洲,請確保你已閱讀 Django 博客教程的前 11 篇:
1. Django 博客教程:前言
2. 搭建開發(fā)環(huán)境
3. 建立我們的 django 博客應(yīng)用
4. 創(chuàng)建 django 博客的數(shù)據(jù)庫模型
5. 讓 django 完成翻譯——遷移數(shù)據(jù)庫模型
6. django 博客首頁視圖
7. 真正的 django 博客首頁視圖
8. 在 django admin 后臺發(fā)布我們的文章
9. 博客文章詳情頁
10. 支持 markdown 語法和代碼高亮
11. 頁面?zhèn)冗厵?/a>
側(cè)邊欄已經(jīng)正確地顯示了最新文章列表、歸檔晋柱、分類等信息∮殴梗現(xiàn)在來完善歸檔和分類功能,當(dāng)用戶點(diǎn)擊歸檔下的某個日期或者分類下的某個分類時趣斤,跳轉(zhuǎn)到文章列表頁面俩块,顯示該日期或者分類下的全部文章。
思路和主頁文章列表的顯示是一樣的浓领,回顧一下主頁的實(shí)現(xiàn)代碼:
blog/views.py
def index(request):
post_list = Post.objects.all()
return render(request, 'blog/index.html', context={'post_list': post_list})
主頁視圖函數(shù)中我們通過 Post.objects.all()
獲取全部文章玉凯,而在我們的歸檔和分類視圖中,我們不再使用 all 獲取全部文章联贩,而是使用 filter 來根據(jù)條件過濾漫仆。先來看歸檔視圖:
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 函數(shù)來過濾文章,由于是按照日期歸檔泪幌,因此這里根據(jù)文章發(fā)表的年和月來過濾盲厌,具體來說,就是根據(jù) created_time 的 year 和 month 屬性過濾祸泪,篩選出文章發(fā)表在對應(yīng)的 year 年 和 month 月的文章吗浩。注意這里 created_time 是 Python 的 Date 對象,其有一個 year 和 month 屬性没隘,我們在上一節(jié)的模板中使用過這個屬性懂扼。Python 中實(shí)例調(diào)用屬性的方法通常是 created_time.year,但是由于這里作為函數(shù)的參數(shù)列表右蒲,所以 django 要求我們把點(diǎn)替換成了兩個斜杠阀湿,即 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 的正則表達(dá)式和 detail 對應(yīng)的 url 是類似的,這在之前我們講過间坐。兩個括號括起來的地方是兩個命名組參數(shù)灾挨,django 會從用戶訪問的 URL 中自動提取這兩個參數(shù)的值,然后傳遞給 archives 視圖函數(shù)眶诈。例如如果用戶訪問 /archives/2017/3/涨醋,那么 archives 視圖函數(shù)的實(shí)際調(diào)用為: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 模板標(biāo)簽的作用是解析視圖函數(shù) blog:archives 對應(yīng)的 url 格式逝撬,并把 url 格式中的年和月替換成 date.year浴骂,date.month 的值。
測試一下宪潮,點(diǎn)擊側(cè)邊欄歸檔的日期溯警,跳轉(zhuǎn)到歸檔頁面趣苏,發(fā)現(xiàn)報了個錯誤,提示沒有安裝 pytz梯轻,進(jìn)入虛擬環(huán)境食磕,使用 pip install pytz
安裝一下。
重啟一下開發(fā)服務(wù)器喳挑,再次測試彬伦,發(fā)現(xiàn)可以顯示歸檔下的文章列表了。
同樣的寫好分類頁面的視圖函數(shù):
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})
這里我們首先根據(jù)傳入的 pk 值(也就是被訪問的分類的 id 值)從數(shù)據(jù)庫中獲取到這個分類伊诵。get_object_or_404 函數(shù)和 detail 視圖中一樣单绑,其作用是如果用戶訪問的分類不存在,則返回一個 404 錯誤頁面以提示用戶訪問的資源不存在曹宴。然后我們通過 filter 函數(shù)過濾出了該分類下的全部文章搂橙。
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'),
]
這個分類頁面對應(yīng)的 url 模式和文章詳情頁面對應(yīng)的 url 模式十分類似,在此就不贅述了笛坦。
修改相應(yīng)模板:
templates/base.html
{% for category in category_list %}
<li>
<a href="{% url 'blog:category' category.pk %}">{{ category.name }}</a>
</li>
{% endfor %}
同樣区转,url 模板標(biāo)簽的用法和寫歸檔頁面時的用法是一樣的。現(xiàn)在嘗試點(diǎn)擊相應(yīng)的鏈接版扩,就可以跳轉(zhuǎn)到歸檔或者分類頁面了废离。