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

此版本的 GitHub Enterprise 已停止服务 2020-11-12. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

关于 GitHub Pages 站点的 Jekyll 构建错误

如果在本地或 GitHub Enterprise Server 上构建 GitHub Pages 站点发生 Jekyll 错误,您将收到一条错误消息,其中包含相关详细信息。

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

本文内容

关于 Jekyll 构建错误

Sometimes, GitHub Pages will not attempt to build your site after you push changes to your site's publishing source.

  • 您使用部署密钥推送。 如果要自动推送到站点的仓库,您可以改为设置计算机用户。 更多信息请参阅“管理部署密钥”。
  • 您使用的是未配置为构建发布源的 CI 服务。 例如,Travis CI 不会构建 gh-pages 分支,除非您将该分支添加到安全列表。 更多信息请参阅 Travis CI 上的“定制构建”或者 CI 服务的文档。

注:对站点的更改在推送到 GitHub Enterprise Server 后,最长可能需要 20 分钟才会发布。

如果 Jekyll 尝试构建站点但遇到错误,您将收到一条构建错误消息。 Jekyll 构建错误消息有两种主要类型。

  • “Page build warning(页面构建警告)”消息表示构建已成功完成,但您可能需要进行更改以防止将来出现问题。
  • “Page build failed(页面构建失败)”消息表示构建未能完成。 如果 Jekyll 能够检测到失败的原因,您将看到描述性错误消息。

有关排查构建错误的更多信息,请参阅“关于 GitHub Pages 站点的 Jekyll 构建错误疑难排解”。

查看 Jekyll 构建错误消息

我们建议在本地测试您的站点,这样您可以在命令行上看到构建错误消息,并在更改推送到 GitHub Enterprise Server 之前解决任何构建失败。 更多信息请参阅“使用 Jekyll 在本地测试 GitHub Pages 站点”。

创建拉取请求以更新您在 GitHub Enterprise Server 上的发布源时,您可以在拉取请求的 Checks(检查)选项卡上看到构建错误消息。 更多信息请参阅“关于状态检查”。

将更改推送到您在 GitHub Enterprise Server 上的发布源时,GitHub Pages 将尝试构建您的站点。 如果构建失败,您将在您的主要电子邮件地址收到一封电子邮件。 您还将收到关于构建警告的电子邮件。

如果在 your GitHub Enterprise Server instance 上启用了出站电子邮件支持,您将只收到电子邮件。 更多信息请联系站点管理员。

您可以在 GitHub Enterprise Server 上站点仓库的 Settings(设置)选项卡中查看构建失败(而不是构建警告)。

您可以配置第三方服务(例如 Travis CI)以在每次提交后显示错误消息。

  1. 如果尚未在发布源的根目录中添加名为 Gemfile、包含以下内容的文件,请添加:

    source `https://rubygems.org`
    gem `github-pages`
    
  2. 为您选择的测试服务配置站点仓库。 例如,要使用 Travis CI,请在发布源的根目录下添加一个名为 .travis.yml、包含以下内容的文件:

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. 您可能需要使用第三方测试服务激活仓库。 更多信息请参阅测试服务的文档。