Acerca de los errores de compilación para sitios de Páginas de GitHub

Si Jekyll encuentra un error al compilar tu sitio de GitHub Pages localmente o en GitHub, recibirás un mensaje de error con más información.

¿Quién puede utilizar esta característica?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see GitHub’s plans.

GitHub Pages now uses GitHub Actions to execute the Jekyll build. When using a branch as the source of your build, GitHub Actions must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if GitHub Actions is unavailable or disabled, adding a .nojekyll file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling GitHub Actions, see Managing GitHub Actions settings for a repository.

En este artículo

Acerca de los errores de compilación de Jekyll

En ocasiones, si publica desde una rama, GitHub Pages no intentará crear el sitio después de insertar cambios en la fuente de publicación del sitio.

  • La persona que subió los cambios no ha verificado su dirección de correo electrónico. Para más información, consulta Verificar tu dirección de correo electrónico.
  • Estás subiendo con una llave de despliegue. Si deseas automatizar las subidas al repositorio de tu sitio, puedes configurar un usuario de máquina en su lugar. Para más información, consulta Administrar las llaves de despliegue.
  • Estás usando un servicio CI que no está configurado para compilar tu fuente de publicación. Por ejemplo, Travis CI no compilará la rama gh-pages a menos que la agregue a una lista segura. Para más información, consulta Personalización de la compilación en Travis CI o en la documentación del servicio de CI.

Note

La publicación de los cambios en el sitio puede tardar hasta 10 minutos después de que se envíen a GitHub.

Si Jekyll intenta compilar tu sitio y encuentra un error, recibirás un mensaje de error de compilación.

Para más información sobre cómo solucionar errores de compilación, consulta Solucionar problemas de errores de compilación de Jekyll para sitios de Páginas de GitHub.

Ver los mensajes de error de compilación de Jekyll con las GitHub Actions

Predeterminadamente, tu sitio de GitHub Pages se compila y despliega con una ejecución de flujo de trabajo de GitHub Actions a menos de que hayas configurado tu sitio de GitHub Pages para que utilice una herramienta de IC distinta. Para encontrar errores de compilación potenciales, puedes verificar la ejecución de flujo de trabajo para tu sitio de GitHub Pages si revisas las ejecuciones de flujo de trabajo de tu repositorio. Para más información, consulta Visualizar el historial de ejecución del flujo de trabajo. Para más información sobre cómo volver a ejecutar el flujo de trabajo en caso de error, consulta Volver a ejecutar flujos de trabajo y jobs.

Ver los mensajes de error de compilación de Jekyll localmente

Recomendamos probar su sitio localmente, lo que le permite ver mensajes de error de compilación en la línea de comandos, y abordar cualquier fallo de construcción antes de presionar los cambios a GitHub. Para más información, consulta Probar tu sitio de Páginas de GitHub localmente con Jekyll.

Ver los mensajes de error de compilación de Jekyll en tu solicitud de cambios

Si publica desde una rama, al crear una solicitud de incorporación de cambios para actualizar el origen de publicación en GitHub, puede ver los mensajes de error de compilación en la pestaña Comprobaciones de la solicitud de incorporación de cambios. Para más información, consulta Acerca de las verificaciones de estado.

Si publica con un flujo de trabajo de GitHub Actions personalizado, para ver los mensajes de errores de compilación en la solicitud de incorporación de cambios, debe configurar el flujo de trabajo para que se ejecute en el desencadenador pull_request. Al hacerlo, se recomienda que omitas los pasos de implementación si el evento pull_request desencadenó el flujo de trabajo. De esta forma podrás ver los errores de compilación sin implementar los cambios de la solicitud de incorporación de cambios en el sitio. Para más información, consulta Eventos que desencadenan flujos de trabajo y Evaluación de expresiones en flujos de trabajo y acciones.

Ver los errores de compilación de Jekyll por correo electrónico

Si publica desde una rama, cuando inserte cambios en la fuente de publicación en GitHub, GitHub Pages intentará crear el sitio. Si se produce un error durante la compilación, recibirás un corro electrónico en tu dirección principal de correo electrónico.

Si publica con un flujo de trabajo de GitHub Actions personalizado, para recibir correos electrónicos sobre errores de compilación en la solicitud de incorporación de cambios, debe configurar el flujo de trabajo para que se ejecute en el desencadenador pull_request. Al hacerlo, se recomienda que omitas los pasos de implementación si el evento pull_request desencadenó el flujo de trabajo. De esta forma podrás ver los errores de compilación sin implementar los cambios de la solicitud de incorporación de cambios en el sitio. Para más información, consulta Eventos que desencadenan flujos de trabajo y Evaluación de expresiones en flujos de trabajo y acciones.

Ver los mensajes de error de compilación de Jekyll en tu solicitud de cambios con un servicio de IC de terceros

Puede configurar un servicio de terceros, como Travis CI, para mostrar mensajes de error después de cada confirmación.

  1. Si todavía no lo ha hecho, agregue un archivo denominado Gemfile en la raíz del origen de publicación, con el contenido siguiente:

    source `https://rubygems.org`
gem `github-pages`

  2. Configura el repositorio de tu sitio para el servicio de comprobación que elijas. Por ejemplo, pasa usar Travis CI, agregue un archivo denominado .travis.yml en la raíz del origen de publicación, con el contenido siguiente:

    language: ruby
rvm:
  - 2.3
script: "bundle exec jekyll build"

  3. Es posible que necesites activar tu repositorio con el servicio de comprobación de terceros. Para obtener más información, consulta la documentación del servicio de comprobación.