本文為 基于Jekyll +github搭建的個(gè)人博客在 Windows 環(huán)境下的調(diào)試配置颊郎，以及可能會(huì)面臨的一些問題邓了，列出了一點(diǎn)解決方法及可行性建議郎逃。
本文內(nèi)容非原創(chuàng)，整理了Windows本地調(diào)試個(gè)人博客以及Windows下本地配置Jekyll打瘪。
1. 調(diào)試前準(zhǔn)備
1.1. 安裝 Ruby + DevKit
Ruby 3.0 之后 Ruby 和DevKit 已經(jīng)集成為一個(gè)軟件，點(diǎn)此進(jìn)入官網(wǎng)下載悼枢。
按照您的電腦系統(tǒng)犀概，選擇With DevKit項(xiàng)下的最新版，我的電腦是64位挂滓，則選擇：
安裝路徑盡量選非系統(tǒng)盤苦银，路徑名中不要使用中文與空格，英文名為宜赶站。
驗(yàn)證此步成功與否幔虏，可以在命令行中分別輸入gem -v以及ruby -v，回顯版本號(hào)贝椿，即安裝成功
>gem -v
3.1.2
>ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x64-mingw32]
1.2. 使用gem安裝Jekyll
此過程需要科學(xué)上網(wǎng)以及耐心(或者換切換gem源到國內(nèi)鏡像想括，例如
https://gems.ruby-china.com)打開一個(gè)
Terminal輸入gem install Jekyll,耐心等待即可輸入
Jekyll -v確認(rèn)安裝完成
2. 啟動(dòng)調(diào)試
-
使用Github Desktop(建議)克隆你的博客項(xiàng)目到本地(如果沒有博客，fork一個(gè)他人的或者新建一個(gè)烙博，新建github博客可參考鏈接利用GitHub Pages 快速搭建個(gè)人博客)
clone博客項(xiàng)目 進(jìn)入你博客所在的文件夾瑟蜈，打開配置文件
_config.yml，找到gems: [jekyll-paginate]這句語句渣窜，并將其改成plugins: [jekyll-paginate]然后執(zhí)行命令
> gem install jekyll-paginate成功后將工作目錄切換到你clone的根目錄下( 例如我的就是
C://Users/Null/Desktop/destinyenvoy.github.io）,然后運(yùn)行命令> jekyll s铺根，然后理論上就OK了，可以在瀏覽器https://127.0.0.1:4000查看博客了图毕。
3. 可能面臨問題
3.1. post.html與page.html有關(guān)的警告
若出現(xiàn)如下警告
- 解決方式
? 在 _layouts下的post.html與page.html中夷都，找到 && 替換成and，找到site.featured-condition-size 將它的雙重大括號(hào)去掉予颤。
3.2. 文件夾下文件名不能兼容中文
- 修改目錄
E:\Ruby27-x64\lib\ruby\2.7.0\webrick\httpservlet下的filehandler.rb文件囤官，添加UTF-8編碼語句：
path = req.path_info.dup.force_encoding(Encoding.find("filesystem"))
path.force_encoding("UTF-8")
if trailing_pathsep?(req.path_info)
break if base == "/"
base.force_encoding("UTF-8")
break unless File.directory?(File.expand_path(res.filename + base))
3.3. 本地4000端口被占用
-
若出現(xiàn)以下問題
本地4000端口被占用
- 解決方式
cmd中輸入
netstat -ano查看端口占用情況- 端口占用
可以看到4000端口被一個(gè)PID=5824的程序占用，繼續(xù)揪出來蛤虐，輸入
tasklist /svc /FI "PID eq 5824"看到- 占用服務(wù)查看
我們嘗試關(guān)掉這個(gè)服務(wù):打開任務(wù)管理器->服務(wù)->FxService党饮，右鍵干掉，完美收工驳庭。
4. 更新博客
在本地https://127.0.0.1:4000/編輯與調(diào)試好博客之后刑顺，就可以push到github上了
