開始之前

需要對Git的基本操作有些瞭解：

Git基本操作

##設定全域性使用者名稱和email，作為每次提交的記錄
git config --global user.name “name"
git config --global user.email “mail.com”

##新增一個倉庫
git remote add origin [email protected]….git
git push -u origin master

##當提示許可權不夠時，新增ssh公鑰
##在使用者的.ssh目錄下找id_rsa.pub等檔案，沒有的話去生成
ssh-keygen -t rsa -C "
 
[email protected]”

##設定pull的預設地址
git branch --set-upstream-to=origin/master
##設定push的預設地址
git remote add origin [email protected]….git

##配置別名
git config --global alias.xx ''

##臨時儲存工作區
git stash
git stash pop

## 回滾
git reset —hard 版本號

## 強行回滾遠端伺服器
git push -f

配置別名後會很方便，如果我有一個這樣的別名：

bogon:portfolio zhangao$ git config --global alias.ci
commit -m
 

在提交的時候用ci就行了。單個人使用Git，不協同工作的話，還是比較簡單的。

GitHub Pages

GitHub Pages上比較簡單，只需要建立一個和你使用者名稱相同的Repository就行了，比如：
這樣就建立了一個Repository，這樣就能通過username.github.io來訪問了。你也可以在設定裡面選擇生成一個預設的頁面。

下面主要還是說下在使用Jekyll過程中實際的問題

評論系統

我之前使用的是Disqus，後來感覺速度不怎麼樣，就換了多說，多說還是很好用的，適合國內環境。

部落格搬家

我之前沒有找到mac版的，就自己做了一個：

程式碼高亮

高亮的外掛有很多，Jekyll的Pygments就已經超過

100多種語言，使用起來也很簡單，在yml配置檔案中設定：

pygments: true

然後在需要高亮的程式碼那裡：

{% highlight ruby %}
def foo
  puts 'foo'
end
{% endhighlight %}

ruby替換為你所使用的語言的短名稱即可。如果設定了pygments之後編譯出錯的朋友需要再加一條配置：

excerpt_separator: ""

這是Jekyll的bug導致的，這樣雖然可以用pygments完成程式碼高亮，卻又不能用excerpt取到文章摘要了。最後我使用的是Sunlight，支援的語言比較多，完全可配置，可定製，能支援Objective-C的高亮：
但是和我發表在CSDN上的文章使用的程式碼高亮外掛不一樣，我又想要使用這個Sunlight，就只能自己寫個用正則查詢替換的工具轉了：

顯示分類

顯示分類：

<h4>分類列表</h4>
	<hr>
    {% for category in site.categories %}
    <li class="category_list_item"><a href="/showCategory.html?categoryName={{ category | first }}">{{ category | first }}</a> ({{ category | last | size }})
    </li>
    {% endfor %}

顯示所有的分類一般都沒什麼問題，主要在具體分類頁面進行處理。基於Jekyll的靜態特性，這個地方處理起來不太優雅，我參考了其他人的做法，最後選擇將文章列表儲存在JSON裡面：

var articleList = [{% for post in site.posts %}
		<span style="white-space:pre">	</span>{"title":"{{post.title}}",
			"url":"{{site.url}}{{post.url}}",
	<span style="white-space:pre">	</span>	"date":"{{ post.date | date:'%Y-%m-%d' }}",
			"excerpt": '{{ post.excerpt | strip_html | strip_newlines | truncate:170 }}'
			{% if post.categories != empty %}
			,
			"categories":[{% for category in post.categories %}"{{category}}"{% if forloop.last == false %},{% endif %}{% endfor %}]{% endif %}}
			{% if forloop.last == false %},{% endif %}{% endfor %}];

我在這裡判斷了文章有沒有分類，如果沒有分類的話，就不新增到這個JSON裡了，另外說下post.excerpt：

• excerpt是獲取文章的摘要資訊，這個資訊可以顯示在文章列表裡面
• strip_html是除去HTML標籤，因為摘要裡面不需要顯示圖片之類的，純文字即可
• strip_newlines是去掉換行符
• truncate這個就是字面意思了，摘要的長度

然後在JS裡面去取請求的引數，篩選出需要顯示的文章，做法比較常規就不說了。如果引數中有特殊符號（比如我就有這樣的分類名稱：cvs||svn）或是中文（比如“分享”），url就用encodeURI函式轉義一下：

<a href="javascript:void(window.location.href=encodeURI('/showCategory.html?categoryName={{ category | first }}'))">{{ category | first }}</a>

取的時候用decodeURI函式去取。

strip_newlines無法去除換行符，或者遇到其他換行符之類的問題

比如我有遇到strip_newlines無法去除換行符的問題，如果去不掉的話，某些內容放進JSON的時候，自然而然的就出現問題了，因為不能連線字串，但是又跨行了。strip_newlines只能去掉Unix的換行符，於是我就再一次使用了我之前寫的全文字替換工具Mac，做了一次替換：

實現分頁

Jekyll本身對分頁限制很多，只支援HTML檔案，不支援md，其次，對分類和標籤的分頁也不支援，這就很令人難受，只能將就用用了。在_config.yml檔案裡面新增：

paginate: 10
paginate_path: "page:num"

paginate表示開啟分頁並設定每頁的數量；paginate_path是指定分頁時Jekyll尋找HTML檔案的路徑，比如這裡設定為page:num，那麼Jekyll在分頁時，第一頁還是你的部落格的index.html，第二頁就是/page2/index.html，第三頁就是/page3/index.html。如果指定的path不存在會自動往上級目錄找，直到根目錄的index.html，或者這個引數沒有設定的話預設值就是page:num。在首頁裡面對文章進行分頁，用一個簡單的迴圈：

{% for post in paginator.posts %}
    <a href="{{ post.url }}">{{ post.title }}</a>
{% endfor %}

為了生成分頁的連結，在根目錄的index.html檔案裡面加上：

{% if paginator.total_pages > 1 %}
	{% if paginator.previous_page %}
		<a href="{{ paginator.previous_page_path }}">上一頁</a>
	{% endif %}
	
	{% if paginator.next_page %}
		<a href="{{ paginator.next_page_path }}">下一頁</a>
	{% endif %}
{% endif %}

如果想要顯示所有的頁碼：

{% for page in (1..paginator.total_pages) %}
	{% if page == 1 %}
		<a href="/index.html">{{ page }}</a>
	{% else %}
		<a href="{{ site.paginate_path | replace: ':num',page }}">{{ page }}</a>
	{% endif %}
{% endfor %}

因為第一頁是index.html，不是page1，所以要特殊處理一下。這樣一個簡單的分頁就完成了。附分頁物件paginator的所有屬性：

• page當前頁碼
• per_page每頁文章數量
• posts當前頁的文章列表
• total_posts總文章數
• total_pages總頁數
• previous_page上一頁頁碼 或 nil
• previous_page_path上一頁路徑 或 nil
• next_page下一頁頁碼 或 nil
• next_page_path下一頁路徑 或 nil

本來在顯示分類頁面也準備加上分頁的，後來一想，所有的文章資訊已經存在JSON裡了，做分頁也是一個假分頁，就作罷了。