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/