示範如何在github上搭建Blog，你可以從中掌握github的Pages功能，以及Jekyll軟件的基本用法。更重要的是，你會體會到一種建立網站的全新思路。
一、Github Pages 是什麼？
如果你對編程有所瞭解，就一定聽說過github。它號稱程序員的Facebook，有着極高的人氣，許多重要的項目都託管在上面。
簡單說，它是一個具有版本管理功能的代碼倉庫，每個項目都有一個主頁，列出項目的源文件。
但是對於一個新手來說，看到一大堆源碼，只會讓人頭暈腦漲，不知何處入手。他希望看到的是，一個簡明易懂的網頁，說明每一步應該怎麼做。因此，github就設計了Pages功能，允許用戶自定義項目首頁，用來替代默認的源碼列表。所以，github Pages可以被認爲是用戶編寫的、託管在github上的靜態網頁。
github提供模板，允許站內生成網頁，但也允許用戶自己編寫網頁，然後上傳。有意思的是，這種上傳並不是單純的上傳，而是會經過Jekyll程序的再處理。
二、Jekyll是什麼？
Jekyll（發音/'dʒiːk əl/，"傑克爾"）是一個靜態站點生成器，它會根據網頁源碼生成靜態文件。它提供了模板、變量、插件等功能，所以實際上可以用來編寫整個網站。
整個思路到這裏就很明顯了。你先在本地編寫符合Jekyll規範的網站源碼，然後上傳到github，由github生成並託管整個網站。
這種做法的好處是：
* 免費，無限流量。
* 享受git的版本管理功能，不用擔心文章遺失。
* 你只要用自己喜歡的編輯器寫文章就可以了，其他事情一概不用操心，都由github處理。
它的缺點是：
* 有一定技術門檻，你必須要懂一點git和網頁開發。
* 它生成的是靜態網頁，添加動態功能必須使用外部服務，比如評論功能就只能用disqus。
* 它不適合大型網站，因爲沒有用到數據庫，每運行一次都必須遍歷全部的文本文件，網站越大，生成時間越長。
但是，綜合來看，它不失爲搭建中小型Blog或項目主頁的最佳選項之一。
三、一個實例
下面，我舉一個實例，演示如何在github上搭建blog，你可以跟着一步步做。爲了便於理解，這個blog只有最基本的功能。
在搭建之前，你必須已經安裝了git，並且有github賬戶。
第一步，創建項目。
在你的電腦上，建立一個目錄，作爲項目的主目錄。我們假定，它的名稱爲jekyll_demo。
$ mkdir jekyll_demo
對該目錄進行git初始化。
$ cd jekyll_demo
$ git init
然後，創建一個沒有父節點的分支gh-pages。因爲github規定，只有該分支中的頁面，纔會生成網頁文件。
$ git checkout --orphan gh-pages
以下所有動作，都在該分支下完成。
第二步，創建設置文件。
在項目根目錄下，建立一個名爲_config.yml的文本文件。它是jekyll的設置文件，我們在裏面填入如下內容，其他設置都可以用默認選項，具體解釋參見官方網頁。
baseurl: /jekyll_demo
目錄結構變成：
/jekyll_demo
|-- _config.yml
第三步，創建模板文件。
在項目根目錄下，創建一個_layouts目錄，用於存放模板文件。
$ mkdir _layouts
進入該目錄，創建一個default.html文件，作爲Blog的默認模板。並在該文件中填入以下內容。
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>{{ page.title }}</title>
</head>
<body>
{{ content }}
</body></html>
Jekyll使用Liquid模板語言，{{ page.title }}表示文章標題，{{ content }}表示文章內容，更多模板變量請參考官方文檔。
目錄結構變成：
/jekyll_demo
|-- _config.yml
|-- _layouts
| |-- default.html
第四步，創建文章。
回到項目根目錄，創建一個_posts目錄，用於存放blog文章。
$ mkdir _posts
進入該目錄，創建第一篇文章。文章就是普通的文本文件，文件名假定爲2012-08-25-hello-world.html。(注意，文件名必須爲"年-月-日-文章標題.後綴名"的格式。如果網頁代碼採用html格式，後綴名爲html；如果採用markdown格式，後綴名爲md。）
在該文件中，填入以下內容：（注意，行首不能有空格）
---
layout: default
title: 你好，世界
---<h2>{{ page.title }}</h2>
<p>我的第一篇文章</p>
<p>{{ page.date | date_to_string }}</p>
每篇文章的頭部，必須有一個yaml文件頭，用來設置一些元數據。它用三根短劃線"---"，標記開始和結束，裏面每一行設置一種元數據。"layout:default"，表示該文章的模板使用_layouts目錄下的default.html文件；"title: 你好，世界"，表示該文章的標題是"你好，世界"，如果不設置這個值，默認使用嵌入文件名的標題，即"hello world"。
在yaml文件頭後面，就是文章的正式內容，裏面可以使用模板變量。{{ page.title }}就是文件頭中設置的"你好，世界"，{{ page.date }}則是嵌入文件名的日期（也可以在文件頭重新定義date變量），"| date_to_string"表示將page.date變量轉化成人類可讀的格式。
目錄結構變成：
/jekyll_demo
|-- _config.yml
|-- _layouts
| |-- default.html
|-- _posts
| |-- 2012-08-25-hello-world.html
第五步，創建首頁。
有了文章以後，還需要有一個首頁。
回到根目錄，創建一個index.html文件，填入以下內容。
---
layout: default
title: 我的Blog
---<h2>{{ page.title }}</h2>
<p>最新文章</p>
<ul>
{% for post in site.posts %}
<li>{{ post.date | date_to_string }} <a href="{{ site.baseurl }}{{ post.url }}">{{ post.title }}</a></li>
{% endfor %}
</ul>
它的Yaml文件頭表示，首頁使用default模板，標題爲"我的Blog"。然後，首頁使用了{% for post in site.posts %}，表示對所有帖子進行一個遍歷。這裏要注意的是，Liquid模板語言規定，輸出內容使用兩層大括號，單純的命令使用一層大括號。至於{{site.baseurl}}就是_config.yml中設置的baseurl變量。
目錄結構變成：
/jekyll_demo
|-- _config.yml
|-- _layouts
| |-- default.html
|-- _posts
| |-- 2012-08-25-hello-world.html
|-- index.html
第六步，發佈內容。
現在，這個簡單的Blog就可以發佈了。先把所有內容加入本地git庫。
$ git add .
$ git commit -m "first post"
然後，前往github的網站，在網站上創建一個名爲jekyll_demo的庫。接着，再將本地內容推送到github上你剛創建的庫。注意，下面命令中的username，要替換成你的username。
$ git remote add origin https://github.com/username/jekyll_demo.git
$ git push origin gh-pages
上傳成功之後，等10分鐘左右，訪問http://username.github.com/jekyll_demo/就可以看到Blog已經生成了（將username換成你的用戶名）。
首頁：
文章頁面：
第七步，綁定域名。
如果你不想用http://username.github.com/jekyll_demo/這個域名，可以換成自己的域名。
具體方法是在repo的根目錄下面，新建一個名爲CNAME的文本文件，裏面寫入你要綁定的域名，比如example.com或者xxx.example.com。
如果綁定的是頂級域名，則DNS要新建一條A記錄，指向204.232.175.78。如果綁定的是二級域名，則DNS要新建一條CNAME記錄，指向username.github.com（請將username換成你的用戶名）。此外，別忘了將_config.yml文件中的baseurl改成根目錄"/"。
至此，最簡單的Blog就算搭建完成了。進一步的完善，請參考Jekyll創始人的示例庫，以及其他用Jekyll搭建的blog。
（完）