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/