Yummy-Jekyll踩坑日记

在使用jeckyll+githubPages+gitalk搭建完个人博客后，多多少少踩了些坑，其中有个本地环境问题折磨了我一天半。

Yummy-Jekyll的项目环境搭建

1.安装ruby

下载ruby2.2.6

下载DevKit

为什么下载2.2.6版本的呢，因为Yummy-Jekyll项目里的依赖有一个nokogiri 1.6.7-x64-mingw32包，该包需要ruby version < 2.3, >= 1.9.2。

gems版本依赖关系可以去这查询

直接安装exe。

安装完成后，在powershell里面运行 ruby -v显示当前的安装版本。

2.安装DevKit

在Windows上，没有在Linux上非常方便的Tool chain，比如gcc, make, sh,可以编译很多以源代码发布的Gem包。但是，对于初次在Windows上使用Ruby的用户来说，安装一个只有源代码的gem包，门槛还是不低的。

所以Ruby社区发布了DevKit（基于MSYS，MINGW）。

下载后，双击后，会解压到文件所在目录，这里随便选择（c:\DevKit）：

cd到这个目录，执行安装，同样使用powershell：

ruby dk.rb init

这一步会在当前目录生成 config.yml，在里面加入以下配置，也就是步骤1安装ruby的路径

---
 - D:\rudy\Ruby22-x64
 

修改完后 继续执行

 ruby dk.rb install

安装就完成了

3.下载Yummy-Jekyll并配置测试环境

Yummy-Jekyll源码

安装 gem 包有时候，会报错： ssl certificate error 1.修改gem源

查看源：gem sources -l 
图内镜像：gem sources -a https://gems.ruby-china.com/
删除源：gem sources -r https://rubygems.org/ 

下载证书：(这个也能解决git提交失败的https问题)
http://curl.haxx.se/ca/cacert.pem
设置环境变量：
SSL_CERT_FILE=<证书存放路径>
如：SSL_CERT_FILE=d:\RailsInstaller\cacert.pem
重启命令行，再次执行命令

如果还有问题
set SSL_CERT_FILE=<证书存放路径>

2.或者修改 .gemrc文件(windows 上 .gemrc 存放在： c:\users\your-acount 下面)

:ssl_verify_mode: 0

安装bower，bundle。

gem install bower

这里的bundle最好带上版本，不然默认安装最新的，最新的bundle要求ruby version >= 2.3.0。

gem install bundler -v '1.17.0'

添加国内镜像，实际参考

bundle config mirror.https://rubygems.org https://gems.ruby-china.com

bundle install

这里安装jekyll，jekyll指南

由于Yummy-Jekyll用到了github的api，所以还需要配置个人github的令牌. 获取令牌指南 添加系统环境变量(值为上面获取的个人令牌)

JEKYLL_GITHUB_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

获取密钥 添加系统环境变量(值为密钥完整的路径，如D:\java\demo\cacert.pem)

SSL_CERT_FILE=D:\java\demo\cacert.pem

重启计算机。

3.启动Yummy-Jekyll

修改Yummy-Jekyll源码根目录下的_config.yml文件。 repository：填写自己的githubPages地址 url：本地测试时填写：http://localhost:4000，提交到git仓库时填写githubPages地址

启动项目

jekyll serve

看到如下提示就表示启动成功了

直接访问http://localhost:4000就行了