Github Pages 为 Jekyll 站点抛出“页面构建失败”

Question

回购：https : //github.com/FisherKK/F1sherKK-Online

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

页面构建失败。有关更多信息，请参阅 https://help.github.com/articles/troubleshooting-github-pages-builds/。

有关 Jekyll 故障排除的信息，请参阅：

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

如果您有任何问题，可以通过回复此电子邮件与我们联系。

我运行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 页面构建失败
   • 我已经确认我只使用gh-pages分支。
   • 我已经确认我没有添加任何_起始文件夹（除了 Jekyll 使用的文件夹）
   • 我添加了.nojekyll文件，但我的网站完全崩溃（404，白色，无布局），所以我删除了它。
2. 根据：jekyll 页面构建失败
   • 确认 GitHub 服务器正在工作：https : //status.github.com/messages
3. 根据：将新博客文章推送到 github 时，“页面构建失败”
   • 确认我的类别（例如categories: machine_learning deep_learning history）不在列表[]括号中。
4. 根据：将 minima/_includes 目录中的任何 html 文件添加到网站目录中都会导致 github 构建失败
   • 我认为我没有触及head.html文件中的任何内容。

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

Answer 1

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

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

GitHub Pages 仅支持一小部分插件，并且jekyll-inline-svg不在此列表中。

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

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

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

“Generic Jekyll build Failures”故障 排除页面也对此进行了解释：

GitHub Pages 服务器不会使用不受支持的插件进行构建。在站点中合并不受支持的插件的唯一方法是在本地生成站点，然后将站点的静态文件推送到 GitHub Pages 站点。