jekyll 页面构建失败

jekyll page build failure

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

我正在尝试使用 Github 页面为一个小组项目创建一个网站,我已经分叉了 this repository。我做了几处更改,网站已经启动 运行。今天我更新了一些图片,网站就建不起来了。我尝试恢复到之前的提交,但它也不会构建。我阅读了故障排除页面,但无济于事。我不知道该怎么做了,请帮忙。

错误:

The page build failed with the following error:

Page build failed. For more information, see help[dot]github.com/articles/troubleshooting-github-pages-build-failures.

For information on troubleshooting Jekyll see:

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

If you have any questions you can contact us by replying to this email.

我正在使用 github 的网络界面(不理想,我知道)。存储库在这里。

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

任何人都可以在 github status website 检查他们的服务器是否已关闭。如果是,除了等到它再次备份外,您无能为力...

正如您(和我自己)发现的那样,GitHub 遭受了一次重大中断。

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

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

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

如果你的问题与我的类似,你应该已经收到了类似的电子邮件。

<---------------------------------------- --------------/> 主分支的页面构建失败,出现以下错误:

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

有关 Jekyll 故障排除的信息,请参阅:

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

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

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

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

我也出现了同样的错误。但这不是由 Github 服务器问题引起的,也不是我造成的。如果您没有使用 jekyll 构建,那么问题是有时 GitHub 页面会将某些字符(特别是花括号)误认为是 jekyll 对象、标签等,导致您的页面构建为 fail.The 解决方案是在您的根文件夹中创建一个空文件 .nojekyll

并重新构建它。它解决了我的问题。希望对大家有帮助。

我只是 运行 遇到了同样的问题,我从来没有听说过 jekyll,也没有尝试使用它。显然它默认包含在 github.io 中,并且它“T运行 将您的纯文本转换为静态网站和博客” (reference)。

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

开头
---
TO DO
---

并且格式(3 个破折号和换行符、文本和换行符、3 个破折号)恰好与 jekyll/YAML“前题块”相关,但 TO DO 无效数据,所以失败了。

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

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

第二个选项更好,因为你不会不小心 运行 再次陷入这个问题。

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