Django網站快速入門

2.1 個人部落格網站規劃

個人部落格具有以下功能：

• 專案名稱mblog
• 通過admin管理介面張貼、編輯以及刪除貼文
• 使用Bookstrap網頁框架
• 在主頁中顯示每篇文章的標題，及發帖日期

建立專案：

    django-admin startproject mblog
    cd mblog
    python mange.py startapp mainsite

在setting.py中加入'mainsite'

2、建立部落格資料表

python manage.py migrate

Django要使用資料庫，有以下幾個步驟：

• 在models.py中定義需要使用的類（繼承自models.Models）
• 詳細地設定每一個在類中的變數，即資料表中的每一個欄位
• 使用python manage.py makemigrations mainsite建立資料庫和Django間的中間檔案
• 使用python manage.py migrate同步更新資料庫的內容
• 在程式中使用python的操作方法所定義的資料類，等於是在操作資料庫中的資料表

修改mainsite/models.py內容

from django.db import models
from django.utils import timezone
# Create your models here.

class Post(models.Model):
    title = models.CharField(max_length=200)
    slug = models.CharField(max_length=200)
    body = models.TextField()
    pub_date = models.DateTimeField(default=timezone.now)

    class Meta:
        ordering = ('-pub_date',)

    def __unicode__(self):
        return self.title
 

注：建立一個post類(到時候在資料庫中會有一個對應的資料表)。此類包含幾個專案，title-題目;slug-網址;body-內容;pub-date-發表的時間。
Class Meta 內的設定是指定文章顯示的順序是以pub_date為依據。unicode提供此類所產生的資料型，一個以文章標題作為顯示的內容，增加操作過程中的可讀性，使用unicode而不是str，讓標題支援中文。

pub_date需要一個pytz模組，執行pip install pytz安裝

讓此模型生效，執行:

python manage.py makemigrations

建立管理員賬號和密碼:

python manage.py createsuperuser
 

把前面定義的post納入管理：修改mainsite/admin.py，並且加上張貼日期和時間等內容：

from django.contrib import admin
from .models import Post
# Register your models here.

class PostAdmin(admin.ModelAdmin):
    list_display = ('title','slug','pub_date')

admin.site.register(Post,PostAdmin)

使用*.*.*.*:8000\admin訪問，建立至少五篇文章，方便後續測試。

簡單說明一下Django的MTV架構(類比MVC)。Django把資料的存取和顯示分為Model、Template以及View。分別對應models.py、template資料夾以及view.py檔案。

• Model——model.py：主要負責定義要存取的資料型別，以Python的class類來定義，在後端Django會自動把這個類中的設定對應的到資料庫系統中，不管使用的是哪一種資料庫。
• View——view.py:負責如何把這些資料存進去或取出等程式邏輯。
• Template——template資料夾：負責把取得的資料用美觀且有彈性的方式輸出。

編輯mainsite/admin.py

from django.contrib import admin
from .models import Post
# Register your models here.

class PostAdmin(admin.ModelAdmin):
list_display = ('title','slug','pub_date')

admin.site.register(Post,PostAdmin)

[email protected]:~/mblog# vim mainsite/views.py

from django.shortcuts import render
from django.http import HttpResponse
from .models import Post

