Windows下本地调试个人博客

• 1. 调试前准备
  • 1.1. 安装 Ruby + DevKit
  • 1.2. 使用gem安装Jekyll
• 2. 启动调试
• 3. 可能面临问题
  • 3.1. post.html与page.html有关的警告
  • 3.2. 文件夹下文件名不能兼容中文
  • 3.3. 本地4000端口被占用
• 4. 更新博客
• 5. Reference

本文为 基于Jekyll +github搭建的个人博客在 Windows 环境下的调试配置，以及可能会面临的一些问题，列出了一点解决方法及可行性建议。

本文内容非原创，整理了Windows本地调试个人博客以及Windows下本地配置Jekyll。

1. 调试前准备

1.1. 安装 Ruby + DevKit

Ruby 3.0 之后 Ruby 和DevKit 已经集成为一个软件，点此进入官网下载。
按照您的电脑系统，选择With DevKit项下的最新版，我的电脑是64位，则选择：

Ruby_Devkit安装图

安装路径尽量选非系统盘，路径名中不要使用中文与空格，英文名为宜。

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

• 此过程需要科学上网以及耐心(或者换切换gem源到国内镜像，例如https://gems.ruby-china.com)

• 打开一个Terminal输入gem install Jekyll,耐心等待即可

• 输入Jekyll -v确认安装完成

2. 启动调试

• 使用Github Desktop(建议)克隆你的博客项目到本地(如果没有博客，fork一个他人的或者新建一个，新建github博客可参考链接利用GitHub Pages 快速搭建个人博客)
  

  clone博客项目

• 进入你博客所在的文件夹，打开配置文件_config.yml，找到 gems: [jekyll-paginate] 这句语句，并将其改成 plugins: [jekyll-paginate]

• 然后执行命令> 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端口被占用

• 若出现以下问题

  
  
  本地4000端口被占用

• 解决方式

  • cmd中输入netstat -ano查看端口占用情况

  • 端口占用

  • 可以看到4000端口被一个PID=5824的程序占用，继续揪出来，输入tasklist /svc /FI "PID eq 5824"看到

  • 占用服务查看

  • 我们尝试关掉这个服务:打开任务管理器->服务->FxService，右键干掉，完美收工。

4. 更新博客

在本地https://127.0.0.1:4000/编辑与调试好博客之后，就可以push到github上了

使用GithubDesktop更新个人博客

---

5. Reference

1. Windows本地调试个人博客

2. Windows下本地配置Jekyll

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