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

此版本的 GitHub Enterprise 将停止服务 此版本的 GitHub Enterprise 已停止服务 2019-10-16. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

查看 Jekyll 构建错误消息

您可以通过电子邮件、在仓库中、在命令行中或通过每次提交后显示错误消息的第三方服务查看 Jekyll 构建错误消息。

Jekyll 构建错误消息有两种主要类型。

“Page build warning(页面构建警告)”- 您的构建完成得还好,但有些情况我们认为应该让您知道。

“Page build failed(页面构建失败)”- 您的构建无法完成。 如果我们能够检测到特定错误,我们将向您发送描述性错误消息,其中包含指向支持文档的链接。 如果我们无法检测到页面构建失败的特定错误,则您将收到一个通用的“page build failed(页面构建失败)”错误消息。

通过电子邮件查看 Jekyll 构建错误消息

如果您已设置电子邮件,则可以通过电子邮件查看所有 Jekyll 构建错误消息。 要添加新电子邮件地址或验证旧电子邮件,请参阅“更改主电子邮件地址”。

在仓库中查看 Jekyll 构建失败消息

You can view Jekyll build failure messages for your published site in the repository settings of your GitHub 页面 site.

  1. 在 GitHub Enterprise 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Settings(设置)

    仓库设置按钮

  3. 在 您的 GitHub Enterprise Server 实例 下,您可以看到当前 Jekyll 构建失败消息。

    带有构建错误的页面框

注:页面构建警告不会在仓库设置中显示。

在命令行中查看 Jekyll 构建错误消息

提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”

要在命令行中查看所有 Jekyll 构建错误消息,必须在计算机上本地设置 Jekyll 站点。有关更多详细信息,请参阅“使用 Jekyll 在本地设置 GitHub Enterprise Pages 站点”。 如果在推送到 您的 GitHub Enterprise Server 实例 后页面未构建,请参阅“GitHub Pages 构建故障排除”。

配置第三方服务以显示 Jekyll 构建错误消息

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

source 'https://rubygems.org'

gem 'github-pages'
language: ruby
rvm:
- 2.1
script: "bundle exec jekyll build"

如果将提供的 gems 放入 vendor 文件夹(或 CI 服务,如 Travis 已为您完成的那样),请确保将 exclude: ["vendor"] 添加到 _config.yml 文件以避免潜在的冲突。

问问别人

找不到要找的内容?

联系我们