Github Pages常见问题一览

July 1, 2024 / Deprecated

使用 Github Pages 作为我博客的 host server 已经有一段时间了,初期使用中遇到了不少问题,今天就来和你们分享一下。

已经提交 changes,但是没有立刻开始构建

根据 Github 的官方文档,第一次构建 pages 大概需要10 分钟,但是很多时候我们并不是第一次构建了,而且即使过了十分钟后,pages 也还是没有开始构建,就很令人着急。后来在一个 issue (惭愧,找不到页面了) 下面找到了问题的答案:

随便选择一个 Github pages 主题,即使你不使用 Jekyll。

image-20200707100136926

选择完成后会在你的根目录创建一个_config.yml文件,这样以后每次提交都会立马开始自动构建了。不过理论上来说没有这个 config 文件也是可以构建的,只是不知道是 github 把构建优先级降低了还是概率性的忽略了。

配置好了自定义域名,但是 username.github.io 没有跳转到我设置的域名

这是因为你的 repo 名称没有设置为username.github.io,是的,就是这么简单。而且不正确的 repo 名称还会影响你的其他 pages:

假设你创建另一个 repo – your_new_repo,并给它开启了 pages,理论上来说可以直接访问username.github.io/your_new_repo,但是如果你没有正确配置你的一级 repo 名称,这个 url 将会是 404。解决方法也有,就是配置另一个域名。。。

当然,只要你爱折腾,不改也无妨。