github + jekyll 安装遇到问题

2012-08-15 posted in [遇到问题]

决定把个人博客和技术分开了，放在一块儿乱糟糟的。在这里记录遇到的问题以及解决方案，先从搭建 github + jekyll 环境开始吧。

本地测试需要装ruby，然后装jekyll：

$ gem install jekyll

安装Rdiscount，这个是用来解析Markdown标记的解析包。如果你使用Textile的话，就是安装Kramdown。

$ gem install rdiscount

安装好后启动服务器

$ jekyll --server --auto

windows用户伤不起啊伤不起，直接报错

Liquid error: invalid byte sequence in GBK

原因是控制台不支持UTF-8，用英文就没问题……

添加自定义环境变量：

LC_ALL=en_US.UTF-8

LANG=en_US.UTF-8

接下来这个好像是jekyll的bug……

lib/ruby/gems/1.9.1/gems/jekyll-0.11.2/lib/jekyll/convertible.rb:29:in ‘read_yaml’: invalid byte sequence in GBK (ArgumentError)

将 convertible.rb 中 self.content = File.read(File.join(base, name)) 改为：

self.content = File.read(File.join(base, name), :encoding => “utf-8”)

如果没问题了的话浏览器输入localhost:4000应该已经可以访问了。

github部分就不多说了，这里用的是SimpleGray这个主题，直接clone下来，修改远程仓库：

$ git remote rm origin
$ git remote add origin git@github.com:dylanvivi/dylanvivi.github.com.git
$ git remote -v # 查看

编写post，名称格式yyyy-MM-dd-title.md。 Markdown语法。

剩下的是git提交神马神马的了，问题不大，反正经常用忘不了~就先这样吧~

UPDATE

jekyll有时候无法编译md文件, 检查一下文件编码。比如我用notepad++的时候默认编码是ANSII，要改成UTF-8才能正常编译。