• 1. 調(diào)試前準備
  • 1.1. 安裝 Ruby + DevKit
  • 1.2. 使用gem安裝Jekyll
• 2. 啟動調(diào)試
• 3. 可能面臨問題
  • 3.1. post.html與page.html有關的警告
  • 3.2. 文件夾下文件名不能兼容中文
  • 3.3. 本地4000端口被占用
• 4. 更新博客
• 5. Reference

本文為 基于Jekyll +github搭建的個人博客在 Windows 環(huán)境下的調(diào)試配置，以及可能會面臨的一些問題，列出了一點解決方法及可行性建議。

本文內(nèi)容非原創(chuàng)，整理了Windows本地調(diào)試個人博客以及Windows下本地配置Jekyll。

1. 調(diào)試前準備

1.1. 安裝 Ruby + DevKit

Ruby 3.0 之后 Ruby 和DevKit 已經(jīng)集成為一個軟件，點此進入官網(wǎng)下載。
按照您的電腦系統(tǒng)，選擇With DevKit項下的最新版，我的電腦是64位，則選擇：

Ruby_Devkit安裝圖

安裝路徑盡量選非系統(tǒng)盤，路徑名中不要使用中文與空格，英文名為宜。

Ruby_Devkit安裝1

Ruby_Devkit安裝2

驗證此步成功與否，可以在命令行中分別輸入gem -v以及ruby -v，回顯版本號，即安裝成功

>gem -v
3.1.2
>ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x64-mingw32]

1.2. 使用gem安裝Jekyll

• 此過程需要科學上網(wǎng)以及耐心(或者換切換gem源到國內(nèi)鏡像，例如https://gems.ruby-china.com)

• 打開一個Terminal輸入gem install Jekyll,耐心等待即可

• 輸入Jekyll -v確認安裝完成

2. 啟動調(diào)試

• 使用Github Desktop(建議)克隆你的博客項目到本地(如果沒有博客，fork一個他人的或者新建一個，新建github博客可參考鏈接利用GitHub Pages 快速搭建個人博客)
  

  clone博客項目

• 進入你博客所在的文件夾，打開配置文件_config.yml，找到 gems: [jekyll-paginate] 這句語句，并將其改成 plugins: [jekyll-paginate]

• 然后執(zhí)行命令> gem install jekyll-paginate

• 成功后將工作目錄切換到你clone的根目錄下( 例如我的就是C://Users/Null/Desktop/destinyenvoy.github.io）,然后運行命令> jekyll s，然后理論上就OK了，可以在瀏覽器https://127.0.0.1:4000查看博客了。

3. 可能面臨問題

3.1. post.html與page.html有關的警告

post.html與page.html有關警告

• 解決方式

? 在 _layouts下的post.html與page.html中，找到 && 替換成and，找到site.featured-condition-size 將它的雙重大括號去掉。

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端口被一個PID=5824的程序占用，繼續(xù)揪出來，輸入tasklist /svc /FI "PID eq 5824"看到

  • 占用服務查看

  • 我們嘗試關掉這個服務:打開任務管理器->服務->FxService，右鍵干掉，完美收工。

4. 更新博客

在本地https://127.0.0.1:4000/編輯與調(diào)試好博客之后，就可以push到github上了

使用GithubDesktop更新個人博客

5. Reference

1. Windows本地調(diào)試個人博客

2. Windows下本地配置Jekyll

3. 利用 GitHub Pages 快速搭建個人博客