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 :
- Installer Ruby Pour plus d’informations, consultez « Installation de Ruby » dans la documentation de Ruby.
- 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 de votre site en local
-
Ouvrez TerminalTerminalGit Bash.
-
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 ».
-
Exécutez
bundle install
. -
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écutantbundle exec jekyll serve
. -
Si le champ
_config.yml
de votre fichierbaseurl
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 surlocalhost:4000/
:bundle exec jekyll serve --baseurl=""
-
-
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 Server. Pour éviter cela, mettez régulièrement à jour la gemme github-pages
sur votre ordinateur.
- Ouvrez TerminalTerminalGit Bash.
- 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
.
- Si vous avez installé Bundler, exécutez
Pour aller plus loin
- GitHub Pages dans la documentation de Jekyll