其實,更正確來說,我只是想用靜態網頁來做程式碼筆記,以前都是用BBS來記錄,但近年來越來越冷清了,加上架在別人主機上的東西總是很難掌控(Github明明也是架在別人主機上面),在最近看到這篇文章「搬到Octopress了」,故想試試看架在github page上面,但Octopress的style我看了實在不太順眼,在找到pelican之後很是喜歡,加上他是用Python撰寫,也許日後可以試試寫些plugin(嘴砲無誤),於是...就出現這篇了XD
OS 介紹: OS X 10.9 Mavericks
所需環境: 請先裝好Python(2.7.X, 3.3+)、distribute、pip、virtualenv
先到你想建立部落格的資料夾下建立虛擬環境
virtualenv PelicanEnv --distribute
啟動虛擬環境
source PelicanEnv\bin\activate
安裝Pelican
pip install pelican
想用Markdown寫文章的話,順便安裝Markdown
pip install Markdown
先建立目錄
mkdir myblog
cd myblog
pelican 快速建立部落格指令
pelican-quickstart
P.S.要注意的是,我在執行這行時出現過Error:
ValueError: unknown locale: UTF-8
疑似是一些系統的設定檔出錯,也許是OS X升級後的error
解決方式可以參見這篇-Pelican 3.3 pelican-quickstart error
此時會出現一堆要輸入的設定,我一開始也不懂,就都跟著default設定即可
日後可以從pelicanconf.py裡面更改設定
建立出來的目錄結構:
myblog/
├── content # 存放输入的原始碼
│ └── (pages) # 存放手工建立的靜態頁面
├── output # 生成的输出文件
├── develop_server.sh # 方便開啓測試服務器
├── Makefile # 方便管理部落格的Makefile
├── pelicanconf.py # 主配置文件
└── publishconf.py # 發佈時使用的配置文件
先進入content目錄資料夾,用Markdown語法寫如下文章,副檔名須為.mdown:
Title: My super title
Date: 2010-12-03 10:20
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Author: Alexis Metaireau
Summary: Short version for index and feeds
This is the content of my super blog post.
之後推出content目錄(即當前目錄為myblog),執行
make html
此時ouput資料夾下就會根據你之前所有的變動生成對應的html檔。
先在自己的Github帳號之中,新建一個Repositiry
Repositiry名字為「xxx.github.io」或「xxx.github.com」
P.S.xxx要等於你的github帳號的username,我之前失敗就是卡在這
創好之後到output目錄下,將生好的html檔push到github上
cd output
git init
git add .
git commit -m "first commit"
git remote add origin https://github.com/xxx/xxx.github.io.git
git push -u origin master
等一下之後,到xxx.github.io應該就可以看到你剛剛建立的文章了!(灑花~)
P.S.Push上去之後,會過幾分鐘才看到文章更新,這是正常現象。