5月?lián)Q了新筆電，所有的東西都沒有了。一直懶，也就重新搭建jekyll。昨天周末，閑來無事，又重新在win10的新機(jī)上搭了一次，吼吼吼。
這邊盡量是正確的步驟，其實看起來沒幾步，但搭建的時候花了好幾個小時，返工了好幾次，果然我還是老的太快了，，哈哈
- 配置信息
- github
- 安裝Devkit
- 安裝Ruby
- 安裝jekyll
- 問題集錦
配置信息
win10x64
github
github的操作不再多說，下載git客戶端，生成密鑰對，將公鑰保存在github上，然后本機(jī)就可以直接clone項目啦
提交修改主要是以下幾步
git add . //如果沒有新加文件可以不用運行此句
git commit -am '描述內(nèi)容'
git push (-u origin master) //括號中內(nèi)容可加可不加
安裝Devkit
這玩意我其實也不造有啥用，因為我第一次搭的時候沒裝，jekyll也跑的起來~~
官方地址：http://rubyinstaller.org/downloads/
官方到目前為止還能用，如果不幸和諧的話，可以去這里下載
下載適合自己pc的版本，安裝的時候盡量安裝在根目錄下，且路徑中不能含空格（這是人家的經(jīng)驗，借來用用）
安裝Ruby
Ruby是安裝jekyll必需的，jekyll需要gem，gem需要Ruby
官方地址：同樣是http://rubyinstaller.org/downloads/
同上，官方到目前為止還能用，如果不幸和諧的話，可以去這里下載
下載最新的版本，同樣在路徑中不能含空格，并且勾選add to path
安裝好后進(jìn)cmd運行如下代碼：
cd devkit \\將當(dāng)前目錄轉(zhuǎn)移到devkit解壓路徑
ruby dk.rb init \\初始化Ruby
ruby dk.rb install`
然后運行ruby -v，出現(xiàn)版本號則安裝成功
安裝jekyll
最關(guān)鍵也是摔跤最多的步驟?。?/p>
安裝gem
可以到https://rubygems.org/下載合適的gem安裝包及所需的功能包
-
gem -v檢查gem版本
-
gem update --system更新gem
-
gem -v檢查gem版本
安裝jekyll
gem install jekyll安裝jekylljekyll -v安裝成功之后，查看版本號
至此為止jekyll已經(jīng)安裝完畢，cmd切換至git項目目錄，運行jekyll serve，即可在本地localhost:4000進(jìn)行編譯預(yù)覽
問題集錦
當(dāng)然沒這么簡單，實際操作會遇到各種各樣的問題~
Q1:jekyll版本不同導(dǎo)致啟動本地服務(wù)時liquid語法報錯
這個錯誤研究了一晚上，上圖是jekyll 3.2.1版本下編譯時的liquid報錯，直到今早將兩地環(huán)境做了對比才發(fā)現(xiàn)是jekyll版本導(dǎo)致的，下圖是jekyll 3.1.3運行時
解決方法是卸載最新版，安裝指定的jekyll版本
gem uninstall jekyll -v 3.2.1
gem install jekyll -v 3.1.3
Q2:啟動服務(wù)時提示 Please add the following to your Gemfile to avoid polling for changes: gem 'wdm', '>= 0.1.0' if Gem.win_platform?
只要運行gem install wdm即可（好吧這個其實不重要，不改也可以）
以下問題此次安裝都沒有發(fā)生，但是前幾次是遇到的，所以還是貼出來
Q3:gem install jekyll后報錯一
ERROR: Could not find a valid gem 'jekyll' (>= 0), here is why:
Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://rubygems.global.ssl.fastly.net/quick/Marshal.4.8/jekyll-1.3.0.gemspec.rz)
ERROR: Possible alternatives: jekyll
解決方法：
-
如果是windows用戶，需要先安裝curl
下載認(rèn)證文件
curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem
D:\Ruby200-x64>curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 223k 100 223k 0 0 82478 0 0:00:02 0:00:02 --:--:-- 94724
- 把生成在Ruby目錄下的cacert.pem移動到里面的bin目錄下
~ D:\workspace\ruby>mv cacert.pem D:\toolkit\Ruby200\bin
- 設(shè)置環(huán)境變量
Q4:gem install jekyll后報錯二
ERROR: Error installing jekyll:
The 'fast-stemmer' native gem requires installed build tools.
Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions
at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'
解決方法：安裝好Devkit后，運行Devkit目錄下的msys.bat后，然后輸入gem install jekyll來安裝jekyll
Q5:Rubygems鏡像源報錯
因為官方鏡像源https://rubygems.org/經(jīng)常罷工，所以我們需要添加新的鏡像源https://ruby.taobao.org
$ gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org
# 請確保只有 ruby.taobao.org
但上次發(fā)現(xiàn)淘寶的也玩不起來了，維護(hù)者在issue下有這樣一段回復(fù)，原來是換新Gems源https://gems.ruby-china.org/了
$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
$ gem sources -l
https://gems.ruby-china.org
# 確保只有 gems.ruby-china.org
Q6：代碼高亮
至于代碼高亮包pygments，由于自2016起，github不再支持pygments，所以我們不再安裝pygments包（其實也就不需要安裝python和pip啦），而改用rouge高亮包
