🧑🏻‍🏫 2e cours 'Git Tutorial' pour les doctorants

Ce vendredi, j’ai donné le cours (Git: a Hands-on Tutorial) à l’université dans le cadre des formations RISE (service Recherche, Innovation, Support et Entreprises) et je suis plutôt content de la manière dont ça s’est passé par rapport à ma première expérience en novembre.

Ce cours sur git, je le construis depuis longtemps. C’était tout d’abord un (énorme) mémo “powerpoint” de mes essais et erreurs en apprenant git. J’ai ensuite amélioré ce mémo pour expliquer le système à mes collègues lors de la transition SVN => git (21 mars 2020 - ça me paraît si loin! je ne me souvenais pas que c’était en plein Covid!). J’ai ensuite amélioré la présentation dans le cadre d’une “prestation de services” pour ArcelorMital où il était question d’installer une instance GitLab chez Open-Engineering pour gérer la refonte de leurs codes. Je l’ai ensuite simplifié lorsqu’on a imposé l’utilisation de git pour le projet intégré du 1er master physicien. Au début de cette période, je faisais une démo “live” de git avec mon collègue qui jouait le rôle d’un 2e développeur.

J’ai été contacté l’année passée pour reprendre le cours des Formation à la carte pour les doctorants et le personnel de l’ULiège. Jusqu’à ce moment, RISE payait un consultant externe pour donner cette formation. Avec moi, ça devenait gratuit. C’est comme ça que je me suis retrouvé là…

Je suis assez fier de donner cette formation parce qu’elle concrétise tous les efforts que j’ai faits au fil du temps pour gérer les codes et aider les chercheurs du département. C’était un des rôles de mon poste lorsque je suis devenu premier assistant en 2013. En tant que geek, j’aime bien “jouer” avec git et mon expertise est maintenant reconnue.

L’année passée, j’avais adapté le contenu de la formation de l’ancien consultant pour rendre le discours plus focalisé sur l’instance GitLab de l’université et non Github. J’aurais aimé aussi m’adresser à des personnes qui ne sont pas des programmeurs. Git peut en effet être utilisé pour gérer n’importe quel projet qui utilise des fichiers texte, par exemple un article scientifique, une présentation ou un site web. J’ai donc remplacé directement le prérequis “notions de programmation” demandé pour accéder à la formation par “utilisation d’un éditeur de texte et de la ligne de commande”.

Je voulais aussi qu’il y ait une sorte d’effet “waw” en gérant et en construisant la présentation du cours elle-même par un pipeline GitLab! Pour ce faire, j’ai utilisé l’outil le plus simple que j’ai trouvé: Marp: Markdown Presentation Ecosystem, dans le but de séduire un maximum de personnes. Marp permet de convertir un simple fichier markdown en un slide-deck html ou pdf. Marp a beaucoup d’avantages sur d’autres systèmes du même genre:

• tout tient dans un seul exécutable (marp.exe sous windows),
• c’est multi-plateforme,
• c’est très facile à comprendre (simple fichier markdown où il suffit de séparer chaque slide par ---),
• il est possible de tout customiser via du HTML et CSS pour les utilisateurs avancés,
• le rendu est impeccable. Marp se prête bien à une démo de l’intégration continue de GitLab: il suffit de générer la présentation à chaque push et publier le résultat sur GitLab pages. En quelques commandes tout fonctionne parfaitement (et rapidement). Autre effet bénéfique pour moi: plus besoin de PowerPoint… ce qui m’a permis de passer mon laptop de cours sous Ubuntu (et lui redonner un nouveau souffle).

C’était donc la 2e fois que je donnais la formation. La première avait eu lieu en novembre 2025 et RISE ne m’avait donné que 3 heures (une matinée) pour donner le cours. C’était “un peu” court, même si j’y étais arrivé un mois plus tôt dans le cadre du cours INFO 0939 - High Performance Scientific Computing. Lors de cette toute première répétition, c’était face à des futurs ingénieurs qui étaient donc déjà un peu dans le bain. Ici, il s’agissait d’étudiants de tout horizons. Les feedbacks des étudiants avaient été plutôt bons malgré tout…

Pour cette deuxième session, j’ai pu obtenir une journée complète pour donner le cours, c’est-à-dire, en pratique, 2x 3 heures. Ca me donnait donc largement le temps de terminer la présentation, d’autant plus qu’on m’avait conseillé d’envoyer les instructions d’installation de git et la configuration de l’accès à GitLab comme tâche préparatoire à faire avant de venir au cours. Il fallait donc trouver de quoi compléter la formation pour remplir la fin de l’après-midi.

J’ai donc eu l’idée de continuer à mettre en avant des utilisations de l’intégration continue de GitLab pour publier des documents et des sites web.

Ayant envie depuis longtemps de passer mon mini-site perso de Jekyll à Hugo (cfr. ce blog), c’était l’occasion de m’y mettre. J’ai donc passé du temps avec ChatGPT et la doc Hugo pour mettre au point un site minimal pas trop laid tout en restant très simple. C’est en faisant ce travail que j’ai vu l’utilité de ma démarche. Même pour moi, qui a plutôt l’habitude de passer des heures devant mon écran et mon clavier, faire fonctionner Hugo correctement avec GitLab n’est pas du tout simple. J’ai d’abord essayé le template donné par GitLab qui n’a pas fonctionné. Ensuite je me suis rendu compte qu’il y avait plusieurs manières de gérer les thèmes et que certaines (“module go” qui nécessite l’installation de go) pourraient être compliquées à mettre en oeuvre sur les PC windows des étudiants. Enfin, certains thèmes (généralement celui qu’on a justement envie d’utiliser) ne sont pas compatibles avec certaines versions d’Hugo (généralement la dernière)… Bon, j’y suis finalement arrivé, en version “blog” avec 5 articles sur “git” générés par ChatGPT à partir de ma présentation. J’aimerais faire également un site type “CV” quand j’aurai le temps.

J’avais envie aussi de proposer plusieurs manières de générer des documents, avec LaTeX, Pandoc et Typst. J’ai aussi fait un projet qui génère du beamer.

Côté “code”, j’ai fait du C++ compilé par CMake, testé par CTest, documenté par Doxygen sur GitLab-pages, du python documenté par pdoc et un notebook Jupyter rendu sur GitLab-pages.

J’aimerais, dans un avenir proche, faire du Jupyter interactif avec JupyterLite, du C++ compilé en web assembly avec Emscripten et peut-être tester Remark comme alternative à Marp. Je dois aussi investiguer l’utilisation de GitLab avec Overleaf. Enfin, certains étudiants utilisent peut-être du Fortran ou du Matlab… Ca vaudrait le coup de leur proposer quelque chose, ne serait ce que de la doc en ligne. Je pourrais peut-être aussi copier mon vieux site Jekyll là-bas, même si Ruby ne m’a pas séduit à l’usage.

Bref, beaucoup d’idées à concrétiser…