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/

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM