Test de votre site GitHub Pages localement avec Jekyll

Toute personne disposant d’autorisations de lecture pour un référentiel peut tester un GitHub Pages site 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.
   

   Remarque

   • 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 vous avez installé Ruby 3.2 ou version ultérieure, vous pouvez voir d’autres erreurs liées aux gemmes et méthodes manquantes, en raison de problèmes de compatibilité avec la github-pages gemme. Dans cet événement, vous devez installer Ruby 3.1.x ou une version antérieure à la place.

   • Si votre champ _config.yml fichier baseurl contient le lien de votre dépôt GitHub, vous pouvez utiliser la commande suivante lors de la création 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 du GitHub Pages gem

Jekyll est un projet open source actif mis à jour fréquemment. Si la github-pages gemme sur votre ordinateur est obsolète avec la github-pages gemme sur le GitHub Pages serveur, votre site peut être différent lorsqu’il est construit localement que lorsqu’il est publié sur GitHub. 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