Ajout d’un thème à votre site GitHub Pages à l’aide de Jekyll

Remarque

Bien que la gemme github-pages soit toujours pris en charge pour certains workflows, GitHub Actions est désormais l'approche recommandée pour déployer et automatiser les sites GitHub Pages.

Les personnes disposant d’autorisations en écriture sur un dépôt peuvent ajouter un thème à un site GitHub Pages avec Jekyll.

Si vous publiez à partir d'une branche, les modifications apportées à votre site sont publiées automatiquement lorsqu'elles sont fusionnées dans la source de publication de votre site. Si vous publiez à partir d'un flux de travail personnalisé GitHub Actions, les modifications sont publiées chaque fois que votre flux de travail est déclenché (généralement par une poussée vers la branche par défaut). Si vous souhaitez prévisualiser vos modifications, vous pouvez les effectuer localement plutôt que sur GitHub. Ensuite, testez votre site localement. Pour plus d’informations, consultez « Test de votre site GitHub Pages localement avec Jekyll ».

Thèmes pris en charge

Les thèmes suivants sont pris en charge dès l’installation :

Architect
Cayman
Dinky
Hacker
Jour bissextile
Merlot
Midnight
Minima

          [Minimal](https://github.com/pages-themes/minimal)

Modernist
Slate
Tactile
Machine à voyager dans le temps

Le plug-in Jekyll jekyll-remote-theme est également disponible et vous permet de charger d’autres thèmes.

Ajout d’un thème

Dans GitHub, accédez au dépôt de votre site.
Accédez à la source de publication pour votre site. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ».
Accédez à _config.yml.
En haut à droite de la vue de fichier, cliquez sur pour ouvrir l’éditeur de fichier.

Remarque

Au lieu d'éditer et de valider le fichier en utilisant l'éditeur de fichiers par défaut, vous pouvez choisir d'utiliser l'éditeur de code de github.dev en sélectionnant le menu déroulant et en cliquant sur github.dev. Vous pouvez également cloner le référentiel et modifier le fichier localement via GitHub Desktop en cliquant sur GitHub Desktop .
Ajoutez une nouvelle ligne au fichier pour le nom du thème.
- Pour utiliser un thème pris en charge, tapez theme: THEME-NAME, en remplaçant THEME-NAME par le nom du thème tel qu’il apparaît dans le _config.yml du référentiel thème (la plupart des thèmes suivent une convention d’affectation de noms jekyll-theme-NAME). Pour obtenir la liste des thèmes pris en charge, consultez Thèmes pris en charge sur le site GitHub Pages. Par exemple, pour sélectionner le thème Minimal, tapez theme: jekyll-theme-minimal.
- Pour utiliser n’importe quel autre thème Jekyll hébergé sur GitHub, tapez remote_theme: THEME-NAME, en remplaçant THEME-NAME par le nom du thème tel qu’il apparaît dans le README du dépôt du thème.
Cliquez sur Commiter les changements.
Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d'un commit avec plusieurs auteurs ».
Si vous avez plusieurs adresses e-mail associées à votre compte sur GitHub, cliquez sur le menu déroulant d’adresses e-mail et sélectionnez l’adresse e-mail à utiliser comme adresse e-mail de l’auteur Git. Seules les adresses e-mail vérifiées apparaissent dans ce menu déroulant. Si vous avez activé la confidentialité de l’adresse e-mail, le mode sans réponse sera utilisé par défaut pour l’adresse e-mail de l’auteur de commit. Pour plus d’informations sur la forme exacte que l’adresse e-mail sans réponse peut prendre, consultez Définition de votre adresse e-mail de commit.
Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une pull request ».
Cliquez sur Valider les modifications ou Proposer des modifications.

Personnalisation du CSS de votre thème

Ces instructions fonctionnent mieux avec les thèmes officiellement pris en charge par GitHub Pages. Pour obtenir la liste complète des thèmes pris en charge, consultez Thèmes pris en charge sur le site GitHub Pages.

Le référentiel source de votre thème peut offrir de l’aide pour personnaliser votre thème. Par exemple, consultez le README de Minimal.

Dans GitHub, accédez au dépôt de votre site.
Accédez à la source de publication pour votre site. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ».
Créez un fichier nommé /assets/css/style.scss.
Ajoutez le contenu suivant au début du fichier :
```
---
---

@import "{{ site.theme }}";
```
Ajoutez n’importe quel CSS ou Sass personnalisé (y compris les importations) de votre choix juste en dessous de la ligne @import.

Personnalisation de la disposition HTML de votre thème