Skip to main content

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.

Who can use this feature

People with admin permissions for a repository can create a GitHub Pages site with Jekyll.

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. Pour plus d’informations, consultez « Produits de GitHub ».

Remarque : Les propriétaires de l’organisation peuvent restreindre la publication de sites GitHub Pages des dépôts appartenant à l’organisation. Pour plus d’informations, consultez « Gestion de la publication de sites GitHub Pages. »

Prérequis

Avant de pouvoir utiliser Jekyll pour créer un site GitHub Pages, vous devez installer Jekyll et Git. Pour plus d’informations, consultez Installation dans la documentation de Jekyll et « Configurer Git ».

Nous vous recommandons d’utiliser Bundler pour installer et exécuter Jekyll. Bundler gère les dépendances de gemme Ruby, réduit les erreurs de build Jekyll et empêche les bogues liés à l’environnement. Pour installer Bundler :

  1. Installer Ruby Pour plus d’informations, consultez « Installation de Ruby » dans la documentation de Ruby.
  2. Installez Bundler. Pour plus d’informations, consultez « Bundler ».

Conseil : Si vous voyez une erreur Ruby lorsque vous essayez d’installer Jekyll à l’aide de Bundler, vous devrez peut-être utiliser un gestionnaire de package, tel que RVM ou Homebrew, pour gérer votre installation Ruby. Pour plus d’informations, consultez « Résolution des problèmes » dans la documentation de Jekyll.

Création d’un dépôt pour votre site

Vous pouvez créer un dépôt ou choisir un dépôt existant pour votre site.

Si vous souhaitez créer un site GitHub Pages pour un dépôt où les fichiers du dépôt ne sont tous pas liés au site, vous pouvez configurer une source de publication pour votre site. Par exemple, vous pouvez avoir une branche et un dossier dédiés pour conserver les fichiers sources de votre site, ou vous pouvez utiliser un workflow GitHub Actions personnalisé pour générer et déployer les fichiers sources de votre site.

Si le compte propriétaire du dépôt utilise GitHub Free ou GitHub Free pour les organisations, le dépôt doit être public.

