使用 Pelican 建立 blog

這篇要介紹如何使用 pelican 建立 blog。 Pelican 是用 python 搭建的 blog 系統，在整合 IPython notebook 這部份頗受好評。所以也不少人用 IPython notebook 寫完報告或教學後，直接用 Pelican 建立的 blog 發表文章。

基本上雖然在第一 po 有略為提到如何建立 blog，但事實上我還是為了一些技術問題抓掉不少頭髮。還好問題全部都解決了，所以在這邊作個紀錄。

我使用的作業環境是 ubuntu 14.04 LTS, Python 2.7.8，參考資料來源為：

建立部落格大概有幾個步驟要作

安裝套件

目前看到的部落格都會建議用 virtualenv 安裝所需套件，不過我個人是用 Pyenv，比 virtualenv 方便很多。關於 Pyenv 的安裝方式，可以參考這篇文章。

假設已經安裝好 Pyenv 後，首先新增資料夾，以及新增一個 virtualenv

mkdir pelican
cd pelican
pyenv virtualenv 2.7.8 pelican
pyenv local pelican

接下來是安裝套件，先把 requirements.txt 儲存到目前的資料夾，鍵入以下指令安裝套件

pip install -r requirements.txt

這樣就可以確保大家的版本相同了！

git clone

接著安裝 theme 跟 plugins：

git clone https://github.com/jakevdp/pelican-octopress-theme.git
git clone https://github.com/getpelican/pelican-plugins.git

theme 目前是引用 jakevdp 的設定，因為該作者有針對 Ipython notebook 的顯示作調整，直接拿現成的來用比較方便。而且我也蠻喜歡這風格的。如果想換其他佈景主題的話，請參考這邊的建議。

其實如果熟悉 pelican 的話，是可以選擇自己用 pelican-quickstart 一步步建立 blog 的。但這邊我選擇拿前人的設定來改：

git clone https://github.com/ocefpaf/python4oceanographers

接著移到 python4oceanographers 目錄下，將 pelicanconf.py 檔案裡的 THEME 跟 PLUGIN_PATH 修改成你放置 pelican-octopress-theme 跟 pelican-plugins 的路徑：

path = os.path.join(os.environ.get('HOME'), 'pelican')
THEME = '%s/pelican-octopress-theme' % path
PLUGIN_PATH = '%s/pelican-plugins' % path

localhost 測試

接著可以先試著編譯，作第一次 local 端測試了。編譯後的檔案會放在 output 資料夾中，所以要切換至 output 資料夾設定 server。

make html
cd output
python -m SimpleHTTPServer 8080

接著開啟瀏覽器，到 http://localhost:8080 看看結果如何。如果順利的話，這時應該可以看到 blog 了。

修改設定

接下來開啟 pelicanconf.py ，修改自己想要的設定。這邊簡單介紹幾個必改的設定

AUTHOR 作者
SITENAME 站名
SITESUBTITLE 站名副標題
uri GitHub Pages 站名，格式為 http://帳號.github.io
LINKS 友站連結
TWITTER_USER 你的 Twitter 帳號
GOOGLEPLUS_USER 你的 Google+ 帳號

以上改完後再重新編譯後試試，應該這時站名之類的應該都改過來了。

發表文章

文章統一儲存在 content 資料夾裡，或是自己改 pelicanconf.py 裡面設定。可以用 reStructured Text 或 Markdown 格式書寫，我個人比較偏好 Markdown，所以以 markdown 語法說明。

每篇文章都是一個獨立檔案，檔名格式為 yyyy-mm-dd-blogging.md。前面是日期，後面是文章識別名稱。以本篇文章為例，文章開頭有以下 tag：

title: 如何利用 pelican 建立 blog
date: 2014-08-07 00:30
comments: true
slug: buildblog
tags: python, pelican

slug 是唯一的，可以不寫. tags 可寫可不寫。

後面文章內容的部份就看個人發揮了。關於 markdown 格式寫法，可以參考 wiki。若是想直接把 IPython notebook 貼過來的人，先把 ipynb 檔案拷貝至 content/downloads/notebooks ， md 檔最後加上以下這行：

{% notebook blogging.ipynb cells[1:] %}

所以往後發表文章的時候，可以先在 local 端編譯測試，看看格式有沒有跑掉之類的，確定可以了再上線。上線前記得先把 content 資料夾裡面前作者的文章砍光，資料夾別跟著砍了，留下自己的文章就好。

GitHub 上線

當你寫好文章準備上線了，找個可以放置 blog 的地方也是一門學問。這邊建議直接丟 GitHub，好處是完全免費，只是檔案要被看光光（但其實這個站也是拿人家現成的來改，就算完全 open 也是應該的吧）。或者你也可以考慮放到 Heroku 去，設定方式請看參考資料。

在 GitHub 上線前，要先把 GitHub remote 目錄改一改。我的方式是先去 GitHub 開一個 repository，假定名稱為 blog 好了。然後修改 python4oceanographers 資料夾名稱為 blog，接著修改 GitHub remote 設定為 blog：

git remote remove origin
git remote add origin https://github.com/帳號/blog.git
git push -u origin master

接下來就是利用 GitHub Pages 把 blog 推上線， GitHub 的實作方式是建立一個新的 branch 叫做 gh-pages。原則上只要把 output 資料夾的內容放到 gh-pages 這個 branch 就行了。但實際上很不容易，還好 Pelican 都幫你搞定了，只要鍵入 make github ，Pelican 就會幫你編譯，然後上傳到 gh-pages。也不需要切換 branch。
但要注意的是，編譯的內容是以 master 為基礎的，所以要先 git push master 後，才能 make github。

設定 Google Analytics, Disqus

上線後可以去註冊 Google Analytics 跟 Disqus 服務。 Google Analytics 可以幫忙作網站流量分析，而 Disqus 是網站留言管理系統。註冊過後會得到一個代碼，再把這些代碼寫到 publishconf.py 裡相對應的欄位去，記得把 SITEURL 改成自己在 GitHub 的網址。這樣應該就可以了。

Gilbert's Data Lab

Data drives thinking, thinking transforms data.