目前網上搭建個人部落格的方案很多，雖然使用諸如 Wordpress ( PHP )、Hexo ( Node.js ) 等可以方便快速地搭建一款功能齊全的高效能個人部落格，但是本文將嘗試一種更為小眾化的方案 —— 一款基於 django-blog-zinnia ( Python ) 的個人部落格應用。

django-blog-zinnia 雖然小巧，但是具備了個人部落格應用的全部基礎功能，且具有很高的拓展性，並且開箱即用。以下是官方列出的一些特性：

• 評論
• 站點地圖（用於搜尋引擎優化）
• 文章歸檔檢視（自動按時間歸檔博文，包括年、月、星期、日各個時間維度）
• RSS 或者 Atom Feed
• 分類和標籤雲
• 全文搜尋
• Markdown 語法標記

等等其他一些部落格應用具備的全部基本功能。

你可以參照它的官方文件 ( django-blog-zinnia documentation ) 的 installation 部分進行初始的安裝，但本文也會給出詳細的安裝教程，並對相關的細節進行進一步補充，對功能進行進一步地拓展設定。

注：本部落格在寫作時每一個步驟均在實際環境下測試了一遍，基本確保沒有問題。但是由於個人寫作時的疏忽或者計算機環境的差異，也可能會有一些錯誤導致你卡在某個地方無法繼續進行下去。如果是這樣請給我留言，我和你一起排查問題，如果發現是部落格寫作時的錯誤也好使我儘快更正。

建立虛擬環境

因為在安裝 django-blog-zinnia 的過程中會安裝很多其他第三方依賴包，因此強烈建議使用虛擬環境安裝，以免把系統環境弄亂。

假設你的 python 版本是 3.4 或更高（建議使用 3.4 以上版本，當然 django-blog-zinnia 本身是相容 python2.7 及以上版本的），且已經安裝了虛擬環境管理工具 virtualenv，如果沒有的話通過 pip install virtualenv 安裝。開啟命令列，進入到你想建立虛擬環境的目錄，通過命令 virtualenv zinnia_demo_env 建立一個名為 zinnia_demo_env 的虛擬環境，當然 zinnia_demo_env 這個目錄名你可以任意指定。進入到建立的虛擬環境的 Scripts 目錄下，輸入 activate 命令啟用虛擬環境，此時命令列前多了一個 ( zinnia_demo_env ) 說明已經啟用，例如我的是：

(zinnia_demo_env) D:\Users\zmrenwu\Envs\zinnia_demo_env\Scripts>

通過 pip install django==1.9.6 安裝 django，建議使用 1.9.6 版本，當然 >=1.9 的版本都是相容的，但注意目前不相容 django1.10。

建立 django 工程

進入你喜歡的目錄（確保依然在虛擬環境中，如果沒有則按照上面的方法重新開啟，且下邊的操作預設都在虛擬環境中執行，因此不要退出），通過命令 python django-admin.py startproject zinnia_demo 建立一個 django 工程。這裡 zinnia_demo 是專案名，可以取任何你喜歡的名字。此時你會發現多了一個名為 zinnia_demo 的目錄，這樣 django 工程就建立好了。進入到這個目錄，會看到有一個 manage.py 檔案，嘗試執行命令 python manage.py runserver，不報錯的話，在瀏覽器輸入 127.0.0.1:8000，看到如下字樣說明 django 工程已經可以正確執行。

It worked!

Congratulations on your first Django-powered page.

Of course, you haven’t actually done any work yet. Next, start your first app by running python manage.py startapp [app_label].

You’re seeing this message because you have DEBUG = True in your Django settings file and you haven’t configured any URLs. Get to work!

按 Ctrl + c 退出伺服器。

安裝 zinnia 及其依賴

在虛擬環境中輸入 pip install django-blog-zinnia 安裝 django-blog-zinnia，必要的依賴其會自動幫我們安裝，但是一些拓展依賴需要我們手動安裝，包括：

pip install markdown 安裝 markdown，以便使部落格文章支援 markdown 格式的文字。

pip install pygments 安裝 pygments，以便支援程式碼語法高亮。

設定 settings.py 檔案

進入到 zinnia_demo/zinnia_demo （當然你可能設定了其他專案名，但我相信你能找到），開啟 settings.py 檔案（用文字編輯器或者 python IDE 開啟，不要直接執行），在 INSTALL_APPS 列表裡新增以下的 APP，這些 APP 都是 django-blog-zinnia 依賴執行的 APP ：

