使用 django-blog-zinnia 搭建我的博客

目前網上搭建我的博客的方案不少，雖然使用諸如 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 的 <head> 標籤裏添加一行：

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，若是沒有的話請參考郵箱服務商的相關設置進行開啓。