实际上是一个 Portable Jekyll

拥有几个好处：1. 不必进行繁琐的 Ruby 和 DevKit 的安装

  1. 不需要管理员权限，公司电脑也可以搭建

  2. 适用于 Jekyll 3.X, 经测试 3.1.2 在安装额外的几个 gem 后也可以顺利使用

Require Modules

  1. ruby (从列表里找到最新的版本的 7z 下载解压)

  2. DevKit 4.7.2

环境部署

  1. 将自己的 Github Page 独立放到一个文件夹中

  2. 解压 Ruby 和 DevKit，保证解压出来的文件夹名称是「Ruby」和「DevKit」(Ruby 解压出的文件夹名称可能不是 Ruby)

  3. 建立一个setpath.cmd

	@ECHO OFF
	ECHO Adding Jekyll to PATH……
	SET RUBY_PATH=%~dp0ruby
	SET DEVKIT_PATH=%~dp0devkit
	SET PATH=%RUBY_PATH%\bin;%DEVKIT_PATH%\bin;%DEVKIT_PATH%\mingw\bin;%PATH%
  1. 最终的文件层次
	Main Folder
	- devkit
	- Github Page ProJ
	- ruby
	- setpath.cmd

建议不要把 ruby 放到 Github Page Folder 中，否则会在 build 的时候会报以下错误

	ERROR: YOUR SITE COULD NOT BE BUILT:
	------------------------------------
	Invalid date '<%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z')
	%>': Document 'ruby/lib/ruby/gems/2.1.0/gems/jekyll-3.1.2/lib/site_template/_pos
	ts/0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date in the
	YAML front matter.

开始使用 Jekyll

  1. 首先跑到 cmd 所在的路径，直接执行 setpath.cmd
  2. 执行 gem install jekyll
  3. 进入 Github Page 文件夹执行 jekyll s

再变得方便一些

建议先完成上述步骤并且将必要的 gem 安装完成之后再尝试以下修改:

可以在一开始的 setpath.cmd 里面添加一行:

start cmd /k "cd C:\Projects\jekyllBlog && cd szhshpBlog && jekyll s -I"

实际上就是在 setPath 之后立刻启动 debugger, 其中需要对这么几个东西进行修改:

  1. 主文件夹 路径, 这里指向的是 C:\Projects\jekyllBlog, setpath.cmd 应该在这个文件夹之下
  2. 博客 repo 路径, 这里指向的是 C:\Projects\jekyllBlog\szhshpBlog , 应该和 setpath.cmd 同级
  3. 上方默认开启了 Incremental Build, 可以根据自己需求修改对应的参数

最终完整代码示例:

@ECHO OFF
ECHO Adding Jekyll to PATH……
SET RUBY_PATH=%~dp0ruby
SET DEVKIT_PATH=%~dp0devkit
SET PATH=%RUBY_PATH%\bin;%DEVKIT_PATH%\bin;%DEVKIT_PATH%\mingw\bin;%PATH%
start cmd /k "cd C:\Projects\_bg && cd szhshp && jekyll s -I"

以后双击这个 setpath.cmd 就可以直接打开调试

都这么简单了, 如果还有人搭不来本地调试环境就趁早转行吧

o(￣ヘ￣o＃)

2016-10-07 Updated

Error: SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://api.rubygems.org/latest_specs.4.8.gz)

参考这篇 Post 下方的解答：Ruby x Jekyll 本地调试环境搭建

2018-08-29 Updated

ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why:

Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://api.rubygems.org/latest_specs.4.8.gz)

这个其实是没有下载到最新版本的 Ruby, 导致使用了旧版本 SSL, 截止 2018-08-29 最新版本是 3.3, 确认下载最新版 ruby 即可解决问题

参考文献