zinnia_demo/zinnia_demo/settings.py

INSTALLED_APPS = [
    # 工程建立時預設新增的app
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    # 專案新增的app
    'django.contrib.sites',
    'django_comments',
    'mptt',
    'tagging',
    'zinnia',
]

在 TEMPLATES 列表的如下位置加入 zinnia.context_processors.version ，當然這一步是可選的，其作用只是在部落格頁面的底部顯示一個django-blog-zinnia 的版本號：

zinnia_demo/zinnia_demo/settings.py

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',

                # 新增這句
                'zinnia.context_processors.version',  # Optional
            ],
        },
    },
]

在 ALLOWED_HOSTS = [] 的下面新增 SITE_ID = 1

zinnia_demo/zinnia_demo/settings.py

ALLOWED_HOSTS = []
SITE_ID = 1

並修改語言和時區，獲得更友善的語言和時間顯示，注意 + 號表示新增的行，- 號表示刪去的行：

zinnia_demo/zinnia_demo/settings.py

- LANGUAGE_CODE = 'en-us'
+ LANGUAGE_CODE = 'zh-hans'

- TIME_ZONE = 'UTC'
+ TIME_ZONE = 'Asia/Shanghai'

設定 urls.py 檔案

開啟相同目錄下的 urls.py 檔案，做如下修改，注意 + 號表示新增的行，- 號表示刪去的行：

zinnia_demo/zinnia_demo/urls.py

- from django.conf.urls import url
+ from django.conf.urls import url,include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    + url(r'^weblog/', include('zinnia.urls')),
    + url(r'^comments/', include('django_comments.urls')),
]

同步資料庫並建立後臺管理員賬戶

在 manage.py 檔案所在目錄下輸入 python manage.py migrate 建立相應的資料庫表結構。此時會看到目錄下多了一個 db.sqlite 檔案，這是儲存部落格資料的資料庫檔案，預設使用的 sqlite3。輸入命令 python manage.py createsuperuser 建立後臺管理員賬戶，命令列會提示你輸入使用者名稱、郵箱、密碼。注意密碼輸入時不會有任何顯示，只管輸下去就行。

開啟開發伺服器

再次執行 python manage.py runserver 開啟開發伺服器，在瀏覽器輸入 127.0.0.1:8000/weblog 將看到部落格的首頁面。輸入 127.0.0.1:8000/admin 會進入後臺登入頁面，輸入剛才建立的管理員賬戶使用者名稱和密碼就可以登入到後臺管理介面。在日誌後面點選增加按鈕嘗試著新增一篇部落格看看！再次進入 127.0.0.1:8000/weblog 就可以看到剛才發表的部落格了。

至此基本的部落格已經搭建完畢，接下來是一些可選功能拓展，包括 markdown 語法支援，程式碼高亮，bootstrap 主題的安裝。

( OPTIONAL ) Markdown 語法支援

再次開啟 settings.py 檔案，在檔案的最後新增：

zinnia_demo/zinnia_demo/settings.py

...
ZINNIA_MARKUP_LANGUAGE = 'markdown'
ZINNIA_MARKDOWN_EXTENSIONS = ['markdown.extensions.extra', 'markdown.extensions.codehilite']

bingo！！

ZINNIA_MARKUP_LANGUAGE 指明瞭使用 markdown 語法標記，ZINNIA_MARKDOWN_EXTENSIONS 做了兩個拓展，其中 markdown.extensions.codehilite 表示支援語法高亮，markdown.extensions.extra 包含的特性請參見 markdown 相關文件。

( OPTIONAL ) 安裝 Bootstrap 主題

如果你不喜歡原生的主題的話，django-blog-zinnia 為我們提供了一套 bootstrap 主題，相對來說更加好看一點。雖然說實在話內建的主題感覺都已經過時了，因此我重新為它設定了一套全新的主題，稍後會有介紹。

中斷伺服器的執行，進入到虛擬環境（如果你已經退出了的話），首先輸入命令 pip install django-app-namespace-template-loader 安裝 django-app-namespace-template-loader，這是替換主題的一個必要元件。再輸入 pip install zinnia-theme-bootstrap 安裝主題 APP ，開啟 settings.py 檔案，在 INSTALLED_APPS 中註冊主題 APP ，注意主題 zinnia_bootstrap 一定要在 zinnia 之前：

