Jekyll Windows 环境配置
2017-01-04 tech jekyll dev github mac windows 7 mins 2603 字
昨天配好了Win下的开发环境。记录下一些问题。
安装 Ruby
http://rubyinstaller.org/downloads/
就目前来说，下文的 DevKit 因为仅支持ruby 2.3，所以不要安装高于2.3的版本。
完成后进入“CMD”输入“ruby -v”如显示版本则代表安装成功。
如果Ruby环境变量没有添加，后把安装目录下的 Bin 目录添加到系统Path环境变量即可。
安装 DevKit
DevKit 是一个在 Windows 上帮助简化安装及使用 Ruby C/C++ 扩展如 RDiscount 和 RedCloth 的工具箱。
下载与 Ruby 版本相对应的 DevKit 安装包：http://rubyinstaller.org/downloads/
把 DevKit 解压到某个目录，运行：
ruby dk.rb init
ruby dk.rb install
安装 Jekyll
首先确保 gem 已经正确安装
//命令输入
gem -v
//输出
2.2.2
gem install jekyll
安装 Python
使用2.7的版本，安装完成后把 Python 安装目录和 Scripts 目录添加到系统Path环境变量中。
安装 Rouge
一般来说静态生成中经常会使用高亮代码等功能，而高亮代码的生成一般需要插件帮助完成才行。
在常规中一般都是使用：“Pygments”；因为”Pygments“是python下面的插件，所以需要先安装Python之后才能安装该插件，我嫌麻烦在实际使用中采用的是”Rouge“高亮插件。 之所以使用：”Rouge”，是因为在 Jekyll 官网中也曾提到以后将会使用该插件。
gem install jekyll-paginate
gem install rouge
问题定位
jekyll-paginate
Q：It looks like you don’t have jekyll-paginate or one of its dependencies installed
A：在 Gemfile 文件中添加如下内容：
gem 'jekyll-paginate', group: :jekyll_plugins
gems renamed to plugins
Q: Configuration file: D:/GitHub/kelvinblood.github.com/_config.yml Deprecation: The ‘gems’ configuration option has been renamed to ‘plugins’. Please update your config file accordingly.
A：在 _config.yml 文件中修改如下内容：
# gems: [jekyll-paginate]
plugins: [jekyll-paginate]
gem install tzinfo
Q: Dependency Error: Yikes! It looks like you don’t have tzinfo or one of its dependencies installed.
gem install tzinfo
gem install tzinfo-data
Gemfile
Q：在 Mac 下运行得好好的，Windows 下不能运行，报错。
C:/Ruby23-x64/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require': cannot load such file -- bundler (LoadError)
from C:/my_pp/Ruby23-x64/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require'
from C:/my_pp/Ruby23-x64/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
from C:/my_pp/Ruby23-x64/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/exe/jekyll:9:in `<top (required)>'
from C:/my_pp/Ruby23-x64/bin/jekyll:23:in `load'
from C:/my_pp/Ruby23-x64/bin/jekyll:23:in `<main>'
A：Windows 下删除 Gemfile 文件即可。
jekyll-paginate gem
Deprecation: You appear to have pagination turned on, but you haven’t included the jekyll-paginate gem. Ensure you have plugins: [jekyll-paginate] in your configuration file.
gem install jekyll-paginate
常用命令
安装完成后，使用
jekyll serve --incremental
运行项目，只改变修改的文章内容，加快运行速度。毕竟平时也就修改文章内容，不会改变系统配置。
参考资料：
