Résolution des erreurs de build Jekyll pour les sites GitHub Pages

Résolution des erreurs de build

Si Jekyll rencontre une erreur lors de la construction de votre site GitHub Pages localement ou sur GitHub, vous pouvez utiliser les messages d'erreur pour résoudre le problème. Pour plus d’informations sur les messages d’erreur et comment les afficher, consultez À propos des erreurs de build Jekyll pour les sites GitHub Pages.

Si vous avez reçu un message d’erreur générique, recherchez les problèmes courants.

• Vous utilisez des plug-ins non pris en charge. Pour plus d’informations, consultez À propos de GitHub Pages et Jekyll.
• Votre dépôt a dépassé nos limites de taille de dépôt. Pour plus d’informations, consultez À propos des fichiers volumineux sur GitHub
• Vous avez changé le paramètre source dans votre fichier _config.yml. Si vous publiez votre site à partir d’une branche, GitHub Pages remplace ce paramètre pendant le processus de génération.
• Un nom de fichier dans vos fichiers publiés contient un signe deux-points (:) qui n’est pas pris en charge.

Si vous avez reçu un message d’erreur spécifique, consultez les informations de dépannage pour le message d’erreur ci-dessous.

Une fois que vous avez corrigé les erreurs, déclenchez une autre version en poussant les modifications apportées à la branche source de votre site (si vous publiez à partir d’une branche) ou en déclenchant votre workflow GitHub Actions personnalisé (si vous publiez avec GitHub Actions).

Erreur dans le fichier de configuration

Cette erreur signifie que votre site n’a pas pu être généré, car le fichier _config.yml contient des erreurs de syntaxe.

Pour les résoudre, vérifiez que votre fichier _config.yml respecte les règles suivantes :

• Utilisez des espaces plutôt que des onglets.
• Ajoutez un espace après les : pour chaque paire clé-valeur, par exemple timezone: Africa/Nairobi.
• Utilisez uniquement des caractères UTF-8.
• Mettez entre guillemets les caractères spéciaux comme :, par exemple title: "my awesome site: an adventure in parse errors".
• Pour les valeurs multilignes, utilisez | pour créer des nouvelles lignes et > pour ignorer les nouvelles lignes.

Pour identifier les erreurs, vous pouvez copier et coller le contenu de votre fichier YAML dans un linter YAML, comme YAML Validator.

La date n’est pas valide

Cette erreur signifie qu’une des pages de votre site contient une date non valide.

Pour la résoudre, recherchez dans le fichier du message d’erreur et les dispositions du fichier les appels à tous les filtres Liquid associés à la date. Assurez-vous que toutes les variables passées dans les filtres Liquid associés à la date ont des valeurs dans tous les cas et ne passent jamais nil ou "". Pour plus d'informations, voir Filtres dans la documentation de Liquid.

Le fichier n’existe pas dans le répertoire includes

Cette erreur signifie que votre code référence un fichier qui n’existe pas dans votre répertoire _includes.

Pour la résolution, recherchez include dans le fichier du message d’erreur pour voir où vous avez référencé d’autres fichiers comme {% include example_header.html %}. Si des fichiers que vous avez référencés ne se trouvent pas dans le répertoire _includes, copiez ou déplacez les fichiers dans le répertoire _includes.

Le fichier n’est pas correctement codé UTF-8

Cette erreur signifie que vous avez utilisé des caractères non latins, comme 日本語, sans indiquer à l’ordinateur de s’attendre à ces symboles.

Pour la résoudre, forcez l’encodage UTF-8 en ajoutant la ligne suivante à votre fichier _config.yml :

encoding: UTF-8

Langage de colorateur non valide

Cette erreur signifie que vous avez spécifié un colorateur de syntaxe autre que Rouge ou Pygments dans votre fichier de configuration.

Pour la résoudre, mettez à jour votre fichier _config.yml pour spécifier Rouge ou Pygments. Pour plus d’informations, consultez « À propos de GitHub Pages et Jekyll ».

Date de publication non valide

Cette erreur signifie qu’une publication sur votre site contient une date non valide dans le nom de fichier ou l’en-tête YAML.

Pour la résoudre, assurez-vous que toutes les dates sont au format AAAA-MM-JJ HH:MM:SS pour UTC et qu’elles sont issues d’un vrai calendrier. Pour spécifier un fuseau horaire avec un décalage par rapport à UTC, utilisez le format AAAA-MM-DD HH:MM:MM:SS +/-TTTT, comme 2014-04-18 11:30:00 +0800.

Si vous spécifiez un format de date dans votre fichier _config.yml, vérifiez que le format est correct.

Sass ou SCSS non valide

Cette erreur signifie que votre dépôt contient un fichier SAss ou SCSS avec du contenu non valide.

Pour la résoudre, vérifiez le numéro de ligne compris dans le message d’erreur pour trouver le fichier Sass ou SCSS non valide. Pour éviter de nouvelles erreurs, installez un linter Sass ou SCSS pour votre éditeur de texte favori.

Sous-module non valide

Cette erreur signifie que votre dépôt comprend un sous-module qui n’a pas été correctement initialisé.

Pour résoudre les problèmes, commencez par décider si vous voulez utiliser un sous-module, qui est un projet Git à l’intérieur d’un projet Git. Les sous-modules sont parfois créés accidentellement.

Si vous ne voulez pas utiliser de sous-module, supprimez le sous-module, en remplaçant PATH-TO-SUBMODULE par le chemin du sous-module :

git submodule deinit PATH-TO-SUBMODULE
git rm PATH-TO-SUBMODULE
git commit -m "Remove submodule"
rm -rf .git/modules/PATH-TO-SUBMODULE

Si vous souhaitez utiliser le sous-module, assurez-vous d’utiliser https:// lors du référencement du sous-module (non http://) et que le sous-module est dans un dépôt public.