jekyll 页面构建失败答案

【问题标题】：jekyll page build failurejekyll 页面构建失败
【发布时间】：2017-03-03 18:47:18
【问题描述】：

我是网络开发的新手，所以请多多包涵。

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

错误：

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

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

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

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

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

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

【问题讨论】：

你看过推荐的页面了吗？尝试过他们建议的任何故障排除？ help.github.com/articles/troubleshooting-github-pages-builds 将有助于缩小原因。
FWIW，我在我自己的系统上克隆并使用jekyll 构建了您的网站，没有问题。主分支？
@CameronHurd 是的，它就在那里：“我阅读了故障排除页面，但无济于事。”我不认为他们适用，谢谢！
@CameronHurd 感谢您提供的信息！但是现在我不确定你提供了什么，因为我已经从 GitHub 上删除了存储库并再次分叉了原始存储库（这是 Conferência Desafio Brasil 的事情吗？）。你知道 GitHub Pages 构建是否有限制？我已经这样做了好几天了，我觉得奇怪的是错误有时会显示“无法构建页面。请稍后再试。”
啊 - 对不起。我不知道为什么错误会是间歇性的。再次克隆你的回购，一切都很好。如果您每次都能找到重现问题的方法，请添加这些详细信息，我们将快速解决该错误。 :)

标签： html css github jekyll

【解决方案1】：

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

任何人都可以在github status website 检查他们的服务器是否停机。如果是这样，除了等待它再次备份之外，您无能为力...

【讨论】：

【解决方案2】：

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

然后重新构建它。它解决了我的问题。希望它可以帮助某人。

【讨论】：

【解决方案3】：

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

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

---
TO DO
---

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

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

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

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

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

【讨论】：

【解决方案4】：

正如您（和我自己）所发现的，GitHub 遭遇了一次严重的中断。

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

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

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

【讨论】：

【解决方案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，但我不确定那里的响应速度。

【讨论】：

【解决方案6】：

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

【讨论】：