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

Question

代码库: https://github.com/FisherKK/F1sherKK-Online

我是Jekyll的新手，一次性提交了很多更改，现在我不知道问题出在哪里。我正在编辑minima布局。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文件。

我猜我会将此发送到[e-mail]，因为我已经阅读过他们也在解决这些问题...

- F1sher

Answer 1

根据您的存储库提交历史记录，问题现在已经得到解决，但我想添加一些解释。

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

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

当你在提交86df50b中删除了这个插件时，页面构建成功了。

结论：如果你使用GitHub Pages渲染你的网站，你应该只使用他们支持的插件。

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

这也在"通用Jekyll构建失败"故障排除页面中有所解释:

GitHub Pages服务器不支持未经支持的插件进行构建。唯一的方法是在本地生成您的网站，然后将您网站的静态文件推送到您的GitHub Pages网站。

- juzraai