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.
GitHub AE is currently under limited release.

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.

GitHub Pages est disponible dans les dépôts internes et privés avec GitHub AE. 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.

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

Les changements de votre site sont publiés automatiquement quand ils sont fusionnés dans la source de publication de votre site. Si vous voulez d’abord afficher un aperçu de vos changements, vous pouvez faire les changements localement au lieu de les faire sur GitHub AE. Ensuite, testez votre site localement. Pour plus d’informations, consultez « Test de votre site GitHub Pages localement avec Jekyll ».

Ajout d’un thème

  1. Dans GitHub AE, accédez au dépôt de votre site. 1. 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 ».

  2. Accédez à _config.yml.

  3. Dans le coin supérieur droit de l’affichage du fichier, cliquez sur pour ouvrir l’éditeur de fichier.

    Bouton Modifier le fichier

  4. 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 README du dépôt du thème. Pour obtenir la liste des thèmes pris en charge, consultez « Thèmes pris en charge » sur le site GitHub Pages. Thème pris en charge dans le fichier de configuration
    • 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. Thème non pris en charge dans le fichier de configuration 1. En bas de la page, tapez un message de validation court et explicite décrivant 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’une validation avec plusieurs auteurs ». Message de validation pour votre modification 1. 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 « Si vous voulez créer une branche pour votre demande de tirage et que vous n’avez pas d’autorisations d’accès en écriture au dépôt, vous pouvez commencer par dupliquer (fork) le dépôt. ». Options de commit dans une branche 1. Sélectionnez Proposer un changement de fichier. Bouton Proposer un changement de fichier

Personnalisation du CSS de votre thème

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

  1. Dans GitHub AE, accédez au dépôt de votre site. 1. 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 ».

  2. Créez un fichier appelé /assets/css/style.scss.

  3. Ajoutez le contenu suivant au début du fichier :

    ---
    ---
    
    @import "{{ site.theme }}";
    
  4. 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

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

  1. Sur GitHub, accédez au dépôt source de votre thème. Par exemple, le dépôt source pour Minima est https://github.com/jekyll/minima.
  2. Dans le dossier _layouts, accédez au fichier default.html de votre thème.
  3. Copiez le contenu du fichier.
  4. Dans GitHub AE, accédez au dépôt de votre site. 1. 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 ».
  5. Créez un fichier appelé _layouts/default.html.
  6. Collez le contenu de disposition par défaut que vous avez copié précédemment.
  7. Personnalisez la disposition comme vous le souhaitez.

Pour aller plus loin