zinnia_demo/zinnia_demo/settings.py

INSTALLED_APPS = [
    ...
    'zinnia_bootstrap',
    'zinnia',
]

再將 TEMPLATES 列表做如下修改：

zinnia_demo/zinnia_demo/settings.py

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        - 'APP_DIRS': True,
        + 'APP_DIRS': False,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                'zinnia.context_processors.version',  # Optional
            ],

            # 新增下面這幾行
            'loaders': [
               'app_namespace.Loader',
               'django.template.loaders.filesystem.Loader',
               'django.template.loaders.app_directories.Loader',
            ],
            # 新增上面幾行
        },
    },
]

此時再次開啟伺服器，進入主頁 127.0.0.1:8000/weblog 就可以看到主題變成了 bootstrap 樣式了。

( OPTIONAL ) 語法高亮支援

注意：這一步必須在安裝完 bootstrap 主題之後。

pygments 已經幫我做好了一切語法高亮的準備，其原理就是把 html 中的程式碼文字分成很多塊，用適當的 html 標籤包裹，並且新增相應的 css 類，我們只需引入一個相應的 css 樣式檔案即可。

為了方便起見，我們新建一個 APP 來存放我的需要引入的 css 樣式檔案，在 zinnia_demo/ 目錄下（與 manage.py 同級）下輸入 python manage.py startapp theme，這樣我們就建立了一個名為 theme 的 app，可以看到 zinnia_demo/ 多了一個 theme 的資料夾。

在 zinnia_demo/ 目錄下（與 manage.py 同級）建立如下的目錄結構和檔案：

zinnia_demo/templates/zinnia/skeleton.html，把這裡面的內容：skeleton 模板程式碼 ，複製到 skeleton.html中，並且在 skeleton.html 的 標籤裡新增一行：

zinnia_demo/templates/zinnia/skeleton.html

<link rel="stylesheet" href="{% static "theme/css/github.css" %}" />

再在 zinnia_demo/ 下建立如下的目錄結構和檔案：

zinnia_demo/theme/static/theme/css/github.css，把這裡面的內容：github.css 樣式程式碼 ，複製到 github.css 檔案中。

開啟 settings.py 檔案，做如下修改：

zinnia_demo/zinnia_demo/settings.py

TEMPLATES = [
    {
        ...
        # 修改成下面的樣子，作用是指明模板檔案所在目錄，即上面我們寫的skeleton.html
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        ...
    }
]

將 theme app 註冊到 INSTALLED_APPS 列表中：

zinnia_demo/zinnia_demo/settings.py

INSTALLED_APPS = [
    ...
    'theme',
    'zinnia_bootstrap',
    'zinnia',
]

開啟開發伺服器，進入相應頁面就可以看到程式碼高亮效果了。記得事先填充一些程式碼到部落格文章中。

我的拓展專案

考慮到自帶的主題讓人略微有些不滿意（因為我本人更加喜歡簡約一些的），所以自己替換了一套新的主題，你可以先預覽一下效果：追夢人物的個人部落格，做一個對比。由於目前還沒有做成外掛，因此如果感興趣的話可以 follow 我 GitHub 上的專案：ZinniaBlog 。首頁的 readme.md 檔案已經給出詳細的本地安裝和伺服器部署過程，可供參考。我會嘗試著不斷維護新增一些拓展的功能進去（目前只是替換了一套主題模板）。如果你有想新增新的功能可以嘗試著參考官方文件自己新增，或者給我留言，我可能會採納。

結束

PS：

自帶的評論功能當有人回覆你發表的部落格文章後會傳送一封 email 給你的後臺管理員賬戶郵箱（建立後臺管理員賬戶填寫的）。不過需要設定好傳送郵件的郵箱，參考配置如下，在 settings.py 中：

zinnia_demo/zinnia_demo/settings.py

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.163.com' # 如果不是163郵箱請替換為郵箱服務商的smtp伺服器地址
EMAIL_PORT = 465
EMAIL_HOST_USER = '你的郵箱賬號'  # add your own accounts for local test
EMAIL_HOST_PASSWORD = '你的郵箱密碼'
EMAIL_USE_SSL = True
DEFAULT_FROM_EMAIL = EMAIL_HOST_USER

不過要確保你的郵箱開啟了 SMTP，如果沒有的話請參考郵箱服務商的相關設定進行開啟。