用Pelican和Github Pages在Linux上搭建我的博客

搭建環境

在Linux環境下搭建，採用ubuntu，使用其它發行版過程基本相同。

Github Pages

• 註冊Github,註冊和配置SSH密鑰過程help page寫得很清楚。
• 不過如今github支持http傳輸良好，因此也能夠不用配置ＳＳＨ，經過用戶名密碼便可登陸。
• 在Github建立一個名爲username.github.io的版本庫（將username替換成本身的Github帳戶名）。
• Setting -> Automatic page generator -> Continue to layout，選擇一個模板，併發布。

十分鐘後在username.github.io頁面就已經生成了一個頁面。訪問該網址便可看到。

配置本地環境

安裝Ｐｅｌｉｃａｎ和Ｍａｒｋｄｏｗｎ：

在這裏我沒有用Jekyll由於它是Ｒｕｂｙ寫的對它沒什麼興趣。因此我採用Ｐｙｔｈｏｎ編寫的Ｐｅｌｉｃａｎ。

介紹

Pelican是一套開源的使用Python編寫的博客靜態生成, 能夠添加文章和和建立頁面, 可使用MarkDown reStructuredText 和 AsiiDoc 的格式來抒寫, 同時使用 Disqus評論系統, 支持 RSS和Atom輸出, 插件, 主題, 代碼高亮等功能, 採用Jajin2模板引擎, 能夠很容易的更改模板

安裝

安裝Ｐｅｌｉｃａｎ有不少種方法。一種使用ｐｙｔｈｏｎ的包管理器ｐｉｐ進行安裝。

$sudo apt-get install python-pip
$sudo pip install pelican
$sudo pip install markdown

另外一種就是從ｇｉｔｈｕｂ上克隆Ｐｅｌｉｃａｎ。

git clone git://github.com/getpelican/pelican.git       
cd pelican
python setup.py install

寫第一篇博客

搭建目錄

mkdir blog
cd blog
pelican-quickstart

在回答一系列問題事後你的博客就建成的, 主要生成下列文件:
生成的目錄結構:

blog/
├── content
│   └── *.md             # markdown文件
├── output               # 默認的輸出目錄
├── develop_server.sh
├── Makefile
├── pelicanconf.py       # 主配置文件
└── publishconf.py

寫一篇文章

在 content目錄新建一個 test.md文件, 填入一下內容:

Title: 文章標題
Date: 2013-04-18
Category: 文章類別
Tag: 標籤1, 標籤2
這裏是內容

而後執行

make html

生成了ｈｔｍｌ。而後執行

./develop_server.sh start

開啓一個測試服務器, 這會在本地 8000 端口創建一個測試web服務器, 可使用瀏覽器打開:http://localhost:8000來訪問這個測試服務器, 而後就能夠欣賞到你的博客了

建立一個Ａｂｏｕｔ頁面

這裏以建立 About頁面爲例

在content目錄建立pages目錄

mkdir content/pages

而後建立About.md並填入下面內容

Title: About Me
Date: 2013-04-18

About me content

執行 make html 生成html, 而後打開http://localhost:8000查看效果

使用Ｐｅｌｉｃａｎ支持評論

使用Disqus做爲評論系統，註冊賬號後直接在pelicanconf.conf中添加:

DISQUS_SITENAME = your_shortname

而後執行

make html

使用瀏覽器打開:http://localhost:8000來查看效果

主題

安裝主題：
Ｐｅｌｉｃａｎ自己提供不少主題可供選擇，能夠從ｇｉｔｈｕｂ上ｃｌｏｎｅ下來

git clone https://github.com/getpelican/pelican-themes.git
cd pelican-themes
pelican-themes -i bootstrap2

其中bootstrap2是選擇使用的主題，pelican主題的Github目錄下幾乎每一個都提供了預覽.

而後，在配置文件pelicanconf.py中添加：

THEME = u"bootstrap2'

從新make，就生成了帶有選定主題的頁面。

使用插件

Pelican 一開始是將插件內置的, 可是新版本 Pelican將插件隔離了出來, 因此咱們要到github上 克隆一份新的插件, 在博客目錄執行

git clone git://github.com/getpelican/pelican-plugins.git

如今咱們博客目錄就新添了一個 pelican-plugins目錄, 咱們已配置sitemap插件爲例, sitemap插件能夠生成 sitemap.xml 供搜索引擎使用

在pelicanconf.py配置文件里加上以下項:

PLUGIN_PATH = u"pelican-plugins"

PLUGINS = ["sitemap"]

配置sitemap 插件

SITEMAP = {
    "format": "xml",
    "priorities": {
        "articles": 0.7,
        "indexes": 0.5,
        "pages": 0.3,
    },
    "changefreqs": {
        "articles": "monthly",
        "indexes": "daily",
        "pages": "monthly",
    }
}

而後再執行

make html

打開瀏覽器請求 http://localhost:8000/sitemap.xml便可看到生成的 Sitemap 了

添加Google Analytics

去Google Analytics申請帳號，記下跟蹤ID。 在pelicanconf.py添加

GOOGLE_ANALYTICS = 跟蹤ID

使用Google Webmasters

在Google Webmasters上註冊便可。
這個就是Google站長工具，使用它的目的是爲了讓博客被Google更好的收錄，好比手動讓Googlebot抓取、提交Robots、更新Sitemap等等，各方面完爆百度站長工具。

上傳Ｇｉｔｈｕｂ

最後在你的ｏｕｔｐｕｔ文件夾內

git init
git add .
git commit -m 'first commit' 
git remote add origin git@github.com:yourname/yourname.github.io.git
git push -u origin master

這樣就大功告成了！