用Jekyll寫部落格

用Jekyll寫部落格

快速通過GitHub Pages安裝部落格並發布。然後在本地運行你的部落格並建立你的第一個Post和頁面。安裝Jekyll-Bootsrap

安裝Jekyll-Bootsrap，如果你還沒安裝好。Jekyll-Bootsrap是一個部落格架構，擁有內建的主題、分析、評論以及Post/Page建立功能。

$ gem install jekyll

如果安裝出了問題，請看看原始的Jekyll安裝文檔。你也可以通過GitHub Issues來建立一個支援issue。

一旦這個gem安裝好，你就可以轉到你的Jekyll-Bootsrap安裝目錄。如果你一直跟著首頁的說明來做，此目錄將是：USERNAME.github.com。進入此目錄後，你就可以運行有伺服器支援的jekyll：

cd USENAME.github.comjekyll --server# 記得將USENAME改為你自己的GitHub使用者名稱

建立一篇博文（Post）

你可以輕易地通過一個rake任務來建立博文：

$ rake post title="Hello World"

此rake任務會自動建立一個有著正確的格式化好檔案名稱的檔案和一個YAML Front Matter。確保指定一個你自己的標題。預設日期是當前日期。

# 根據我的測試，寫上日期才不會報錯$ rake post title="Hi, Jekyll" date="2012-03-04"

此rake任務不會覆蓋任何已存在的博文，除非你讓它那樣做。

建立一個頁面（Page）

建立頁面也是通過rake任務，同樣很容易：

$ rake page name="about.md"

建立一個嵌套頁面：

$ rake page name="pages/about.md"

建立一個有著好看路徑的頁面：

$ rake page name="pages/about"# 這會建立一個檔案： ./pages/about/index.html

此rake任務會自動建立一個有著正確的格式化好檔案名稱的檔案和一個YAML Front Matter，同時包含Jekyll Bootstrap的設定檔案。

Jekyll-Bootstrap頁面範例

Jekyll-Bootstrap同樣提供了許多預配置好頁面範例提供使用者參考。你可以學習它們的代碼然後按照你需要的樣子定製。

• 頁面
• 分類
• 歸檔
• 標籤

發布

在你添加了一些博文或改了主題等其它檔案後，簡單地提交它們到你的git倉庫並push到GitHub上。

$ git add .$ git commit -m "添加了新內容"$ git push origin master

定製

Jekyll-Bootstrap是一個基本的部落格平台。有許多方式可以深入定製它。下列就是Jekyll-Bootstrap更深入的定製技術：

主題

Jekyll-Bootstrap支援模組化主題。多個主題可以同時存在，且能根據需要關閉或開啟。編輯、配置以及建立主題的方法在文檔的主題一節。

部落格配置

Jekyll和Jekyll-Bootstrap有一個簡單但強大的Jekyll配置系統。你可以：

* 為博文指定一個自訂的連結格式

• 為部落格指定一個評論系統，如disqus、intensedebate、livefyre或者自訂
• 為部落格指定一個分析引擎，如google、getclicky或者自訂

編程介面

API頁面文檔裡主要的資料結構和代碼都可以用於Jekyll和Jekyll-Bootstrap。查看這些頁面以知曉如何使用以及何處使用這些資料的代碼。

Jekyll介紹

強烈推薦
如果你計劃定製你的部落格，我強烈推薦你閱讀Jekyll介紹。此介紹說明了如何以及為何Jekyll按照它工作的方式工作。This will
provide you with the proper context, knowledge-base, and fundamentals necessary to understand and be efficient in working with Jekyll and Jekyll-Bootstrap.