实际上是一个Portable Jekyll

拥有几个好处:

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

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

  3. 适用于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 即可解决问题

参考文献

  • 文章标题: 《Portable Jekyll-最便捷的JEKYLL安装》
  • 发布日期: 2016-02-24
  • 文章分类: Tech
  • 相关标签: Ruby Jekyll