# Create your views here.   
def homepage(request):
    posts = Post.objects.all()
    post_lists = list()
    for count, post in enumerate(posts):
        post_lists.append(No.{}".format(str(count))+str(post)+"<hr>")
        post_lists.append("<small>"+str(post.body.encode('utf-8'))\+"</small><br><br>")
    return HttpResponse(post_lists)

首先，把model.py中自定義的Model匯入，然後使用Post.objects.all()取得所有資料項，然後可用for迴圈取出所有內容，再通過HttpResponse輸出到網頁上。

此例中，建立了一個homepage函式來獲取所有文章，並通過迴圈吧它們和蒐集到變數post_lists中，最後使用`return HttpResponse(post_lists)把這個變數的內容輸出到使用者端的瀏覽器頁面中。

然後由urls.py負責呼叫這個函式。url.py負責網址和程式間的對應工作。開啟urls.py匯入來自views.py的homepage函式並以url對應。

from django.conf.urls import include, url
from django.contrib import admin
from mainsite.views import homepage, showpost

urlpatterns = [
    url(r'^$', homepage),
    url(r'^admin/', include(admin.site.urls)),
]

寫程式時，顯示的樣子和如何儲存資料或資料內容要分來才比較容易維護，
因此，正確的做法是在views.py中把資料或資料準備好，然後放到template中，讓template中的.html檔案負責真正顯示的工作。

2.3 網址對應於頁面輸出

如何把前面拿到的資料變得更加美觀？答案是通過模板template。每一個輸出的網頁都可以準備一個或以上對應的模板，這些模板以.html的檔案形式儲存在指定的資料夾中，當網站有資料需要輸出時，通過渲染函式(render)把資料存放到模板指定的位置中，得到結果後再交給HttpResponse輸出給瀏覽器。
基本步驟如下：

• 在setting.py中設定模板資料夾的位置
• 在url.py中建立網址和view.py中函式的對應關係
• 建立.html檔案(例如index.html),做好排版並安排資料要防止的位置
• 執行程式，以objects.all()在views.html中取得資料或資料
• 以render函式把資料(例如posts)送到指定的模板檔案(例如index.html)中

建立templates資料夾，然後把此資料夾名稱加到settings.py的TEMPLTE區塊中(只需修改DIRS所在行即可)：

'DIRS': [os.path.join(BASE_DIR, 'templates')],

然後把post和now放到模板(例index.html)中顯示，把views.py修改如下：

from django.template.loader import get_template
from django.http import HttpResponse
from datetime import datetime
from .models import Post
# Create your views here.

def homepage(request):
    template = get_template('index.html')
    posts = Post.objects.all()
    now = datetime.now()
    html = template.render(locals())
    return HttpResponse(html)

這裡使用了一個小技巧把變數放到模板中，就是使用local()函式。這個函式會把當前記憶體中的所有區域性變數使用字典型別打包起來。在模板中因為接收到了所有區域性變數，所有也可以把posts和now都拿來使用。

在templates目錄下，建立一個名為index.html的模板檔案：

<!DOCTYPE html>
<html>
<head>
    <meta charset='utf-8'>
    <title>
        歡迎觀臨我的部落格
    </title>
</head>
<body>
    <h1>歡迎觀臨我的部落格</h1>
    <hr>
    {% for post in posts %}
        <p style='font-family:微軟雅黑；font-size:14pt;font-weight:bold;'>
            <a href='/post/'{{post.slug}}'>{{ post.title }}</a>         
        </p>
    <% endfor %>
    <hr>
    <h3>現在時刻：{{ now }}</h3>
</body>
</html>

使用{{}}用來輸出收到的資料,每一個數據項的欄位都是以post.body、post.title的方式取出。

通過<a href>HTML標籤取出post.slug，建立為連結網址，並放在post/下。

網址對應url.py
要識別這些網址以便對應到要顯示的單篇文章內容，有如下幾步：

• 在url.py中設定，只要是/post/開頭的網址，就把後面接著的文字當做引數傳送slug給post_detail顯示單篇文章的函式。
• 在view.py中新增一個post_detail函式，除了接受request引數外，也接受slug引數
• 在templates資料夾中建立一個用來顯示單篇文章的post.html
• 在post_detail函式中，以slug為關鍵字搜尋資料集，找出是否有符合的專案
• 如果有，就把找到的資料項傳送給render函式，找出post.html模板頁進行渲染(即進行網頁顯示)，再把結果交給HttpResponse回傳給瀏覽器
• 如果沒有符合的專案，就把網頁傳回首頁

mblog/urls.py做如下修改：

from django.conf.urls import include, url
from django.contrib import admin
from mainsite.views import homepage, showpost

urlpatterns = [
    url(r'^$', homepage),
    url(r'^post/(\w+)$', showpost),
    url(r'^admin/', include(admin.site.urls)),
]

把所有/post開頭的網址都找出來，作為當做第二個引數(第一個是預設的request)傳給showpost函式。

同時在views.py中新建這個函式來處理收到的引數，內容如下：

from django.template.loader import get_template
from django.http import HttpResponse
from datetime import datetime
from .models import Post
from django.shortcuts import redirect
# Create your views here.
... 

def showpost(request, slug):
    template = get_template('post.html')
    try:
    post = Post.objects.get(slug=slug)
    if post != None:
        html = template.render(locals())
        return HttpResponse(html) 
    except:
    return redirect('/')

加上意外處理，在搜尋發生意外時以redirect(‘/’)的方式直接返回首頁。

顯示文章的post.html內容如下

<!DOCTYPE html>
<html>
<head>
    <meta charset='utf-8'>
    <title>
        歡迎觀臨我的部落格
    </title>
</head>
<body>
    <h1>{{ post.title }}</h1>
    <hr>
        <p style='font-family:微軟雅黑;font-size:12pt;letter-spacing:2pt;'>
            {{ post.body }}
        </p>
    <hr>
    <h3><a href='/'>回首頁</a></h3>
</body>
</html>