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: The MSYS2 DevKit is downloaded as the last 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模板等等。