1. Jekyll介绍


Jekyll生成的站点,可以直接发布到github上面,这样我们就有了一个免费的,无限流量的,有人维护的属于我们的自己的web网站。Jekyll是基于Rub y的程序,可以通过gem来下载安装。


2. 安装Ruby


安装Ruby到 D:\Ruby21-x64 ,再安装RubyGems

$ ruby --version
ruby 2.1.5p273 (2014-11-13 revision 48405) [x64-mingw32]

$ gem update --system
ERROR:  While executing gem ... (Gem::RemoteFetcher::FetchError)
SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (


$ curl -o cacert.pem
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  245k  100  245k    0     0  26428      0  0:00:09  0:00:09 --:--:-- 23662

# 移动到Ruby安装目录
$ mv cacert.pem /d/Ruby21-x64/bin/

设置环境变量 SSL_CERT_FILE=D:\Ruby21-x64\bin\cacert.pem,设置步骤如下图所示:

# 再执行时,一切OK
$ gem update --system
Updating rubygems-update
Fetching: rubygems-update-2.4.5.gem (100%)
Successfully installed rubygems-update-2.4.5
Parsing documentation for rubygems-update-2.4.5
Installing ri documentation for rubygems-update-2.4.5
Installing darkfish documentation for rubygems-update-2.4.5
Done installing documentation for rubygems-update after 2 seconds
Installing RubyGems 2.4.5
RubyGems 2.4.5 installed
Parsing documentation for rubygems-2.4.5
Installing ri documentation for rubygems-2.4.5


RubyGems installed the following executables:

Ruby Interactive (ri) documentation was installed. ri is kind of like man
pages for ruby libraries. You may access it like this:
  ri Classname
  ri Classname.class_method
  ri Classname#instance_method
If you do not wish to install this documentation in the future, use the
--no-document flag, or set it as the default in your ~/.gemrc file. See
'gem help env' for details.

RubyGems system software updated

安装DevKit到目录: d:\Ruby21-x64\DevKit-mingw64 可以参考安装指引

注意事项 Ruby和DevKit的平台必须匹配,要么都是64位平台,或者要么都是32位平台。

在windows资源管理器中双击执行 D:\Ruby21-x64\DevKit-mingw64\msys.bat,进入命令行界面,然后输入下列命令:

$ cd /d/Ruby21-x64/DevKit-mingw64/ /d/Ruby21-x64/DevKit-mingw64
$ ruby dk.rb init
[INFO] found RubyInstaller v2.1.5 at d:/Ruby21-x64

Initialization complete! Please review and modify the auto-generated
'config.yml' file to ensure it contains the root directories to all
of the installed Rubies you want enhanced by the DevKit. /d/Ruby21-x64/DevKit-mingw64
$ vim config.yml
/d/Program Files (x86)/Git/bin/vim: line 3: /share/vim/vim73/vim: No such file o
r directory
/d/Program Files (x86)/Git/bin/vim: line 3: exec: /share/vim/vim73/vim: cannot e
xecute: No such file or directory /d/Ruby21-x64/DevKit-mingw64
$ ruby dk.rb review
Based upon the settings in the 'config.yml' file generated
from running 'ruby dk.rb init' and any of your customizations,
DevKit functionality will be injected into the following Rubies
when you run 'ruby dk.rb install'.

d:/Ruby21-x64 /d/Ruby21-x64/DevKit-mingw64
$ ruby dk.rb install
[INFO] Installing 'd:/Ruby21-x64/lib/ruby/site_ruby/2.1.0/rubygems/defaults/oper
[INFO] Installing 'd:/Ruby21-x64/lib/ruby/site_ruby/devkit.rb' /d/Ruby21-x64/DevKit-mingw64
$ install json --platform=ruby
install: unrecognized option `--platform=ruby'
Try `install --help' for more information. /d/Ruby21-x64/DevKit-mingw64
$ gem install json --platform=ruby
Fetching: json-1.8.1.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Successfully installed json-1.8.1
Parsing documentation for json-1.8.1
Installing ri documentation for json-1.8.1
Done installing documentation for json after 0 seconds
1 gem installed /d/Ruby21-x64/DevKit-mingw64
$ ruby -rubygems -e "require 'json'; puts JSON.load('[42]').inspect"
[42] /d/Ruby21-x64/DevKit-mingw64

3. 安装Jekyll


$ gem install jekyll
Fetching: fast-stemmer-1.0.2.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Successfully installed fast-stemmer-1.0.2
Fetching: classifier-reborn-2.0.3.gem (100%)
Successfully installed classifier-reborn-2.0.3
Fetching: ffi-1.9.6-x64-mingw32.gem (100%)
Successfully installed ffi-1.9.6-x64-mingw32
Fetching: rb-inotify-0.9.5.gem (100%)
Successfully installed rb-inotify-0.9.5
Fetching: rb-fsevent-0.9.4.gem (100%)
Successfully installed rb-fsevent-0.9.4
Fetching: hitimes-1.2.2.gem (100%)
Building native extensions.  This could take a while...
Successfully installed hitimes-1.2.2
Fetching: timers-4.0.1.gem (100%)
Successfully installed timers-4.0.1
Fetching: celluloid-0.16.0.gem (100%)
Successfully installed celluloid-0.16.0
Fetching: listen-2.8.4.gem (100%)
Successfully installed listen-2.8.4
Fetching: jekyll-watch-1.2.0.gem (100%)
Successfully installed jekyll-watch-1.2.0
Fetching: sass-3.4.9.gem (100%)Fetching: sass-3.4.9.gem
Successfully installed sass-3.4.9
Fetching: jekyll-sass-converter-1.3.0.gem (100%)
Successfully installed jekyll-sass-converter-1.3.0
Fetching: coffee-script-source-1.8.0.gem (100%)
Successfully installed coffee-script-source-1.8.0
Fetching: execjs-2.2.2.gem (100%)
Successfully installed execjs-2.2.2
Fetching: coffee-script-2.3.0.gem (100%)
Successfully installed coffee-script-2.3.0
Fetching: jekyll-coffeescript-1.0.1.gem (100%)
Successfully installed jekyll-coffeescript-1.0.1
Fetching: jekyll-gist-1.1.0.gem (100%)
Successfully installed jekyll-gist-1.1.0
Fetching: jekyll-paginate-1.1.0.gem (100%)
Successfully installed jekyll-paginate-1.1.0
Fetching: blankslate- (100%)
Successfully installed blankslate-
Fetching: parslet-1.5.0.gem (100%)
Successfully installed parslet-1.5.0
Fetching: toml-0.1.2.gem (100%)
Successfully installed toml-0.1.2
Fetching: redcarpet-3.2.2.gem (100%)
Building native extensions.  This could take a while...
Successfully installed redcarpet-3.2.2
Fetching: yajl-ruby-1.1.0.gem (100%)
Building native extensions.  This could take a while...
Successfully installed yajl-ruby-1.1.0
Fetching: posix-spawn-0.3.9.gem (100%)
Building native extensions.  This could take a while...
Successfully installed posix-spawn-0.3.9
Fetching: pygments.rb-0.6.0.gem (100%)
Successfully installed pygments.rb-0.6.0
Fetching: colorator-0.1.gem (100%)
Successfully installed colorator-0.1
Fetching: safe_yaml-1.0.4.gem (100%)
Successfully installed safe_yaml-1.0.4
Fetching: mercenary-0.3.5.gem (100%)
Successfully installed mercenary-0.3.5
Fetching: kramdown-1.5.0.gem (100%)
Successfully installed kramdown-1.5.0
Fetching: liquid-2.6.1.gem (100%)
Successfully installed liquid-2.6.1
Fetching: jekyll-2.5.3.gem (100%)
Successfully installed jekyll-2.5.3
Parsing documentation for fast-stemmer-1.0.2
Installing ri documentation for fast-stemmer-1.0.2
Parsing documentation for classifier-reborn-2.0.3
Installing ri documentation for classifier-reborn-2.0.3
Parsing documentation for ffi-1.9.6-x64-mingw32
Installing ri documentation for ffi-1.9.6-x64-mingw32
Parsing documentation for rb-inotify-0.9.5
Installing ri documentation for rb-inotify-0.9.5
Parsing documentation for rb-fsevent-0.9.4
Installing ri documentation for rb-fsevent-0.9.4
Parsing documentation for hitimes-1.2.2
Installing ri documentation for hitimes-1.2.2
Parsing documentation for timers-4.0.1
Installing ri documentation for timers-4.0.1
Parsing documentation for celluloid-0.16.0
Installing ri documentation for celluloid-0.16.0
Parsing documentation for listen-2.8.4
Installing ri documentation for listen-2.8.4
Parsing documentation for jekyll-watch-1.2.0
Installing ri documentation for jekyll-watch-1.2.0
Parsing documentation for sass-3.4.9
Installing ri documentation for sass-3.4.9
Parsing documentation for jekyll-sass-converter-1.3.0
Installing ri documentation for jekyll-sass-converter-1.3.0
Parsing documentation for coffee-script-source-1.8.0
Installing ri documentation for coffee-script-source-1.8.0
Parsing documentation for execjs-2.2.2
Installing ri documentation for execjs-2.2.2
Parsing documentation for coffee-script-2.3.0
Installing ri documentation for coffee-script-2.3.0
Parsing documentation for jekyll-coffeescript-1.0.1
Installing ri documentation for jekyll-coffeescript-1.0.1
Parsing documentation for jekyll-gist-1.1.0
Installing ri documentation for jekyll-gist-1.1.0
Parsing documentation for jekyll-paginate-1.1.0
Installing ri documentation for jekyll-paginate-1.1.0
Parsing documentation for blankslate-
Installing ri documentation for blankslate-
Parsing documentation for parslet-1.5.0
Installing ri documentation for parslet-1.5.0
Parsing documentation for toml-0.1.2
Installing ri documentation for toml-0.1.2
Parsing documentation for redcarpet-3.2.2
Installing ri documentation for redcarpet-3.2.2
Parsing documentation for yajl-ruby-1.1.0
Installing ri documentation for yajl-ruby-1.1.0
Parsing documentation for posix-spawn-0.3.9
Installing ri documentation for posix-spawn-0.3.9
Parsing documentation for pygments.rb-0.6.0
Installing ri documentation for pygments.rb-0.6.0
Parsing documentation for colorator-0.1
Installing ri documentation for colorator-0.1
Parsing documentation for safe_yaml-1.0.4
Installing ri documentation for safe_yaml-1.0.4
Parsing documentation for mercenary-0.3.5
Installing ri documentation for mercenary-0.3.5
Parsing documentation for kramdown-1.5.0
Installing ri documentation for kramdown-1.5.0
Parsing documentation for liquid-2.6.1
Installing ri documentation for liquid-2.6.1
Parsing documentation for jekyll-2.5.3
Installing ri documentation for jekyll-2.5.3
Done installing documentation for fast-stemmer, classifier-reborn, ffi, rb-inoti
fy, rb-fsevent, hitimes, timers, celluloid, listen, jekyll-watch, sass, jekyll-s
ass-converter, coffee-script-source, execjs, coffee-script, jekyll-coffeescript,
 jekyll-gist, jekyll-paginate, blankslate, parslet, toml, redcarpet, yajl-ruby,
posix-spawn, pygments.rb, colorator, safe_yaml, mercenary, kramdown, liquid, jek
yll after 13 seconds
31 gems installed


查看jekyll命令行帮助 /d/Ruby21-x64/DevKit-mingw64
$ jekyll
jekyll 2.5.3 -- Jekyll is a blog-aware, static site generator in Ruby


  jekyll <subcommand> [options]

        -s, --source [DIR]  Source directory (defaults to ./)
        -d, --destination [DIR]  Destination directory (defaults to ./_site)
            --safe         Safe mode (defaults to false)
        -p, --plugins PLUGINS_DIR1[,PLUGINS_DIR2[,...]]  Plugins directory (defa
ults to ./_plugins)
            --layouts DIR  Layouts directory (defaults to ./_layouts)
        -h, --help         Show this message
        -v, --version      Print the name and version
        -t, --trace        Show the full backtrace when an error occurs

  build, b              Build your site
  docs                  Launch local server with docs for Jekyll v2.5.3
  doctor, hyde          Search site and print specific deprecation warnings
  help                  Show the help message, optionally for a given subcommand
  new                   Creates a new Jekyll site scaffold in PATH
  serve, server, s      Serve your site locally

额外的工作,如果上面gem install jekyll执行太慢,甚至卡住,可以通过设置gem源来解决


$ gem sources --remove
$ gem sources -a
$ gem sources -l