Se déplacer à la racine du projet puis
bundle install
bundle exec jekyll serve --safe
bundle exec
vous assure que la version de jekyll utilisée est celle spécifiée dans le fichierGemfile.lock
.
L'option
--safe
permet d'avoir le même comportement que sur les serveurs de build de Github Pages. Ainsi pas de surprise lors du déploiement.
Generating...
done in 0.124 seconds.
Auto-regeneration: enabled for '/home/emak/code/societenumerique.github.io'
Server address: http://127.0.0.1:4000
Server running... press ctrl-c to stop.
Visiter l'url : http://localhost:4000
Le site est généré dans le dossier
_site
qui est ignoré par git.
Le site est automatiquement regénéré lorsqu'un fichier source est édité (
_layouts
,_includes
,_topics
, etc). Il suffit de rafraichir la page pour voir les changements.
Comme la gem github-pages
est mise à jour régulièrement, il est conseillé de mettre à jour les dépendances (gems) de temps en temps:
bundle update
- Jekyll, générateur de site statique
- Liquid, language de templating utilisé par Jekyll
- Github Pages Basics
- Customizing Github Pages