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

查看 Jekyll 构建错误消息

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

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

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

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

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

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

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

您可以在 GitHub 页面 站点的仓库设置中查看 Jekyll 构建失败消息。

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

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

    仓库设置按钮

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

    带有构建错误的页面框

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

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

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

要在命令行中查看所有 Jekyll 构建错误消息,必须在计算机上本地设置 Jekyll 站点。有关更多详细信息,请参阅“使用 Jekyll 在本地设置 GitHub Pages 站点”。 如果在推送到 GitHub 后页面未构建,请参阅“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 文件以避免潜在的冲突。

问问别人

找不到要找的内容?

联系我们