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.

Esta versión de GitHub Enterprise se discontinuará el Esta versión de GitHub Enterprise se discontinuó el 2020-08-20. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Versión del artículo: Enterprise Server 2.18

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

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

Páginas de GitHub se encuentra disponible en repositorios públicos con GitHub Free y GitHub Free para organizaciones, y en repositorios privados y públicos con GitHub Pro, GitHub Team, GitHub Enterprise Cloud, y GitHub Enterprise Server.

En este artículo

Acerca de los errores de compilación de Jekyll

Algunas veces, Páginas de GitHub no intentará compilar tu sitio después de que subas los cambios a la fuente de publicación de tu 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 obtener más información, consulta la sección "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 añadas la rama a una lista de seguridad. Para obtener más información, consulta "Personalizar la compilación" en Travis CI o en la documentación del servicio de CI.

Nota: Es posible que tome hasta 20 minutos la publicación de los cambios en tu sitio luego de que subes los cambios a GitHub Enterprise.

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 obtener más información sobre cómo resolver errores de compilación, consulta "Solución de problemas de errores de compilación de Jekyll para los sitios de Páginas de GitHub".

Ver mensajes de error de construcción de Jekyll

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. Para obtener más información, consulta "Verificar tu sitio de Páginas de GitHub localmente con Jekyll".

Cuando subas los cambios a tu fuente de publicación en GitHub Enterprise, Páginas de GitHub intentará compilar tu 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. También recibirás correos electrónicos para advertencias de compilación.

Solo recibiras un correo electrónico si habilitas la compatibilidad con correo externo en tu instancia de servidor de GitHub Enterprise. Para obtener más información, contacta a tu administrador de sitio.

Puedes ver errores de compilación (pero no advertencias de compilación) para tu sitio en GitHub Enterprise en la pestaña Settings (Configuración) del repositorio de tu sitio.

Puedes configurar un servicio externo como Travis CI para que muestre mensajes de error después de cada confirmación.

  1. Si no lo has hecho, agrega un archivo denominado Gemfile en la raíz de tu fuente de publicación, con el siguiente contenido:

    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, agrega un archivo denominado .travis.yml en la raíz de tu fuente de publicación, con el siguiente contenido:

    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.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos