jekyll 页面构建失败

Question

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

我正在尝试使用 Github Pages 为小组项目创建一个网站，并且我已经分叉了这个存储库。 我进行了一些更改，网站已启动并运行。 今天我更新了一些图片，网站不会再建立了。 我尝试恢复到之前的提交，但它也不会构建。 我阅读了故障排除页面，但无济于事。 我不知道该怎么办了，请帮忙。

错误：

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

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

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

help[dot]github.com/articles/troubleshooting-jekyll-builds

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

我正在使用 github 的网络界面（不理想，我知道）。 存储库在这里。

Answer 1

该问题是由 GitHub 服务器中断引起的，而不是我的代码中的问题。

如果他们的服务器出现故障，任何人都可以在github status 网站上查看。 如果是这样，除了等到它再次恢复外，您无能为力...

Answer 2

我也发生了同样的错误。 但这不是由我的 Github 服务器问题引起的。 如果你没有使用 jekyll 构建，那么问题是有时 GitHub 页面会错误地将某些字符，特别是花括号，作为 jekyll 对象、标签等，导致你的页面构建失败。解决方法是创建一个空文件.nojekyll在您的根文件夹中。

并重新构建它。 它解决了我的。 希望它可以帮助某人。

Answer 3

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

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

---
TO DO
---

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

因此，有两种不同的解决方案有效：

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

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

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

Answer 4

正如您（和我自己）发现的那样，GitHub 遭遇了重大中断。

作为旁注，所有 Jekyll 页面都需要“Front Matter”，如果不包含它就不会正确构建。 它看起来像下面：

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

更多信息在这里： https : //jekyllrb.com/docs/frontmatter/

Answer 5

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

<------------------------------------------------- ---------/> master 分支的页面构建失败，错误如下：

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

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

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

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

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

Answer 6

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