Skip to main content
Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

About Jekyll build errors for GitHub Pages sites

If Jekyll encounters an error building your Páginas de GitHub site locally or on GitHub, you'll receive an error message with more information.

Páginas de GitHub se encuentra disponible en los repositorios públicos con GitHub Free y con GitHub Free para las organizaciones, y en los repositorios públicos y privados con GitHub Pro, GitHub Team, Nube de GitHub Enterprise, y GitHub Enterprise Server. Para obtener más información, consulta la sección "Productos de GitHub".

About Jekyll build errors

Sometimes, Páginas de GitHub will not attempt to build your site after you push changes to your site's publishing source.

  • The person who pushed the changes hasn't verified their email address. For more information, see "Verifying your email address."
  • You're pushing with a deploy key. If you want to automate pushes to your site's repository, you can set up a machine user instead. For more information, see "Managing deploy keys."
  • You're using a CI service that isn't configured to build your publishing source. For example, Travis CI won't build the gh-pages branch unless you add the branch to a safe list. For more information, see "Customizing the build" on Travis CI, or your CI service's documentation.

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. There are two main types of Jekyll build error messages.

  • A "Page build warning" message means your build completed successfully, but you may need to make changes to prevent future problems.
  • A "Page build failed" message means your build failed to complete. If Jekyll is able to detect a reason for the failure, you'll see a descriptive error message.

For more information about troubleshooting build errors, see "Troubleshooting Jekyll build errors for Páginas de GitHub sites."

Viewing Jekyll build error messages with GitHub Actions

By default, your Páginas de GitHub site is built and deployed with a GitHub Actions workflow run unless you've configured your Páginas de GitHub site to use a different CI tool. To find potential build errors, you can check the workflow run for your Páginas de GitHub site by reviewing your repository's workflow runs. For more information, see "Viewing workflow run history." For more information about how to re-run the workflow in case of an error, see "Re-running workflows and jobs."

Nota: El flujo de GitHub Actions que se ejecuta para tus sitios de Páginas de GitHub se encuentra en beta público para los repositorios públicos y está sujeto a cambios. Los flujos de trabajo de GitHub Actions son gratuitos para los repositorios públicos.

Viewing your repository's build failures on GitHub

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

Viewing Jekyll build error messages locally

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 Páginas de GitHub site locally with Jekyll."

Viewing Jekyll build error messages in your pull request

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. For more information, see "About status checks."

Viewing Jekyll build errors by email

When you push changes to your publishing source on GitHub, Páginas de 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.

Viewing Jekyll build error messages in your pull request with a third-party CI service

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.