[环境搭建]Windows下安装Ruby和Jekyll

柔光的暖阳◎ 2022-08-07 08:37 206阅读 0赞

========================================================  
作者：qiujuer  
博客：[blog.csdn.net/qiujuer][blog.csdn.net_qiujuer]  
网站：[www.qiujuer.net][]  
开源库：[github.com/qiujuer/Genius-Android][github.com_qiujuer_Genius-Android]  
转载请注明出处：[http://blog.csdn.net/qiujuer/article/details/44620019][http_blog.csdn.net_qiujuer_article_details_44620019]  
——学之开源，用于开源；初学者的心态，与君共勉！

========================================================

Jekyll是一款静态网站生成工具，允许用户使用HTML、Markdown或Textile通过模块的方式建立所需网站，然后通过模板引擎Liquid（Liquid Templating Engine）来运行或者生成对应的静态网站文件.  
在GitHub上使用较多，通过GitHub搭建自己的博客一般来说就是使用Jekyll；因为GitHub的渲染引擎默认为Jekyll。

网上很多类似的安装教程，但是一般来说都是需要安装Python，在本篇文章中我们不使用“Pygments”代码高亮引擎，所以不需要安装Python。

## 安装 Ruby ##

Jekyll是一款基于Ruby的插件，安装Ruby是必须的.  
1. 下载，传送阵：[http://rubyinstaller.org/downloads/][http_rubyinstaller.org_downloads]  
2. 点击版本并下载，这里我下载的是：“Ruby 2.2.1 (x64)”  
3. 点击进行安装，此时需要注意两点：  
\*安装目录不允许包含空格  
\*选中“Add Ruby executables to your PATH”这样将自动完成环境变量的配置。  
![这里写图片描述][20150325120514276]

4.完成后进入“CMD”输入“**ruby -v**”如显示版本则代表安装成功。

## 安装 DevKit ##

DevKit 是一个在 Windows 上帮助简化安装及使用 Ruby C/C++ 扩展如 RDiscount 和 RedCloth 的工具箱。  
更多详细的安装指南请查看Ruby的 [wiki][] 页面 阅读。

1.  前往 [http://rubyinstaller.org/downloads/][http_rubyinstaller.org_downloads]
2.  下载与 Ruby 版本相对应的 DevKit 安装包。 例如：“DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe”  
    版本对应关系：
    
    > Ruby 1.8.7 and 1.9.3:  
    > DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
    > 
    > 2.0 and 2.1 (32bits version only):  
    > DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe
    > 
    > 2.0 and 2.1 (x64 - 64bits only)  
    > DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe
3.  运行文件选择解压目录，如“D:\\ToolKits\\Ruby\\DevKit”
4.  解压完成后，通过初始化来创建 config.yml 文件。在命令行窗口内，输入下列命令：
    
        cd "D:\ToolKits\Ruby\DevKit"
        ruby dk.rb init
        notepad config.yml
5.  此时已经使用记事本打开所创建的”config.yml”文件，于末尾添加新的一行: “**- D:/ToolKits/Ruby/Ruby21-x64**“，这里的目录为你的Ruby的安装目录，保存文件并退出。
6.  回到命令行窗口内进行安装。
    
        ruby dk.rb install

## 安装 Jekyll ##

1.  首先确保 gem 已经正确安装
    
        //命令输入
        gem -v
        //输出
        2.2.2
2.  安装 Jekyll
    
        //命令行执行
        gem install jekyll
3.  错误  
    在这里或许你将遇到一定的问题，比如：

> ERROR: Could not find a valid gem ‘jekyll’ (>= 0), here is why:  
> Unable to download data from [https://rubygems.org/][https_rubygems.org] \- SSL\_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed ([https://api.rubygems.org/latest\_spece.4.8.gz][https_api.rubygems.org_latest_spece.4.8.gz])

这个错误的原因是因为证书问题，简单的解决办法为：下载最新的证书，放到指定文件夹，并配置环境变量。

下载：[http://curl.haxx.se/ca/cacert.pem][http_curl.haxx.se_ca_cacert.pem]  
拷贝到：Ruby安装目录下的“bin”文件夹下  
环境变量：  
![这里写图片描述][20150325183352856]

至于其他错误，比如443错误，这个多访问几次，或者挂上VPN进行，多尝试几次就OK。

## 安装 Rouge ##

一般来说静态生成中经常会使用高亮代码等功能，而高亮代码的生成一般需要插件帮助完成才行；在常规中一般都是使用：“Pygments”；因为”Pygments“是python下面的插件，所以需要先安装Python之后才能安装该插件，我嫌麻烦在实际使用中采用的是”Rouge“高亮插件。  
之所以使用：”Rouge”，是因为在 Jekyll 官网中也曾提到以后将会使用该插件。  
安装步骤非常简单，同样使用命令行安装就OK：

//命令行 Gem 安装
    gem install rouge

一般来说有一定可能会遇到服务器没有响应或者 443 等错误，这些都无需担心，多尝试几次就OK。

## 安装步骤演示 ##

![这里写图片描述][20150325234352799]  
![这里写图片描述][20150325234403812]  
![这里写图片描述][20150325234449098]  
![这里写图片描述][20150325234458473]  
![这里写图片描述][20150325234508879]  
![这里写图片描述][20150325234516179]  
![这里写图片描述][20150325234449879]  
![这里写图片描述][20150325234456681]

========================================================

[blog.csdn.net_qiujuer]: http://blog.csdn.net/qiujuer
[www.qiujuer.net]: http://www.qiujuer.net/
[github.com_qiujuer_Genius-Android]: https://github.com/qiujuer/Genius-Android
[http_blog.csdn.net_qiujuer_article_details_44620019]: http://blog.csdn.net/qiujuer/article/details/44620019
[http_rubyinstaller.org_downloads]: http://rubyinstaller.org/downloads/
[20150325120514276]: /images/20220805/6ff13a848824410e93eae83b2329ae0d.png
[wiki]: https://github.com/oneclick/rubyinstaller/wiki/Development-Kit#installation-instructions
[https_rubygems.org]: https://rubygems.org/
[https_api.rubygems.org_latest_spece.4.8.gz]: https://api.rubygems.org/latest_spece.4.8.gz
[http_curl.haxx.se_ca_cacert.pem]: http://curl.haxx.se/ca/cacert.pem
[20150325183352856]: /images/20220805/031ab123c2754ea38c22a447ec086e30.png
[20150325234352799]: /images/20220805/a31e23eb6a48443f88221fbc80509290.png
[20150325234403812]: /images/20220805/d13f140fbd2b47a29027f96b10b8bff4.png
[20150325234449098]: /images/20220805/2276bed278ef4c25b33cd123b811916f.png
[20150325234458473]: /images/20220805/28396aa7b45449ddabe0e9c5995587e9.png
[20150325234508879]: /images/20220805/622b844adc4247e9ac558a1fc5a0e147.png
[20150325234516179]: /images/20220805/f07bfc0640694cabbd166f43ad6fc7ce.png
[20150325234449879]: /images/20220805/1cb911994ec7479a9581a82e970b0979.png
[20150325234456681]: /images/20220805/4727932c87e84ed18462c43c969517d3.png