marcwrobel.github.io

marcwrobel.github.io

Sources du site Web https://www.marcwrobel.fr.

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 :

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 :

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).