Jekyll的安装大致上可以尊循官网的说明,不过中间的某一些步骤在我的环境下有问题. 在此记录一下我的安装步骤. 官网的安装说明在这里: Jekyll

安装Jekyll

执行以下命令

gem install jekyll bundler

如果没有在本地配置过Ruby开发环境,很可能看到以下错误信息:

WARNING:  You don't have /home/zhengyang/.gem/ruby/2.5.0/bin in your PATH,
	  gem executables will not run.
Successfully installed jekyll-3.8.5

以及以下错误信息:

ERROR:  While executing gem ... (Gem::DocumentError)
    RDoc is not installed: cannot load such file -- rdoc/rdoc

首先把第一个错误里提到的路径加入到PATH里,一般通过修改.bashrc完成。完事儿别忘了source ~/.bashrc。

接下来执行gem install rdoc修复第二个问题。之后重新运行之前的命令,这次应该安装成功并且没有报错信息了:

gem install jekyll bundler

使用Jekyll创建一个新的website

执行以下命令:

jekyll new myblog

同样,根据你的运行环境,你可能会看到以下错误信息:

Your user account isn't allowed to install to the system RubyGems.
  You can cancel this installation and run:

      bundle install --path vendor/bundle

  to install the gems into ./vendor/bundle/, or you can enter your password
  and install the bundled gems to RubyGems using sudo.

这是因为最后一步是需要把这个新建site依赖的library安装到本地,默认安装位置需要sudo权限才能修改。不过没关系,暂时忽略这个错误,website的基本目录结构已经生成完毕了。接下来只要从website目录里执行以下命令,把依赖安装到website目录下即可:

cd myblog
bundle install --path ./vendor/bundle/

最后,启动web server:

bundle exec jekyll serve

默认情况下web server会监听4000端口,从浏览器里访问 localhost:4000 就能看到新建的网站,大功告成!