Si vous souhaitez créer un site dans un dépôt existant, passez à la section « Création de votre site ».

  1. En haut à droite d’une page, utilisez le menu déroulant et sélectionnez Nouveau dépôt. Menu déroulant avec l’option pour créer un dépôt 1. Utilisez le menu déroulant Propriétaire, puis sélectionnez le compte qui doit posséder le dépôt. Menu déroulant Propriétaire
    Remarque : si vous êtes un managed user account, vous pouvez uniquement publier des sites GitHub Pages à partir de référentiels appartenant à des organisations. Pour plus d’informations, consultez « À propos de GitHub Pages ».
    1. Tapez un nom pour votre référentiel et une description facultative. Si vous créez un utilisateur ou un site d’organisation, votre référentiel doit être nommé `.github.io` ou `.github.io`. Si votre nom d’utilisateur ou d’organisation contient des lettres majuscules, vous devez mettre les lettres en minuscules. Pour plus d’informations, consultez « [À propos de GitHub Pages](/articles/about-github-pages#types-of-github-pages-sites) ». ![Champ de création de dépôt](/assets/images/help/pages/create-repository-name-pages.png) 1. Choisissez une visibilité de dépôt. Pour plus d’informations, consultez « [À propos des dépôts](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility) ». ![Cases d’option pour sélectionner la visibilité des dépôts](/assets/images/help/repository/create-repository-public-private.png)

Création de votre site

Pour pouvoir créer votre site, vous devez avoir un dépôt pour votre site sur GitHub Enterprise Cloud. Si vous ne créez pas votre site dans un dépôt existant, consultez « Création d’un dépôt pour votre site ».

Avertissement : sauf si votre entreprise utilise Enterprise Managed Users, les sites GitHub Pages sont disponibles publiquement sur Internet par défaut, même si leur dépôt est privé ou interne. Vous pouvez publier un site en privé en gérant le contrôle d’accès à celui-ci. Autrement, si vous avez des données sensibles dans le dépôt de votre site, vous pouvez les supprimer avant publication. Pour plus d’informations, consultez «  À propos des dépôts » et « Modification de la visibilité de votre site GitHub Pages ».

  1. Ouvrez TerminalTerminalGit Bash.

  2. Si vous n’avez pas encore de copie locale de votre dépôt, accédez à l’emplacement où vous souhaitez stocker les fichiers sources de votre site, en remplaçant PARENT-FOLDER par le dossier qui contiendra le dossier pour votre dépôt.

    $ cd PARENT-FOLDER
  3. Si vous ne l’avez pas déjà fait, initialisez un dépôt Git local, en remplaçant REPOSITORY-NAME par le nom de votre dépôt.

    $ git init REPOSITORY-NAME
    > Initialized empty Git repository in /Users/octocat/my-site/.git/
    # Creates a new folder on your computer, initialized as a Git repository
  4. Changez de répertoire dans le dépôt.

    $ cd REPOSITORY-NAME
    # Changes the working directory
  5. Déterminez la source de publication que vous souhaitez utiliser. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ». 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 ». Par exemple, si vous avez choisi de publier votre site à partir du dossier docs de la branche par défaut, créez et changez de répertoire dans le dossier docs.

    $ mkdir docs
    # Creates a new folder called docs
    $ cd docs

    Si vous avez choisi de publier votre site à partir de la branche gh-pages, créez et extrayez la branche gh-pages.

    $ git checkout --orphan gh-pages
    # Creates a new branch, with no history or contents, called gh-pages, and switches to the gh-pages branch
    $ git rm -rf .
    # Removes the contents from your default branch from the working directory
  6. Pour créer un site Jekyll, utilisez la commande jekyll new :

    $ jekyll new --skip-bundle .
    # Creates a Jekyll site in the current directory
  7. Ouvrez le Gemfile créé par Jekyll.

  8. Ajoutez « # » au début de la ligne qui commence par gem "jekyll" pour commenter cette ligne.

  9. Ajoutez la gemme github-pages en modifiant la ligne commençant par # gem "github-pages". Remplacez cette ligne par :

    gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins

    Remplacez GITHUB-PAGES-VERSION par la dernière version prise en charge de la gemme github-pages. Vous trouverez cette version ici : « Versions de dépendances ».

    La bonne version de Jekyll est installée en tant que dépendance de la gemme github-pages.

  10. Enregistrez et fermez le Gemfile.

  11. À partir de la ligne de commande, exécutez bundle install.

  12. Si vous le souhaitez, apportez toutes les modifications nécessaires au fichier _config.yml. C’est nécessaire pour les chemins relatifs lorsque le dépôt est hébergé dans un sous-répertoire. Pour plus d’informations, consultez « Division d’un sous-dossier en nouveau dépôt ».

    domain: my-site.github.io       # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com
    url: https://my-site.github.io  # the base hostname and protocol for your site, e.g. http://example.com
    baseurl: /REPOSITORY-NAME/      # place folder name if the site is served in a subfolder
    
  13. Si vous le souhaitez, testez votre site localement. Pour plus d’informations, consultez « Test de votre site GitHub Pages localement avec Jekyll ».

  14. Ajoutez et commitez votre travail.

    git add .
    git commit -m 'Initial GitHub pages site with Jekyll'
  15. Ajoutez votre référentiel dans GitHub.com en tant que référentiel distant, en remplaçant USER par le compte propriétaire du référentiel et REPOSITORY par le nom du référentiel.

    $ git remote add origin https://github.com/USER/REPOSITORY.git
    
  16. Envoyez le dépôt à GitHub Enterprise Cloud, en remplaçant BRANCH par le nom de la branche sur laquelle vous travaillez.

    $ git push -u origin BRANCH
  17. Configurez votre source de publication. Pour plus d’informations, consultez « Configuration d’une source de publication pour votre site GitHub Pages ». 1. Dans GitHub Enterprise Cloud, accédez au dépôt de votre site. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Bouton Paramètres du dépôt

  18. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

  19. Si vous publiez un site de projet à partir d’un dépôt privé ou interne, vous pouvez choisir la visibilité de votre site. Sous « GitHub Pages », sélectionnez le menu déroulant Visibilité de GitHub Pages , puis cliquez sur une visibilité. Pour plus d’informations, consultez « Changement de la visibilité de votre site GitHub Pages ». Menu déroulant pour sélectionner la visibilité de votre site

      <div class="extended-markdown note border rounded-1 mb-4 p-3 color-border-accent-emphasis color-bg-accent f5">
    

    Remarque : pour publier un site GitHub Pages en privé, votre organisation doit utiliser GitHub Enterprise Cloud. Pour plus d’informations sur la façon d’essayer gratuitement GitHub Enterprise Cloud, consultez « Configuration d’un essai de GitHub Enterprise Cloud ».

    1. Pour voir votre site publié, sous « GitHub Pages », cliquez sur ** Visiter le site**. ![Capture d’écran du bouton « Visiter le site » en regard de l’URL d’un site publié](/assets/images/help/pages/click-pages-url-to-preview.png)

    Remarque : La publication des changements de votre site peut prendre jusqu’à 10 minutes après les avoir poussés vers GitHub Enterprise Cloud. Si vous ne voyez pas vos modifications du site GitHub Pages reflétées dans votre navigateur après une heure, consultez « À propos des erreurs de build Jekyll pour les sites GitHub Pages ».

  20. Votre site GitHub Pages est construit et déployé avec un workflow GitHub Actions. Pour plus d’informations, consultez « Affichage de l’historique des exécutions de workflows ».

    Remarque : GitHub Actions est gratuit pour les référentiels publics. Les frais d’utilisation s’appliquent aux référentiels privés et internes qui dépassent l’allocation mensuelle des minutes gratuites. Pour plus d’informations, consultez « Limites d’utilisation, facturation et administration ».

Remarque : Si vous publiez à partir d’une branche et votre site n’a pas été publié automatiquement, assurez-vous qu’une personne avec des autorisations d’administrateur et une adresse e-mail vérifiée a effectué une poussée vers la source de publication.

Étapes suivantes

Pour ajouter une nouvelle page ou publier sur votre site, consultez « Ajout de contenu à votre site GitHub Pages avec Jekyll ».

Vous pouvez ajouter un thème Jekyll à votre site GitHub Pages pour personnaliser son apparence. Pour plus d’informations, consultez « Ajout d’un thème à votre site GitHub Pages avec Jekyll ».