Jekyll可以独立的在本地运行,这样方便构建GitHub个人博客,官方介绍安装完成Jekyll只需要几分钟时间,但实际操作的过程当中发现存在很多问题,记录下来以备参考。
安装Jekyll最简单的方式是通过RubyGems安装,但这需要以下的依赖包:Ruby,RubyGems和node.js。以下介绍ubuntu系统安装。
$ sudo apt-get install ruby ruby1.9.1 ruby1.9.1-dev node.js
终端运行以下命令
$ gem install Jekyll
如果遇到问题可能时因为没有安装必要的依赖,请认真检查错误提示,或查看troubltshooting
如果希望文章通过_highlight_标签实现代码高亮,需要安装pygments.
$ sudo apt-get install python-pygments
如果按照上述操作,理论上Jekyll已经正确安装,可以运行jekyll -v
查看版本号,切换到github目录运行jekyll serve
就可以在本地查看博客
但是,万事总有但是,在本机运行jekyll serve
时出现错误。
Celluloid 0.17.0 is running in BACKPORTED mode. [ http://git.io/vJf3J2 ]
jekyll 2.5.3 | Error: wrong number of arguments (2 for 1) ]
百思不得其解,经google后解决问题。原链接是Error while trying to run “Jekyll Serve”
解决方案如下:
jekyll serve --trace
查看问题所在,找到可能是版本问题。gem list --local
查看本地已安装文件以及其版本号。gem uninstall elluloid
,然后选择对应的0.17.0版本将其删除。