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/