Skip to main content

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 Enterprise Server, recibirás un mensaje de error con más información.

GitHub Pages 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, GitHub Enterprise Cloud, y GitHub Enterprise Server.

Acerca de los errores de compilación de Jekyll

Sometimes,,GitHub Pages no intentará crear el sitio después de insertar cambios en la fuente de publicación del sitio.

  • 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, vea "Administración de claves de implementación".
  • 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, vea "Personalización de la compilación" en Travis CI o en la documentación del servicio de CI.

Nota: Es posible que la publicación de los cambios en el sitio tome hasta 10 minutos después de que envíes los cambios a GitHub Enterprise Server.

Si Jekyll intenta compilar tu sitio y encuentra un error, recibirás un mensaje de error de compilación. Hay dos tipos principales de mensajes de error de construcción de Jekyll.

  • Un mensaje de "Aviso de compilación de página" significa que la compilación se ha completado correctamente, pero es posible que debas hacer cambios para prevenir problemas futuros.
  • Un mensaje "Page build failed" (Falló la construcción de página) significa que no se pudo completar la compilación. Si Jekyll puede detectar el motivo de la falla, verás un mensaje de error descriptivo.

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

Ver los fallos de compilación de tu repositorio en GitHub Enterprise Server

Puede ver los errores de compilación (pero no las advertencias de compilación) para el sitio en GitHub Enterprise Server en la pestaña Configuración del repositorio del sitio.

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 Enterprise Server. Para obtener más información, vea "Probar tu sitio de GitHub Pages localmente con Jekyll".

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

When crea una solicitud de incorporación de cambios para actualizar la fuente de publicación en GitHub Enterprise Server, puedes 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, vea "Acerca de las comprobaciones de estado".

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

When inserte cambios en la fuente de publicación en GitHub Enterprise Server, 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.

You will only receive an email if outbound email support is enabled on your GitHub Enterprise Server instance. For more information, contact your site administrator.

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.