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

About Jekyll build errors for GitHub Pages sites

If Jekyll encounters an error building your GitHub 页面 site locally or on GitHub, you'll receive an error message with more information.

GitHub 页面 可用于具有 GitHub Free 的公共仓库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有仓库。更多信息请参阅“GitHub 的产品。”

本文内容

About Jekyll build errors

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

Note: It can take up to 20 minutes for changes to your site to publish after you push the changes to GitHub.

If Jekyll does attempt to build your site and encounters an error, you will receive a build error message. Jekyll 构建错误消息有两种主要类型。

For more information about troubleshooting build errors, see "Troubleshooting Jekyll build errors for GitHub 页面 sites."

查看 Jekyll 构建错误消息

We recommend testing your site locally, which allows you to see build error messages on the command line, and addressing any build failures before pushing changes to GitHub. For more information, see "Testing your GitHub 页面 site locally with Jekyll."

When you create a pull request to update your publishing source on GitHub, you can see build error messages on the Checks tab of the pull request. 更多信息请参阅“关于状态检查”。

When you push changes to your publishing source on GitHub, GitHub 页面 will attempt to build your site. If the build fails, you'll receive an email at your primary email address. You'll also receive emails for build warnings.

You can see build failures (but not build warnings) for your site on GitHub in the Settings tab of your site's repository.

You can configure a third-party service, such as Travis CI, to display error messages after each commit.

  1. If you haven't already, add a file called Gemfile in the root of your publishing source, with the following content:

    source `https:/rubygems.org`
    gem `github-pages`
  2. Configure your site's repository for the testing service of your choice. For example, to use Travis CI, add a file named .travis.yml in the root of your publishing source, with the following content:

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
  3. You may need to activate your repository with the third-party testing service. For more information, see your testing service's documentation.

问问别人

找不到要找的内容?

联系我们