Sources du site Web www.marcwrobel.fr.
Caractéristiques
Le site Web www.marcwrobel.fr utilise le générateur de site statique Jekyll et est hébergé sur GitHub Pages.
www.marcwrobel.fr utilise aussi :
- Bootstrap pour la mise en forme,
- Bootstrap Icons pour les icônes,
- Simple-Jekyll-Search pour la fonctionnalité de recherche,
- IntelliJ IDEA pour le développement du site et la rédaction du contenu,
- et pour l'analyse et la recommandation de bonnes pratiques :
Prérequis
Ce site utilise le générateur de site statique Jekyll. Pour l’installer, consultez la documentation officielle.
Mise à jour du site
Lancez tout d’abord le serveur local :
bin/serve
Apportez ensuite vos modifications et prévisualisez-les au fur et à mesure dans votre navigateur.
Commitez enfin vos modifications sur la branche main. Tout ce qui est commité sur cette branche est automatiquement
publié sur www.marcwrobel.fr.
Mise à jour des dépendances
La mise à jour de l'ensemble des dépendances du site passe par le script update-dependencies. Pour l'utiliser,
exécuter :
./bin/update-dependencies
Il ne reste alors plus qu’à tester que le site fonctionne bien puis commiter le tout, généralement en séparant le type de mise à jour (Jekyll, Bootstrap...).
Quelques petites choses doivent de plus être connus en fonction du type de dépendances.
Paquets Ruby
Les dépendances Ruby sont décrites dans le fichier Gemfile. Le script update-dependencies met à jour les
paquets en fonction de ce fichier.
La plupart des versions utilisées dépendent de GitHub Pages.
CSS et JS
À cause de problématiques liées à la
RGPD
les dépendances CSS et JS sont hébergées dans le répertoire assets et non sur un CDN. Le script
update-dependencies met à jour ces dépendances en fonction d'informations renseignées dans le script
lui-même.
Généralement toutes les mises à jour se font automatiquement, à l'exception des mises à jour pouvant nuire au bon
fonctionnement du site (Bootstrap). Ces mises à jour doivent être appliquées à la main en modifiant
le script update-dependencies.
Ruby
La version de Ruby utilisée en production est celle de GitHub Pages. En développement on utilisera la version maintenue la plus proche.
Suivi des mises à jour
Que ce soit en grande partie automatique (pour Jekyll, avec Bundler) ou manuel (pour Bootstrap ou Simple-Jekyll-Search) pour mettre à jour les dépendances utilisées par ce site il faut déjà que vous soyez au courant que ces mises à jour existent. Pour cela plusieurs moyens :
- suivre les blogs des projets (Jekyll, Bootstrap et Boostrap Icons),
- suivre les pages GitHub des projets (Jekyll, Bootstrap, Bootstrap et Simple-Jekyll-Search),
- ou, plus simplement, utiliser newreleases.io (Jekyll, Bootstrap, Bootstrap Icons et Simple-Jekyll-Search).
Documentation utile
License
Le contenu de ce site Web est, sauf indication contraire, sous licence Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).
