Windows安装Jekll
Windows安装Jekll
一直想弄个自己的个人博客，于是研究了一下Github Pages。发现很多人都推荐使用Jekyll这个工具来生成静态页面的博客。踩了点坑，在这里记录下来。
我的环境及相关软件版本：
win10 x64
Ruby 2.4.1-2 (x64)
Jekyll 3.5.0
在本文中，我的最终目标是安装Jekyll，Jekyll需要Ruby环境，于是就要先安装Ruby。
我安装的是版本2.4，在Windows系统安装Ruby是通过RubyInstaller来安装的。
看官网2.4版本与之前2.3的版本的安装是有点差异的：
- 2.3版本的需要下载RubyInstaller和DevKit-mingw64
- 2.4版本之后，需要安装RubyInstaller和MSYS2 toolkit
请看原文：
WHICH DEVELOPMENT KIT?
Down this page, several and different versions of Development Kits (DevKit) are listed. Please download the right one for your version of Ruby:
Ruby 2.4.0 and newer: TheMSYS2 DevKitis downloaded as thelast step of the installation.（意思是安装RubyInstaller后会提示安装MSYS2，无需像2.3那样另外下载mingw64来安装）- Ruby 2.0.0 to 2.3.x (32bits): mingw64-32-4.7.2
- Ruby 2.0.0 to 2.3.x (64bits): mingw64-64-4.7.2
The RubyInstaller Development Kit (DevKit) is a MSYS/MinGW based toolkit than enables you to build many of the native C/C++ extensions available for Ruby. Starting with Ruby 2.4.0 > it is replaced by the
MSYS2 toolkit.
1. 安装RubyInstaller及MSYS2
下载RubyInstaller打开安装，安装最后会弹出一个cmd窗口，就是用来安装MSYS2的，选择3
MSYS2安装过程比较顺利，但是还没完，看MSYS2官网，安装后还需要升级一下核心的包。请看官网的安装指南，写的很清楚，也有截图。浏览不到请自行搭梯。
2. 升级MSYS2的核心包
在MSYS2的界面输入升级核心包的命令：pacman -Syu，升级过程可能由于网速不稳定不断报错，自行搭梯，多试几次。
如果还有其它问题，官网说可以关闭在重新打开MSYS2，运行命令pacman -Su。
升级过程相关截图如下：
我在自己机器安装了很久，打了一盘王者荣耀才安装好。如果升级成功了，就可以进行下一步：安装Jekyll
3. 安装Jekll
打开命令行，检查一下ruby和ruby的包管理器gem（类似与node.js的npm）的安装:
C:\Users\choi>ruby -v ruby 2.4.1p111 (2017-03-22 revision 58053) [x64-mingw32] C:\Users\choi>gem -v 2.6.11
设置一下使用国内的镜像：gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
如果安装过程提示连接不了，试试换成http的镜像地址：`gem sources --add http://gems.ruby-china.org/ https://gems.ruby-china.org/
查看gem当前设置的镜像：gem sources -l
使用gem安装Jekyll：gem install jekyll
安装很快会完成，接下来需要测试一下Jekyll了。
4. Jekll的HelloWorld
命令号随便导航到一个目录，运行命令jekyll new my-blog创建一个默认的博客目录，但是会报错，说少了一个bundler，解决也很简单，用gem安装即可：gem install bundler。如下图：
安装后再次运行jekyll new my-blog即可成功创建默认的博客了。
cd my-blog进入目录，运行jekyll serve开启一个本地的服务端。
但是好事多磨，又报错，还有一个警告：
对于Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.这个警告，解决办法是打开_config.yml将gems:改成plugins:
对于jekyll 3.5.0 | Error: Permission denied - bind(2) for 127.0.0.1:4000这个报错，解决办法是打开_config.yml，在最后加入配置来修改端口port:4001
最后，终于成功了。如下图：
5. 发布到GitHub Pages
GitHub Pages是支持并推荐使用Jekyll的，这也是我为什么弄GitHub Pages前先弄Jekyll的原因。现在弄好了，可以把这个my-blog发布上去。
首先需要注册一个github帐号，例如我的帐号是CaiBaoHong，然后就需要在github上创建一个CaiBaoHong.github.io的仓库。注意，必须是跟帐号同名的。然后把my-blog目录下所有文件提交到这个仓库，然后就可以访问https://caibaohong.github.io（点击进去仓库，在settings那里可以看到访问的url）
到这里为止，我就把坑踩了一遍，走通了Jekyll创建GitHub Pages的流程啦。
接下来需要研究的还有：如何使用Jekyll这个工具来编辑博客文章，如何使用别人现成的Jekyll模板等等。