Test de votre site GitHub Pages localement avec Jekyll

Toute personne disposant d’autorisations en lecture sur un dépôt peut tester un site GitHub Pages localement.

Prérequis

Avant de pouvoir utiliser Jekyll pour tester un site, vous devez :

• Installer Jekyll.
• Créer un site web Jekyll. Pour plus d’informations, consultez « Création d’un site GitHub Pages avec Jekyll ».

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 ».

Création de votre site en local

1. Ouvrez TerminalTerminalGit Bash.

2. 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 ».

3. Exécutez bundle install.

4. Exécutez votre site Jekyll localement.

   $ bundle exec jekyll serve
   > Configuration file: /Users/octocat/my-site/_config.yml
   >            Source: /Users/octocat/my-site
   >       Destination: /Users/octocat/my-site/_site
   > Incremental build: disabled. Enable with --incremental
   >      Generating...
   >                    done in 0.309 seconds.
   > Auto-regeneration: enabled for '/Users/octocat/my-site'
   > Configuration file: /Users/octocat/my-site/_config.yml
   >    Server address: http://127.0.0.1:4000/
   >  Server running... press ctrl-c to stop.
   

   Remarques :

   • Si vous avez installé Ruby 3.0 ou ultérieure (ce que vous pouvez avoir si vous avez installé la version par défaut via Homebrew), vous pouvez obtenir une erreur à cette étape. Ceci est dû au fait que ces versions de Ruby ne sont plus fournies avec webrick installé.

     Pour corriger l’erreur, essayez en exécutant bundle add webrick, puis en réexécutant bundle exec jekyll serve.

   • Si le champ _config.yml de votre fichier baseurl contient le lien de votre dépôt GitHub, vous pouvez utiliser la commande suivante lors de la génération locale pour ignorer cette valeur et servir le site sur localhost:4000/ :

     bundle exec jekyll serve --baseurl=""
     

5. Pour voir un aperçu de votre site, dans votre navigateur web, accédez à http://localhost:4000.

Mise à jour de la gemme GitHub Pages

Jekyll est un projet open source actif qui est mis à jour fréquemment. Si la gemme github-pages sur votre ordinateur est obsolète avec la gemme github-pages sur le serveur GitHub Pages, votre site peut être différent selon s’il est créé localement ou publié sur GitHub Enterprise Cloud. Pour éviter cela, mettez régulièrement à jour la gemme github-pages sur votre ordinateur.

1. Ouvrez TerminalTerminalGit Bash.
2. Mettez à jour la gemme github-pages.
   • Si vous avez installé Bundler, exécutez bundle update github-pages.
   • Si Bundler n’est pas installé, exécutez gem update github-pages.

Pour aller plus loin

• GitHub Pages dans la documentation de Jekyll