Configuration d’un site GitHub Pages avec Jekyll
Vous pouvez utiliser Jekyll, générateur de site statique populaire, pour personnaliser davantage votre site GitHub Pages.
Qui peut utiliser cette fonctionnalité ?
GitHub Pages est disponible dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, et dans les référentiels publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server. Pour plus d’informations, consultez « Plans de GitHub ».
GitHub Pages utilise désormais GitHub Actions pour exécuter la version de Jekyll. Lorsque vous utilisez une branche comme source de votre version, GitHub Actions doit être activé dans votre référentiel si vous souhaitez utiliser le flux de travail Jekyll prédéfini. Comme alternative, si GitHub Actions n’est pas disponible ou désactivé, l’ajout d’un fichier .nojekyll
à la racine de votre branche source contournera le processus de version de Jekyll et déploiera le contenu directement. Pour plus d'informations sur l'activation des GitHub Actions, consultez « Gestion des paramètres de GitHub Actions pour un dépôt ».
À propos de GitHub Pages et Jekyll
Jekyll est un générateur de site statique avec une prise en charge intégrée de GitHub Pages.
Création d’un site GitHub Pages avec Jekyll
Vous pouvez utiliser Jekyll pour créer un site GitHub Pages dans un dépôt nouveau ou existant.
Test de votre site GitHub Pages localement avec Jekyll
Vous pouvez créer votre site GitHub Pages localement pour en afficher un aperçu et tester les modifications que vous y apportez.
Ajout d’un thème à votre site GitHub Pages avec Jekyll
Vous pouvez ajouter une nouvelle page ou publier sur votre site Jekyll sur GitHub Pages.
Définition d’un processeur Markdown pour votre site GitHub Pages avec Jekyll
Vous pouvez choisir un processeur Markdown pour déterminer comment Markdown est rendu sur votre site GitHub Pages.
Ajout d’un thème à votre site GitHub Pages avec Jekyll
Vous pouvez personnaliser votre site Jekyll en ajoutant et en personnalisant un thème.
À 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, vous recevez un message d’erreur avec davantage d’informations.
Résolution des erreurs de build Jekyll pour les sites GitHub Pages
Vous pouvez utiliser les messages d’erreur de build Jekyll pour résoudre les problèmes liés à votre site GitHub Pages.