jekyll页面构建失败

Question

我是网络开发的新手，所以请耐心等待。

我正在尝试使用Github Pages为群组项目创建网站，我已经分叉this repository。我做了一些更改，网站启动并运行。今天我更新了一些图片，网站将不再构建。我尝试恢复到之前的提交，但它也不会构建。我阅读了故障排除页面，但没有用。我不知道该怎么做了，请帮忙。

错误：

  

页面构建失败，出现以下错误：

     

页面构建失败。有关更多信息，请参阅help [dot] github.com/articles/troubleshooting-github-pages-build-failures。

     

有关Jekyll疑难解答的信息，请参阅：

     

帮助[点] github.com/articles/troubleshooting-jekyll-builds

     

如果您有任何疑问，请回复此电子邮件与我们联系。

我使用的是github的网页界面（我不知道）。存储库在这里。

Answer 1

问题是由GitHub服务器中断造成的，而不是代码中的问题。

任何人都可以在github status website检查他们的服务器是否已关闭。如果是的话，你可以做的事情不多，只要等到它再次恢复......

Answer 2

我刚刚遇到了同样的问题，我什至从未听说过 jekyll，也没有尝试使用它。显然它默认包含在 github.io 中，它“将纯文本转换为静态网站和博客”（reference）。

在阅读了许多这些答案并访问了有关 front matter 的链接文档后，我意识到出了什么问题。我的项目文件夹中有一个带有“待办事项”列表的文本文件，文件顶部以：

---
TO DO
---

并且这种格式（3 个破折号和换行符、文本和换行符、3 个破折号）恰好与 jekyll/YAML“前端块”相关，但是 TO DO 不是有效数据，所以它失败。

所以有两种不同的解决方案：

1. 将文本文件中的格式更改为连续 3 个以上的破折号。
2. 根据 this link，您可以“通过在发布源的根目录中创建一个名为 .nojekyll 的空文件来禁用 Jekyll 构建过程”。

第二个选项更好，因为您不会意外再次遇到此问题。

此外，如果它不起作用，请确保 .nojekyll 文件位于您的根文件夹中。我在 username.github.io/mywebsite/（这是我发布的网站的根目录）中有我的，但这不起作用。它必须位于您的 github 项目的根目录中（在您的 username.github.io 文件夹中）。

Answer 3

正如你（和我）发现的那样，GitHub遭遇了严重的中断。

作为旁注，所有Jekyll页面都需要“Front Matter”，如果它不包括在内，它将无法正确构建。它看起来如下：

---
layout: Template
title: Web Development Page
---

此处有更多信息：https://jekyllrb.com/docs/frontmatter/

Answer 4

如果您的问题与我的问题类似，您应该收到类似的电子邮件。

＆LT; --------------------------------------------- ------------- /＆GT; 主分支的页面构建失败，并出现以下错误：

无法构建页面。请稍后再试。

有关Jekyll疑难解答的信息，请参阅：

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

如果您有任何疑问，可以回复此电子邮件与我们联系。 ＆LT; -------------------------------------------------- ------- /＆GT;

虽然你可以而且应该使用@cameronHurd提供的链接 - twitter.com/githubstatus/status/789452827269664769 并通过@brunocuconato - https://status.github.com/查看您的构建过程中是否有错误，您也可以发送电子邮件至support@github.com，他们将能够手动重建您的网站。只需回复您发送的电子邮件，并可能包含指向您的回购的链接。我试着等到问题得到解决，发现这是一个更好的解决方案。您也可以通过Twitter与GitHub联系，但我不确定那里的响应速度。

Answer 5

请确保.md文件中的数据没有问题。我遇到了这个问题，最后在标签列表中还有一个逗号（，），因为我的构建一直在失败。您可以看到完整的答案here。

Answer 6

对我来说，发生了同样的错误。但这不是我的Github服务器问题引起的。如果您不使用jekyll进行构建，则问题是有时GitHub页面会将某些字符（特别是花括号）误认为jekyll对象，标签等，导致页面构建失败。解决方案是创建一个空文件 .nojekyll 在您的根文件夹中。

然后再次构建它。它解决了我的问题。希望对别人有帮助。