1、認識Jekyll

Jekyll is a simple, blog aware, static site generator.。 It takes a template directory (representing the raw form of a website), runs it through Markdown or Textile and Liquid converters, and produces a static website suitable for any web server.

????上面是摘自github上Jekyll的說明.簡單的說，Jekyll 是一個簡潔的、特別針對博客平臺的靜態(tài)網(wǎng)站生成器。它使用一個模板目錄作為網(wǎng)站布局的基礎框架，并在其上運行 Textile 、 Markdown 或 Liquid 標記語言的轉(zhuǎn)換器，最終生成一個完整的靜態(tài)Web站點。jekyll+markdown+Liquid成為很簡單，很舒服的寫作方式。

一個典型的Jekyll站點通常具有如下結(jié)構(gòu)：

config.yml

??保存Jekyll配置的文件。雖然絕大部分選項可以通過命令行參數(shù)指定，但將它們寫入配置文件可以使你在每次執(zhí)行時不必記住它們。 比如里面寫:

	description:      "freestyle21\'s Blog"

那么我們在源碼中就可以通過下面這種方式去訪問了：

	site.description

includes

該目錄存放可以與_layouts和_posts混合、匹配并重用的文件。 用的不多，沒有深入接觸。。。

layouts

??該目錄存放用來插入帖子的網(wǎng)頁布局模板。頁面布局基于類似博客平臺的“一個帖子接一個帖子”的原則，通過YAML前置數(shù)據(jù)定義。Liquid標簽用于在頁面上插入帖子的文本內(nèi)容。這個用的特多，可以大大減少代碼量。

posts

??該目錄下存放的可以說成是你的“動態(tài)內(nèi)容”。這些文件的格式很重要，它們的命名模式必須遵循 year-month-date-title.markdown。每一個帖子的固定鏈接URL可以作彈性的調(diào)整，但帖子的發(fā)布日期和轉(zhuǎn)換所使用的標記語言會根據(jù)且僅根據(jù)文件名中的相應部分來識別。

site

??這里是Jekyll用以存放最終代碼生成站點的根路徑位置。也許把它加到你的.gitignore列表中會是個不錯的主意。這個文件夾是Jekyll自動生成的，所以我們一般不用管。

其他文件/目錄

??除了以上提到的文件之外，每一個其他的、不以下劃線_開頭的目錄和文件都會被照原樣傳送到站點路徑下。例如，你可以在網(wǎng)站根目錄下面添加一個 css ,js,img目錄，一個 favicon.ico ，等等等等。

2、windows搭建Jekyll本地測試環(huán)境

??你可以修改了代碼，然后上傳到github上面去，然后在刷新刷新看剛才改動的效果。不過如果能夠堅持調(diào)試下來的不是大牛就是高富帥=-=。。于是在本地測試就師出有名了，改好了再上傳到github上面，事半功倍。

??看了好多別人寫的博客，不過都沒有一次成功的，為了方便同仁和自己，把自己的過程記錄下來吧。。中間遇到好多問題，反正各種google、stackoverflow。做好過后，那些問題也都忘了怎么解決的了，所以事后寫博客質(zhì)量不是很好，=-=||..好了，少扯蛋，多做事：

安裝Jekyll

??Jekyll使用Ruby編寫的，所以要先配置Ruby環(huán)境，通過Ruby安裝Jekyll。

??下載RubyInstaller，(我下載的是rubyinstaller-1.9.3-p194.exe

??下載 DevKit(下載的是DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe

RubyInstaller安裝開始的時候，有三個多選按鈕，都選上~path神馬的都會自動加上，不用擔心。

解壓DevKit，然后打開cmd，進入剛才的DevKit解壓目錄，輸入以下命令：

	Ruby dk.rb init
	Ruby dk.rn install

??DevKit是windows平臺下編譯和使用本地C/C++擴展包的工具。它就是用來模擬Linux平臺下的make,gcc,sh來進行編譯。但是這個方法目前僅支持通過RubyInstaller安裝的Ruby。

下面就可以安裝Jekyll了：

	gem install Jekyll

等待。。。這個時候不要關(guān)閉Git Bash。

最后，我們可以檢查一下安裝Jekyll成功沒有：

	Jekyll --version

如果輸出下面的結(jié)果就說明我們成功了。。

	Jekyll 0.12.0

接下來讀者朋友可以把我的博客clone到本地，一般都clone到在C:\Users\Administrator這個目錄下面：

	git clone git://github.com./freestyle21/freestyle21.github.com.git

然后進入剛才的目錄里面：

	cd freestyle21.github.com

執(zhí)行：

	Jekyll --server --auto

如下如：

??最后就是檢驗成果的時候了，在瀏覽器中輸入：localhost:4000,就可以看到你的頁面在本地跑起來了。。 這樣以后調(diào)試就方便多了，在代碼中修改后，只要ctrl+s保存一下，jekyll就會自動在瀏覽器里面更新了。。

一般都在github里面寫代碼的，很久沒有在本地調(diào)試了，這幾天有點想法，想把博客改變一下樣子。但是這次居然jekyll居然不聽話了，各種報錯，然后就是不斷的找錯誤。。

現(xiàn)在記錄一下遇到的錯誤，以后不要在這里耽誤時間了。

問題：

	Liquid error: incompatible character encodings: UTF-8 and IBM437”

編碼問題，直接在path里面添加：LC_ALL=en_US.UTF-8 和 LANG=en_US.UTF-8然后重啟或者注銷。

還是不行的話就將 convertible.rb 的第29行改為：

	self.content = File.read(File.join(base, name), :encoding => "utf-8")

問題：

Liquid Exception: No such file or directory - python c:/Ruby193/lib/ruby/gems/1.9.1/gems/pygments.rb-0.3.7/lib/pygments/mentos.py in 2013-01-06-octopress.markdown

首先可以嘗試一下更新Pygments，

把python里面的script目錄加載path里面，然后就可以直接通過easy_install Pygments來安裝了。

其次Pygments是通過python來工作的，所以還要安裝python。需要注意的是一定要把python的路徑加到path下面。

總結(jié)

以上是生活随笔為你收集整理的邂逅Jekyll的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。