我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

一般 Jekyll 构建失败

一般构建失败不会生成包含特定文件和错误信息的电子邮件。 如果您收到的电子邮件只是说“页面构建失败”而没有进一步的详细信息,或者您的 GitHub Pages 站点在第一次推送后没有显示,请检查这些常见错误。

我们建议您在本地构建站点,以便排查一般 Jekyll 构建失败,例如语法或标记错误。

未经验证的电子邮件地址

要触发构建,将提交推送到页面仓库的用户必须具有经验证电子邮件地址

验证电子邮件地址后,您的 GitHub 页面 站点将自动构建。

使用部署密钥推送

推送必须来自具有经验证电子邮件地址的用户帐户。 如果使用部署密钥向组织的页面仓库推送,则不会触发构建。

但是,您可以将计算机用户设置为组织的成员

不受支持的插件

GitHub 页面 服务器不会使用不受支持的插件进行构建。 将不受支持的插件纳入站点的唯一方法是:在本地生成站点,然后将站点的静态文件推送到 GitHub 页面 站点。 有关不受支持插件的列表以及如何将其纳入您的 GitHub 页面 站点,请参阅“添加 Jekyll 插件到 GitHub 页面 站点”。

大小限制

GitHub 上的仓库有每个仓库 1 GB 的软限制。 同样,GitHub 页面 站点也有 1 GB 的软限制。

如果您的页面站点超出该限制,您的站点可能无法构建。 您可能还会收到我们要求您缩减站点大小的礼貌邮件。

来源设置

我们的构建服务器在构建页面站点时会覆盖 source 设置。 如果您在 _config.yml 文件中更改此设置,您的 GitHub 页面 站点可能无法正确构建。

使用持续集成服务

有些 CI 服务(例如 Travis CI)不会生成 gh-pages 分支,除非您明确将其列入白名单。 如果希望 GitHub 页面 站点集成 CI 服务,您需要在 CI 的配置文件中指定 gh-pages 分支。

例如,Travis CI 的文档建议将以下行添加.travis.yml 文件中:

branches:
  only:
    - gh-pages

问问别人

找不到要找的内容?

联系我们