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

文章目录

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

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

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

准备工作:选择Jekyll主题

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

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

搭建过程参考文章:

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

主要步骤总结:

  • 在GitHub上创建仓库,注意仓库名应为.github.io
  • 下载并解压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目录下的文件。

踩坑记录丨记Jekyll + Github Pages搭建个人博客时遇到的各种问题 推送到GitHub上的文件应包括 index.html 文件

踩坑记录丨记Jekyll + Github Pages搭建个人博客时遇到的各种问题 ▲ 需要推送至GitHub上的文件

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

—— 2022-04-09

© 版权声明
THE END
喜欢就支持一下吧
点赞5 分享