Jekyll - Simple, blog-aware, static sites
Github & Plugins
Github
Comme dit dans l'introduction, on peut héberger son site avec Github ! En effet, Jekyll est très adapté pour GitHub, il a même été réalisé pour cet usage à la base, afin de permettre aux développeurs de proposer rapidement et facilement une démonstration de leur code.
Les pages web de Github sont elles-mêmes générées avec Jekyll. On versionne uniquement les sources et pas le _site (à ajouter dans le .gitignore)
Faire cela confére certains avantages :
- Le projets Jekyll est reconnu automatiquement par Github, il génère directement le site web. Votre site est accessible instantanément
- C’est gratuit, rapide et on peut utiliser sont propre nom de domaine
- Pas d’administration système et réseaux, directement versionné
- Pas besoin de republier votre site, c’est fait automatiquement lors de vos changements
Il y a 2 façon d'héberger son site :
- Pour créer une page pour votre dépôt http://.github.io/. Dans ce cas là il vous faudra versionner votre projet jekyll sur une branche gh-pages
- Pour vous créer un site perso http://.github.io/ en créant un dépôt .github.io sur votre compte, et en publiant votre projet jekyll sur la branche master
Attention toutefois à quelques limitations, en effet github n'autorise pas l'utilisation de plugins pour ces pages (pour des raisons de sécurité). Donc si vous en utilisez il vous faudra publier directement les fichiers HTML.
Pour plus d"informations on peut consulter la documention Github fait par ... Github -> ici
Plugins
Pour améliorer encore le fonctionnement de Jekyll on peut intégrer des plugins qui se chargeront d'ajouter et de gérer des fonctionnalités. Au cas où les fonctionnalités de base ne soient pas suffisantes : Gestion multilingue, dimensionnement des images auto, … etc
Ce sont de simple fichiers .rb (ruby) à déposer dans un nouveau répertoire : _plugins
3 types de plugins :
- Generators
- Converters
- Tags
On peut tous les retrouver sur le site de Jekyll : Plugins Jekyll