搭建此博客遇到的问题

希望能够帮到后来者

Posted by 秋蜩鸣北林 on August 30, 2021

感谢@BY提供的详细教程,本博客才得以顺利搭建。详细教程参见 《利用 GitHub Pages 快速搭建个人博客》

然而在实际搭建过程中,依然遇到了若干问题,在此记录自己的解决办法。

本地调试博客

安装过程就不说了,先装 ruby 再装 rubygems(详见教程)。

然后项目初始化:

gem install jekyll
gem install jekyll bundler

但之后执行 jekyll s 以启动服务器时,出现了 cannot load such file -- webrick (LoadError) 的报错。查了很多资料未能解决,最后发现是我安装的 ruby 版本太高(3.0.1-1),不兼容 jekyll,重新安装低版本即可(推荐2.7.3-1)。

本地调试 Gitalk

点击此链接创建 GitHub Application,Application name 和 Application description 可以随便填,两个 URL 要填成自己博客主页的URL:

image1

创建以后先点击 Generate a new client secret 按钮生成一个 Clients secret:

image2

接下来的步骤按照开头提到的博客教程做即可。但在本地调试时,本机上的评论区显示了 Error: Bad credentials,经过广泛查询,出现该报错的原因是因为在本机(127.0.0.1:4000)初次进入页面时没有登陆 GitHub,access token 是 null,故而报错。配置好 Gitalk 后 push 然后用浏览器打开自己的博客,这条报错就会消失。

博客如何插入图片

我使用的 MarkDown 编辑器 Typora 可以把图片保存在 .asset 文件夹下。 Push 以后,找到该文件夹并打开:

image-20210830153754095

右键点击复制图片链接:

image-20210830153852587

在博客文本中替换掉图片的 URL 即可。(其实就是在路径前加上https://github.com/AvatarGanymede/AvatarGanymede.github.io/blob/master/_posts/前缀和?raw=true后缀)。