- Require Modules
代码语言：txt复制- [环境部署 ](https://cloud.tencent.com/developer)
- [开始使用Jekyll ](https://cloud.tencent.com/developer)
- [再变得方便一些 ](https://cloud.tencent.com/developer)
- [2016-10-07 Updated ](https://cloud.tencent.com/developer)
- [2018-08-29 Updated ](https://cloud.tencent.com/developer)
- [参考文献 ](https://cloud.tencent.com/developer)实际上是一个 Portable Jekyll
拥有几个好处：1. 不必进行繁琐的 Ruby 和 DevKit 的安装
- 不需要管理员权限，公司电脑也可以搭建
- 适用于 Jekyll 3.X, 经测试 3.1.2 在安装额外的几个 gem 后也可以顺利使用
Require Modules
- ruby (从列表里找到最新的版本的 7z 下载解压)
- DevKit 4.7.2
环境部署
- 将自己的 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;�VKIT_PATH%bin;�VKIT_PATH%mingwbin;%PATH%- 最终的文件层次
Main Folder
- devkit
- Github Page ProJ
- ruby
- setpath.cmd建议不要把 ruby 放到 Github Page Folder 中，否则会在 build 的时候会报以下错误
代码语言：javascript复制 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
- 首先跑到 cmd 所在的路径，直接执行
setpath.cmd - 执行 gem install jekyll
- 进入 Github Page 文件夹执行 jekyll s
再变得方便一些
建议先完成上述步骤并且将必要的 gem 安装完成之后再尝试以下修改:
可以在一开始的 setpath.cmd 里面添加一行:
start cmd /k "cd C:ProjectsjekyllBlog && cd szhshpBlog && jekyll s -I"实际上就是在 setPath 之后立刻启动 debugger, 其中需要对这么几个东西进行修改:
主文件夹路径, 这里指向的是C:ProjectsjekyllBlog,setpath.cmd应该在这个文件夹之下博客 repo路径, 这里指向的是C:ProjectsjekyllBlogszhshpBlog, 应该和setpath.cmd同级- 上方默认开启了
Incremental Build, 可以根据自己需求修改对应的参数
最终完整代码示例:
代码语言：javascript复制@ECHO OFF
ECHO Adding Jekyll to PATH……
SET RUBY_PATH=%~dp0ruby
SET DEVKIT_PATH=%~dp0devkit
SET PATH=%RUBY_PATH%bin;�VKIT_PATH%bin;�VKIT_PATH%mingwbin;%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 即可解决问题
参考文献
- Jekyll 3.0.x (portable)
- Gem install fails with SSL certificate connection error #1736
