/ 闲敲棋子 / github + jekyll 安装遇到问题

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才能正常编译。