文章目录
搭建个人博客的动机：从何时开始考虑？
其实这个念头早在我心中萌芽，直到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。
来源：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
