jekyll : 使用github託管你的博客

使用github託管你的博客  

效果：

http://wuya1234.github.io/blog/2013/11/09/start-github-blog/

樣式神馬的還沒整

電腦系統

我使用的是mac os 10.8.5,因此如下全部描述都僅僅針對mac os系統

爲何要使用github託管博客

目前，可做爲博客託管的環境且比較知名的免費服務有：

• 新浪的sae ，支持python，php
• 百度的bae，支持python，php，nodejs（處於內測階段，我申請了好幾回也不給我，擦）

另外還有一些知名的碼農論壇，cnblogs，csdn等能夠放心大膽的託管你的博客。爲何不用這些論壇寫博客，卻要用github來託管博客？確實我也以爲挺難以想象的。

github做爲一個被碼農關注度極高的網站，在你看不見的地方存放了大量優秀且開源的代碼。你以爲好，對你有幫助你能夠fork，若是你有什麼意見，還能夠contribute。好不誇張的說：若是你要成爲一個牛逼的code，用github吧。因此爲了習慣這種方式git的方式，我決定之後在github上放個博客，分享一些本身的學習心得。這就是個人目的，單不是惟一目的。

扁平化設計愈來愈流行了，連蘋果都改了，改爲了醜不拉幾的ios7了。但不能否認的是如今的趨勢是朝向簡潔化，簡潔纔是王道。利用jekyll你能夠輕鬆實現一個簡潔的博客模板，而後push到github上。另外，jekyll自帶了一些模塊，好比：代碼高亮，提供了一個可評論模塊。這些纔是我用jekyll，push到github託管博客的主要緣由。

jekyll是個神馬？？

若是你用過nodejs的express，你知道   express -t ejs blog 

若是你用過yii，你知道：yiic webapp blog

若是你用過python的django，你知道：django-admin.py startproject djproject

好吧，jekyll就是相似上面的東西，它能夠快速建立一個github博客。

來吧，按步驟來吧，建立一個屬於你的github博客

1.安裝jekyll 安裝命令很簡單： $ gem install jekyll 不過你極可能會遇到如下錯誤：

ERROR: Error installing jekyll:
ERROR: Failed to build gem native extension....Results logged to /Library/Ruby/Gems/1.8/gems/fast-stemmer-1.0.2/ext/gem_make.out

緣由：Ruby 版本 1.8.7，過低，推薦升級到 1.9.3 。 建議使用 RVM，然而執行安裝命令

2.安裝rvm 注意在安裝過程當中輸出的信息，會提示如何使用，如我安裝過程是:

To start using RVM you need to run `source /Users/irou/.rvm/scripts/rvm`

固然也能夠在打開終端時自動加載，在~/.bash_profile最後添加

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"

驗證下是否安裝成功：

$ rvm --version

rvm 1.23.14 (stable) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]

3.安裝ruby 在RVM中安裝Ruby 1.9.3

rvm install 1.9.3

安裝完後，測試下：

gem --version

若是你看到：

2.1.10

恭喜，你已經安裝成功

啓用： ruby 1.9.3

rvm use 1.9.3

4.jekyll 經過ruby gems安裝：

gem install jekyll

gem install jekyll-tagging

5.用jekyll建立博客

兩步建立你的博客：

• Create a New Repository

  Go to your https://github.com and create a new repository named USERNAME.github.com（注意，這裏你的repo的名稱是：yourusename.github.com）

1.create a new respository

    go to your https://github.com and create a new respository named USERNAME.github.com

    注意：這裏的USERNAME是佔位，是你的github帳戶名，好比個人：wuya1234.github.com

2.git clone jekyll bootstrap到本地，文件名好比就叫：wuya1234.github.com

  git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com

  cd USERNAME.github.com

  修改repo地址爲你的repo，而後提交便可

  git remote set-url origin https://github.com/wuya1234/wuya1234.github.com.git
  git push origin master

  刷新你的repo就成這樣了：

   

 前面已經提到過了，repo的名字是   你的用戶名.github.com  .而且經過jekyll方式提交後，只須要提交到master分支，github就能自動給你轉成靜態的page方式（另外還有一種是建立文件上傳到gh-pages分支，這種比較簡單，本身google吧）。

username.github.com 跟其餘方式有什麼不一樣呢？請看：

點擊repo的設置後

只要兩步，對兩步你就能夠搞一個具備語法高亮和帶評論的github博客。

注意：我這個版本默認沒有吧bootstrap的語法高亮css引入，非常奇怪。手動在模板中引入相關css，以及在_config.yml中簡單配置下便可：

markdown: redcarpet
redcarpet:
    extensions: ["fenced_code_blocks", "autolink", "tables", "strikethrough"]

之後的的代碼高亮都可以採用以下格式：

``` ruby
require 'rubygems'

def foo
puts 'foo'
end

#comment
```

6.本地預覽

jekyll還提供一個本地預覽模式。經過在終端：

jekyll server 

按照提示,在瀏覽器中輸入：localhost:4000

就能本地預覽啦，注意若是你的模板中有錯誤，本地預覽是通不過的，經過--trace能看到哪報錯進行調試

調試ok就能夠push到github了

大功告成！！但願對你有用

 

參考：

1.http://jekyllbootstrap.com/usage/jekyll-quick-start.html
2.http://equation85.github.io/blog/install-jekyll-on-mac/
3.http://www.chenzixin.com/program/2013/03/06/mac-jekyll-install-log/