天天看點

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 <[email protected]>, Michal Papis <[email protected]> [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就成這樣了:

jekyll : 使用github托管你的部落格

 前面已經提到過了,repo的名字是   你的使用者名.github.com  .并且通過jekyll方式送出後,隻需要送出到master分支,github就能自動給你轉成靜态的page方式(另外還有一種是建立檔案上傳到gh-pages分支,這種比較簡單,自己google吧)。

username.github.com 跟其他方式有什麼不同呢?請看:

點選repo的設定後

jekyll : 使用github托管你的部落格

隻要兩步,對兩步你就可以搞一個具有文法高亮和帶評論的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/