踩坑记录丨记Jekyll + Github Pages搭建个人博客时遇到的各种问题

文章目录

搭建个人博客的动机：从何时开始考虑？

其实这个念头早在我心中萌芽，直到04-08那天16:34的文章成为了导火索。我一直使用Obsidian进行文档整理，偶然间发现了这篇博客，进而浏览了作者的GitHub主页。发现其博客搭建得非常不错，激发了我想要创建自己博客的热情。

▲ Bend Blog 的个人主页

准备工作：选择Jekyll主题

在准备搭建之前，我花了些时间挑选Jekyll主题，最终选择了这个主题，并参考了其使用说明。

▲ 主题首页

搭建过程参考文章：

• Github+jekyll：建立你自己的博客网站
• github + jekyll 建自己的博客
• GitHub | 个人静态博客搭建 Jekyll

主要步骤总结：

• 在GitHub上创建仓库，注意仓库名应为<username>.github.io</username>
• 下载并解压RubyGems到任意目录
• 安装Jekyll

cd '解压路径'
ruby setup.rb
gem install jekyll

• 选择并配置Jekyll主题
• 将本地文件推送至GitHub远程仓库，详细步骤参考：Github+jekyll：建立你自己的博客网站

遇到的第一个问题：在Windows下无法搭建，不支持therubyracer

我使用的是Windows系统，最初尝试在Windows上搭建博客。完成前四步后，准备在本地测试，结果遇到了各种错误。

错误一：

Could not find a valid gem 'libv8-3.16.14.19' (>= 0) in any repository

解决方法：gem install libv8 -v '3.16.14.3' -- --with-system-v8

来源：安装libv8时出错：无法构建gem本机扩展？

错误二：

Installing therubyracer with native extensions C:/RailsInstaller/Ruby1.9.2/lib/ruby/site_ruby/1.9.1/rubygems/installer.rb:533:in `rescue inblock in build_extensions': ERROR: Failed to build gem native extension. (Gem::Installer::ExtensionBuildError)

解决方法：在Windows下无解，因为therubyracer不支持Windows。

话袋AI笔记

话袋AI笔记, 像聊天一样随时随地记录每一个想法，打造属于你的个人知识库，成为你的外挂大脑

47

查看详情

来源：therubyracer gem on windows

遇到的第二个问题：在Linux下Jekyll本地调试可以访问静态资源，但上传至GitHub后无法访问

将本地仓库文件推送至GitHub后，GitHub Actions中build报错：

github-pages 225 | Error:  The dev-portfolio-blog theme could not be found.

虽然本地测试一直正常，但无论如何修改GitHub上的文件，仍然报错。经过搜索，发现了如下文章：

• 使用jekyll本地调试可以访问静态资源，但是上传至GitHub无法访问的问题

然而，文章提供的方法对我无效，我一度感到绝望，准备重头再来。

解决方法：

继续寻找关于使用Jekyll和GitHub搭建博客的文章，最终找到以下文章：

• Jekyll + Github Pages 搭建个人免费博客

文章提到应将_site目录下的文件提交到GitHub上。我意识到我上传的不是_site目录下的文件，而是整个目录。我尝试将_site目录下的所有文件上传到GitHub，结果问题成功解决。

因此，必须确保推送至GitHub的文件是_site目录下的文件。

推送到GitHub上的文件应包括 index.html 文件

▲ 需要推送至GitHub上的文件

至此，两个主要问题都已解决。尽管每个问题中还有许多小问题需要探索，但这是一次充满挑战的经历。只要坚持不懈，结果终将如愿以偿！

—— 2022-04-09

以上就是踩坑记录丨记Jekyll + Github Pages搭建个人博客时遇到的各种问题的详细内容，更多请关注php中文网其它相关文章！