实际上是一个Portable Jekyll

拥有几个好处:

  1. 不必进行繁琐的Ruby和DevKit的安装

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

  3. 注意原帖写的是适用于Jekyll 3.0.X, 经测试3.1.2在安装额外的几个gem后可以顺利使用

Require Modules

  1. ruby 2.1.7

  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

Issues

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本地调试环境搭建

参考文献