Portable Jekyll-最便捷的JEKYLL安装

文章首发于szhshp的第三边境研究所（szhshp.org）, 转载请注明

 

实际上是一个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本地调试环境搭建

参考文献

• Jekyll 3.0.x (portable)