查看 Jekyll 构建错误消息
您可以通过电子邮件、在仓库中、在命令行中或通过每次提交后显示错误消息的第三方服务查看 Jekyll 构建错误消息。
Jekyll 构建错误消息有两种主要类型。
“Page build warning(页面构建警告)”- 您的构建完成得还好,但有些情况我们认为应该让您知道。
“Page build failed(页面构建失败)”- 您的构建无法完成。 如果我们能够检测到特定错误,我们将向您发送描述性错误消息,其中包含指向支持文档的链接。 如果我们无法检测到页面构建失败的特定错误,则您将收到一个通用的“page build failed(页面构建失败)”错误消息。
通过电子邮件查看 Jekyll 构建错误消息
如果您已设置电子邮件,则可以通过电子邮件查看所有 Jekyll 构建错误消息。 要添加新电子邮件地址或验证旧电子邮件,请参阅“更改主电子邮件地址”。
在仓库中查看 Jekyll 构建失败消息
您可以在 GitHub 页面 站点的仓库设置中查看 Jekyll 构建失败消息。
-
在 GitHub Enterprise 上,导航到仓库的主页面。
-
在仓库名称下,单击 Settings(设置)。
-
在 您的 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)以在每次提交后显示错误消息。
- 将名为 Gemfile(请注意,"G" 必须为大写)的文件添加到 GitHub 页面 仓库的根目录,其中含有以下内容:
source 'https://rubygems.org'
gem 'github-pages'
- 配置 GitHub 页面 仓库用于您选择的测试服务。 例如,要设置 Travis CI,将名为 .travis.yml 的文件添加到 GitHub 页面 仓库的根目录,其中含有以下内容:
language: ruby
rvm:
- 2.1
script: "bundle exec jekyll build"
- 您可能需要在第三方测试服务内激活 GitHub 页面 仓库。 对于 Travis,在 Travis CI 配置文件页面上执行此操作。
如果将提供的 gems 放入 vendor 文件夹(或 CI 服务,如 Travis 已为您完成的那样),请确保将 exclude: ["vendor"]
添加到 _config.yml 文件以避免潜在的冲突。