Solucionar problemas de errores de compilación de Jekyll para sitios de Páginas de GitHub

Puedes usar los mensajes de error de compilación de Jekyll para solucionar los problemas de tu sitio de GitHub Pages.

¿Quién puede utilizar esta característica?

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. Para más información, consulta Planes de GitHub.

GitHub Pages ahora usan GitHub Actions para ejecutar la compilación de Jekyll. Al usar una rama como origen de la compilación, se deben habilitar GitHub Actions en el repositorio si deseas usar el flujo de trabajo integrado de Jekyll. Como alternativa, si no están disponibles o se han deshabilitado GitHub Actions, agregar un archivo .nojekyll a la raíz de la rama de origen omitirá el proceso de compilación de Jekyll e implementará el contenido directamente. Para más información sobre la habilitación de GitHub Actions, consulta Administrar los ajustes de las GitHub Actions de un repositorio.

En este artículo

Solucionar problemas de errores de compilación

Si Jekyll encuentra un error al compilar tu sitio de GitHub Pages localmente o en GitHub, puede usar los mensajes de error para solucionar los problemas. Para más información sobre los mensajes de error y cómo verlos, consulta Acerca de los errores de compilación para sitios de Páginas de GitHub.

Si recibiste un mensaje de error genérico, revisa los problemas comunes.

  • Estás usando plugins no compatibles. Para más información, consulta Acerca de las Páginas de GitHub y Jekyll
  • Tu repositorio ha excedido nuestros límites de tamaño del repositorio. Para más información, consulta Acerca de los archivos grandes en GitHub
  • Has cambiado el valor de configuración source en el archivo _config.yml. Si publica el sitio desde una rama, GitHub Pages reemplaza este parámetro durante el proceso de compilación.
  • Un nombre de archivo en tus archivos publicados contiene dos puntos (:), los cuales no se admiten.

Si recibiste un mensaje de error específico, revisa la información de solución de problemas para el mensaje de error que aparece a continuación.

Después de corregir los errores, desencadene otra compilación insertando los cambios en la rama de origen del sitio (si está publicando desde una rama) o desencadenando el flujo de trabajo personalizado GitHub Actions (si está publicando con GitHub Actions).

Error de archivo de configuración

Este error significa que el sitio no se pudo compilar porque el archivo _config.yml contiene errores de sintaxis.

Para solucionar el problema, asegúrate de que el archivo _config.yml sigue estas reglas:

  • Utiliza espacios en vez de tabulaciones.
  • Incluya un espacio después de : para cada par clave-valor, como timezone: Africa/Nairobi.
  • Utiliza únicamente caracteres con codificación UTF-8.
  • No puede contener caracteres especiales, como : o title: "my awesome site: an adventure in parse errors".
  • En el caso de los valores de varias líneas, use | para crear líneas y > para omitir las líneas nuevas.

Para identificar los errores, puedes copiar y pegar el contenido del archivo YAML en un linter YAML, como el validador YAML.

Note

If your repository contains symbolic links, you will need to publish your site using a GitHub Actions workflow. For more information about GitHub Actions, see