Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

À propos des erreurs de build Jekyll pour les sites GitHub Pages

Si Jekyll rencontre une erreur lors de la génération de votre site GitHub Pages en local ou sur GitHub Enterprise Server, vous recevez un message d’erreur avec davantage d’informations.

GitHub Pages est disponible dans les dépôts publics avec GitHub Free et GitHub Free pour les organisations, et dans les dépôts publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server.

À propos des erreurs de build Jekyll

Parfois, GitHub Pages ne tente pas de générer votre site après que vous avez poussé vos changements vers la source de publication de votre site.

  • Vous poussez avec une clé de déploiement. Si vous souhaitez automatiser les poussées vers le dépôt de votre site, vous pouvez configurer un utilisateur d’ordinateur à la place. Pour plus d’informations, consultez « Gestion des clés de déploiement ».
  • Vous utilisez un service CI qui n’est pas configuré pour générer votre source de publication. Par exemple, Travis CI ne génère pas la branche gh-pages, sauf si vous ajoutez la branche à une liste sécurisée. Pour plus d’informations, consultez « Personnalisation de la build » sur Travis CI ou la documentation de votre service CI.

Remarque : La publication des changements de votre site peut prendre jusqu’à 10 minutes après les avoir poussés vers GitHub Enterprise Server.

Si Jekyll tente de générer votre site et rencontre une erreur, vous recevez un message d’erreur de build. Il existe deux principaux types de messages d’erreur de build Jekyll.

  • Un message « Avertissement de génération de page » signifie que votre build s’est terminée correctement, mais que vous devrez peut-être apporter des changements pour éviter des problèmes à venir.
  • Un message « Échec de génération de page » signifie que votre build a échoué. Si Jekyll est en mesure de détecter une raison de l’échec, un message d’erreur descriptif s’affiche.

Pour plus d’informations sur la résolution des erreurs de build, consultez « Résolution des erreurs de build Jekyll pour les sites GitHub Pages ».

Affichage des échecs de build de votre dépôt dans GitHub Enterprise Server

Vous pouvez voir les échecs de build (mais pas les avertissements de build) pour votre site dans GitHub Enterprise Server sous l’onglet Paramètres du dépôt de votre site.

Affichage des messages d’erreur de build Jekyll en local

Nous vous recommandons de tester votre site en local, ce qui vous permet de voir les messages d’erreur de build sur la ligne de commande et de corriger les échecs de build avant de pousser les changements vers GitHub Enterprise Server. Pour plus d’informations, consultez « Test de votre site GitHub Pages localement avec Jekyll ».

Affichage des messages d’erreur de build Jekyll dans votre demande de tirage

Quand vous créez une demande de tirage pour mettre à jour votre source de publication sur GitHub Enterprise Server, vous pouvez voir des messages d’erreur de build sous l’onglet Vérifications de la demande de tirage. Pour plus d’informations, consultez « À propos des vérifications d’état ».

Affichage des erreurs de build Jekyll par e-mail

Quand vous poussez des changements vers votre source de publication sur GitHub Enterprise Server, GitHub Pages tente de générer votre site. Si la build échoue, vous recevez un e-mail dans votre adresse e-mail principale.

Vous ne recevrez qu’un e-mail si la prise en charge des e-mails sortants est activée dans your GitHub Enterprise Server instance. Pour plus d’informations, contactez votre administrateur de site.

Affichage des messages d’erreur de build Jekyll dans votre demande de tirage avec un service CI tiers

Vous pouvez configurer un service tiers, tel que Travis CI, pour afficher les messages d’erreur après chaque commit.

  1. Si ce n’est déjà fait, ajoutez un fichier appelé Gemfile à la racine de votre source de publication, avec le contenu suivant :

    source `https://rubygems.org`
    gem `github-pages`
    
  2. Configurez le dépôt de votre site pour le service de test de votre choix. Par exemple, pour utiliser Travis CI, ajoutez un fichier appelé .travis.yml à la racine de votre source de publication, avec le contenu suivant :

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. Vous devrez peut-être activer votre dépôt avec le service de test tiers. Pour plus d’informations, consultez la documentation de votre service de test.