Github Pages 为 Jekyll 站点抛出 `Page build failure`

Question

repo :https://github.com/FisherKK/F1sherKK-Online

我是 Jekyll 的新手，在一次提交中 push 了许多更改，现在我很难说出问题在哪里。我正在编辑最小布局。 GitHub 返回一般错误:

Page build failed. For more information, see https://help.github.com/articles/troubleshooting-github-pages-builds/.

For information on troubleshooting Jekyll see:

https://help.github.com/articles/troubleshooting-jekyll-builds

If you have any questions you can contact us by replying to this email.

我运行 bundle update 没有问题，页面在本地工作:

$ bundle exec jekyll build Configuration file: /Users/F1sherKK/Dev/F1sherKK-Online/_config.yml
            Source: /Users/F1sherKK/Dev/F1sherKK-Online
       Destination: /Users/F1sherKK/Dev/F1sherKK-Online/_site  Incremental build: disabled. Enable with --incremental
      Generating... 
                    done in 0.523 seconds.  
      Auto-regeneration: disabled. Use --watch to enable.

我已经尝试过以下事情:

1. 根据:Github page build failure
   • 我已确认我只使用 gh-pages 分支。
   • 我已确认我没有添加任何 _ 起始文件夹(Jekyll 使用的文件夹除外)
   • 我已经添加了 .nojekyll 文件，但是我的网站完全崩溃了(404，白色，没有布局)所以我删除了它。
2. 根据:jekyll page build failure
   • 确认 GitHub 服务器正在工作:https://status.github.com/messages
3. 根据:"page build failed" when pushing a new blog post to github
   • 确认我的类别(例如 categories: machine_learning deep_learning history)不在列表 [] 括号中。
4. 根据:Adding of any html file from the minima/_includes directory into the website directory cause the github build to fail
   • 我认为我没有触及 head.html 文件中的任何内容。

我想我会把它发送到 support@github.com 因为我读过他们也在处理这些问题......

Answer 1

正如我从您存储库的提交历史中看到的那样，问题现在已解决，但我想添加一个解释。

页面构建首先失败，提交 6759bff .在此提交中，我注意到您添加了一个名为 jekyll-inline-svg 的 Jekyll 插件。

GitHub 页面仅支持 a small set of plugins , 而 jekyll-inline-svg 不在此列表中。

看，当您在提交 86df50b 中删除此插件时，页面再次构建成功。

结论:如果您使用 GitHub Pages 渲染您的网站，您应该只使用它们支持的插件。

替代解决方案是在本地呈现您的网站，然后将 _site 目录的内容上传到您的 GitHub 存储库。在这种情况下，您必须将 .nojekyll 添加到 turn off rendering在 GitHub 页面上。

这也在 “Generic Jekyll build failures” 中进行了解释 troubleshooting page :

The GitHub Pages server will not build with unsupported plugins. The only way to incorporate unsupported plugins in your site is to generate your site locally and then push your site's static files to your GitHub Pages site.