Acerca de los errores de compilación de Jekyll para sitios de GitHub Pages

Acerca de los errores de compilación de Jekyll

Si publicas desde una rama, a veces GitHub Pages no intentará generar tu sitio después de que envíes cambios a la fuente de publicación de tu sitio.

• La persona que subió los cambios no ha verificado su dirección de correo electrónico. Para obtener más información, consulte 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 obtener más información, consulte Personalización de la compilación en Travis CI o en la documentación del servicio de CI.

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

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

Visualización de mensajes de error de compilación de Jekyll con GitHub Actions

De forma predeterminada, tu sitio GitHub Pages se compila y se despliega mediante una ejecución del flujo de trabajo GitHub Actions, a menos que hayas configurado tu sitio GitHub Pages para usar una herramienta de CI diferente. Para encontrar posibles errores de compilación, puede consultar la ejecución del flujo de trabajo de su sitio GitHub Pages revisando las ejecuciones de flujo de trabajo de su 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 tareas.

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

Se recomienda probar el sitio localmente, lo que le permite ver mensajes de error de compilación en la línea de comandos y solucionar los errores de compilación antes de insertar cambios en GitHub. Para más información, consulta Probar el sitio de GitHub Pages localmente con Jekyll.

Ver los mensajes de error de compilación de Jekyll en tu pull request

Si va a publicar desde una rama, al crear una solicitud de incorporación de cambios para actualizar el origen de publicación en GitHub, puede ver 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 usa un flujo de trabajo personalizado GitHub Actions, para ver los mensajes de error de compilación en su pull request, debe configurar el flujo de trabajo para que se ejecute con 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 del pull request en tu sitio web. 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 va a publicar desde una rama, al subir cambios a su fuente de publicación en GitHub, GitHub Pages intentará generar su 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 va a publicar con un flujo de trabajo personalizado GitHub Actions, para recibir correos electrónicos sobre los errores de compilación en la solicitud de incorporación de cambios, debe configurar el flujo de trabajo para que se ejecute con 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 del pull request en tu sitio web. 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, para usar Travis CI, deberá agregar 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.