序

        因?yàn)閎站不支持代碼格式，所以去博客看效果會更好些（這不是廣告

        博客地址：http://blog.xxin.live

正

win10下安裝Jekyll環(huán)境及可能遇到的問題

        前天因?yàn)橄到y(tǒng)重裝了一下，前面一個(gè)周末搞明白才弄好的jekyll環(huán)境也沒了，現(xiàn)在乘著重新搭建環(huán)境順便寫個(gè)博客，梳理下自己搭建時(shí)候遇到的一些問題和解決方法，和搭建環(huán)境的完整過程。

安裝環(huán)境

1. 下載 railsinstaller

在win10系統(tǒng)下需要下載railsinstaller安裝后才行，到本此面去下載http://railsinstaller.org/en

2. 安裝

建議安裝時(shí)候用默認(rèn)路徑

3. 更新gem

首先更換國內(nèi)的RubyGems鏡像源

$ gem sources --add http://gems.ruby-china.org/ --remove https://rubygems.org/ 

$ gem sources -l 

https://gems.ruby-china.org # 確保只有 gems.ruby-china.org

然后進(jìn)行更新gem

$ gem update

會出現(xiàn)一個(gè)錯(cuò)誤，提示ruby版本過低 我們就要去下載安裝新版ruby下載地址https://rubyinstaller.org/downloads/

默認(rèn)安裝位置安裝完成

會有一個(gè)命令窗彈出，如果不知道怎么選擇的話按回車就行了

安裝完成后輸入下面命令，檢查版本信息查看是否完成更新

$ ruby -v

ruby更新完成后我們開始更新gem

$ gem update

中途會有兩個(gè)需要確認(rèn)信息，輸入y之后回車即可

可能會遇到某個(gè)更新包損壞情況，通過提示路徑找到刪除掉重新輸入更新命令更新即可

更新結(jié)束后輸入命令查看是否更新了新版本

$ gem -v

4.安裝jekyll

輸入命令進(jìn)行安裝

$ gem install jekyll

安裝完成后查看版本信息

$ jekyll -v

5.新建博客

環(huán)境安裝完成后開始在本地生成一個(gè)博客

$ jekyll new myblog

這時(shí)候我們可能會出現(xiàn)一個(gè)錯(cuò)誤

Dependency Error: Yikes! It l（中間復(fù)雜信息省略掉）yllrb.com/help/!jekyll 3.5.2 | Error:  bundler

這里說我們一個(gè)bundler損壞了，我們需要重新下載安裝

$ gem install bundler

安裝完成后我們重復(fù)之前的生成博客命令
可能還會遇到一個(gè)問題，輸入命令后卡在了生成過程中，我們鍵盤快捷鍵CTRL+C結(jié)束生成，會出現(xiàn)一堆可能看不懂的信息

輸入命令

$ jekyll serve

會出現(xiàn)以下信息

C:/Ruby22-x64/（中間復(fù)雜信息省略掉）le or available on      this machine. (Bundler::GemNotFound)

這里的主要信息是提示沒有(Bundler::GemNotFound) 回到上級目錄重新安裝

$ bundle install

會提示我們 

Could not locate Gemfile

我們需要進(jìn)入博客根目錄然后再執(zhí)行安裝命令

6.生成博客本地查看

安裝完成后我們再次生成一個(gè)博客 ,過程應(yīng)該不會太長，一分鐘左右

jekyll new blog 

生成完成后我們進(jìn)入博客目錄

$ cd blog 

$ jekyll serve 

這時(shí)候我們的博客生成全部完成我們可以在瀏覽器輸入http://127.0.0.1:4000/ 查看生成結(jié)果

這時(shí)候我們的所有博客生成環(huán)境就完成了安裝

7. 使用模板生成自己的博客

我們并不需要自己寫一個(gè)博客因?yàn)橛泻芏鄡?yōu)秀的博客模板可以直接使用，我們只需要稍加修改就可以用上了

這里有個(gè)網(wǎng)站，收集了許多優(yōu)秀的模板大家可以自己找到自己喜歡的進(jìn)行修改使用 http://jekyllthemes.org/

這里我使用了https://github.com/leopardpan/leopardpan.github.io/
這個(gè)模板，同時(shí)參考了視頻

使用模板時(shí)下載原模板文件解壓后拖到生成博客的目錄下，進(jìn)行一次本地啟動生成服務(wù)，也就是執(zhí)行

$ jekyll serve命令

初次生成可能會再次出現(xiàn)一個(gè)問題

$ jekyll serve

Configuration file: c:/S（中間復(fù)雜信息省略掉）ekyllrb.com/help/!jekyll 3.5.2 | Error:  jekyll-paginate

通過報(bào)錯(cuò)的信息我回到Sites目錄執(zhí)行命令安裝

$ gem install jekyll-paginate

安裝完成后我們再次進(jìn)入博客根目錄啟動服務(wù)
這時(shí)候可能還會報(bào)錯(cuò)

我們需要在配置文件_config.yml添加一行：

gems: [jekyll-paginate]

保存后重新啟動一次服務(wù)
就可以看到博客模板已經(jīng)成功的啟動了，我們可以根據(jù)自己的需求修改模板的東西，最后完成自己的博客生成

最后一步就是在gtihub pages上部署了

這里我放到下一篇再寫，這篇主要就是在win10系統(tǒng)下搭建jekyll需要的環(huán)境以及可能會遇到的問題，有些地方寫的可能不是非常明白，可以留言等我補(bǔ)充=.=

本次博客參考了以下文章和網(wǎng)頁內(nèi)容

http://pwnny.cn/original/2016/06/26/MakeBlog.html#NativeBuild
http://www.jianshu.com/p/12e7e1f8007e
https://gems.ruby-china.org/
http://blog.csdn.net/moonclearner/article/details/52238033
http://jekyll.com.cn/
http://www.bilibili.com/video/av13994132
https://github.com/leopardpan/leopardpan.github.io
https://teamtreehouse.com/community/jekyllpaginate-gem

---判官喵.2017-09-19