Portable Jekyll-最便捷的JEKYLL安装
实际上是一个 Portable Jekyll
拥有几个好处：1. 不必进行繁琐的 Ruby 和 DevKit 的安装
-
不需要管理员权限，公司电脑也可以搭建
-
适用于 Jekyll 3.X, 经测试 3.1.2 在安装额外的几个 gem 后也可以顺利使用
-
将自己的 Github Page 独立放到一个文件夹中
-
解压 Ruby 和 DevKit，保证解压出来的文件夹名称是「Ruby」和「DevKit」(Ruby 解压出的文件夹名称可能不是 Ruby)
-
建立一个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%
- 最终的文件层次
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.
- 首先跑到 cmd 所在的路径，直接执行
setpath.cmd - 执行 gem install jekyll
- 进入 Github Page 文件夹执行 jekyll s
建议先完成上述步骤并且将必要的 gem 安装完成之后再尝试以下修改:
可以在一开始的 setpath.cmd 里面添加一行:
start cmd /k "cd C:\Projects\jekyllBlog && cd szhshpBlog && jekyll s -I"
实际上就是在 setPath 之后立刻启动 debugger, 其中需要对这么几个东西进行修改:
主文件夹路径, 这里指向的是C:\Projects\jekyllBlog,setpath.cmd应该在这个文件夹之下博客 repo路径, 这里指向的是C:\Projects\jekyllBlog\szhshpBlog, 应该和setpath.cmd同级- 上方默认开启了
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＃)
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 本地调试环境搭建
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 即可解决问题