Git pour les articles de recherche : ce qui marche vraiment avec des coauteurs

Règles d'exclusion, attribution des chapitres, messages de commit, dépôts distants privés, et comment un espace de recherche avec un vrai Git, des duplications et des points de contrôle de l'IA garde les articles récupérables sans faire de Git un deuxième métier.

Les chercheurs utilisent déjà Git pour le code. Les articles ressemblent beaucoup à du code : du texte brut, des inclusions, des fichiers de compilation inutiles. Mettre un manuscrit dans un dépôt est moins étrange que cela en a l’air une fois qu’on l’a essayé.

Ignorez les fichiers inutiles

Un .gitignore raisonnable pour LaTeX :

*.aux
*.log
*.out
*.toc
*.synctex.gz
*.bbl
*.blg
*.fdb_latexmk
*.fls

Versionnez les .tex, les .bib, les figures que vous ne pouvez pas régénérer et le fichier de classe si l’université l’exige. Évitez de versionner chaque PDF, sauf si la revue veut un binaire dans l’archive.

Si votre éditeur lance Git à votre place, vérifiez que les caches de compilation et les intermédiaires du PDF sont ignorés. Un flot de commits parasites dus aux fichiers aux rend le journal sans valeur. Vous cessez de le lire, et l’historique ne peut plus vous aider quand quelque chose casse.

Attribuez des fichiers, pas des lignes

Deux personnes dans le même paragraphe, c’est la douleur des fusions. Préférez l’attribution par chapitre ou par section. Utilisez des pull requests quand le groupe est assez grand pour que la relecture serve vraiment.

La saisie multi-utilisateur en direct dans un même tampon relève d’un autre outil (les éditeurs LaTeX de navigateur). La collaboration avec Git est plus lente et plus explicite : brancher, pousser, relire. Cela marche bien quand vous avez besoin d’une trace écrite. Quand trois personnes doivent taper le résumé ensemble cet après-midi, choisissez autre chose.

Des messages de commit que vous pourrez relire plus tard

« Corrections diverses » ne sert à rien dans trois mois. « Réécriture des travaux connexes sur les transformers » suffit. Deux niveaux aident :

  1. Des jalons que vous nommez : brouillons de sections, soumission, version finale (camera-ready).
  2. Des points de contrôle de sécurité : des instantanés fréquents, pour qu’un mauvais après-midi soit réversible.

Si votre éditeur crée un point de contrôle après une compilation réussie ou quand vous arrêtez de taper, considérez-les comme un plancher, pas comme l’unique historique. Écrivez un vrai message quand une section est terminée ou qu’un brouillon part chez les coauteurs.

Dépôts distants privés

Le travail non publié a sa place dans des projets GitHub ou GitLab privés. C’est à la fin des études ou lors d’un changement de laboratoire que l’on perd l’accès à des comptes d’éditeur dans le cloud. Un dépôt distant que vous contrôlez est la sauvegarde.

Poussez dès que vous avez du réseau. N’attendez pas la veille d’une échéance pour découvrir que le dépôt distant n’a jamais été relié.

Compilation sur votre machine, sauvegarde à distance

La plupart des semaines, la boucle ressemble à ceci : modifier et compiler hors ligne, pousser quand vous avez du réseau. Vous n’avez pas besoin d’une session de navigateur ouverte rien que pour taper.

Ce que vous attendez de l’outillage :

  • chaque projet est déjà un vrai dépôt Git (pas de git init oublié)
  • des points de contrôle automatiques après les compilations réussies et les modifications laissées au repos
  • indexer, diff côte à côte, abandonner et restaurer en un clic, dans la même application que l’éditeur et le PDF
  • GitHub en option pour les dépôts distants ; l’historique fonctionne déjà sur le disque
  • dupliquer un projet entier avec tout son historique pour une expérience parallèle (réécriture risquée des méthodes, autre CV) pendant que la copie soumise reste en place
  • les modifications de l’IA, si vous les activez, créent d’abord un point de contrôle et n’arrivent que par des diffs à approuver

Oleafly (s’ouvre dans un nouvel onglet) est construit ainsi : de simples dossiers, un vrai .git, des points de contrôle automatiques qui nomment les fichiers modifiés, un panneau Contrôle de version avec des diffs modifiables de l’arbre de travail, une restauration après confirmation, la publication, le push et le pull GitHub en option, avec l’avance et le retard sur le distant, la duplication de projet avec filiation dans la bibliothèque. Le git log du terminal concorde avec l’application parce que c’est le même dépôt. Le point de contrôle de l’IA, quand vous en utilisez une, arrive dans ce même historique d’où vous restaurez.

Vous pouvez approcher une partie de tout cela avec de bonnes habitudes et un client Git séparé. La différence est de savoir si l’historique est quelque chose que vous mettez en place et dont vous devez vous souvenir, ou quelque chose que l’espace de travail de recherche suppose dès le premier jour, à côté de SyncTeX et de la compilation.

Ce que Git ne règle pas

Git ne remplacera pas les commentaires d’un responsable d’équipe (PI) qui n’ouvre que des PDF, et il ne décidera pas quel résumé est le bon. Les figures binaires se fusionnent toujours mal : gardez-les petites, préférez des graphiques que vous pouvez régénérer, et mettez-vous d’accord tôt sur qui est responsable de quoi.

Pour les coauteurs qui refusent Git, exportez un PDF ou un DOCX pour la relecture et gardez le .tex comme source de vérité. Voir coauteurs qui ne parlent que Word.

Une pratique minimale

  1. Un dépôt par article ou par thèse, et non un méga-dépôt pour toute votre carrière.
  2. Un .gitignore pour les fichiers de compilation inutiles dès le premier jour.
  3. Attribution des chapitres quand plus d’une personne modifie.
  4. Des commits de jalon avec des messages lisibles.
  5. Un dépôt distant privé relié avant que le travail ne compte.
  6. Une restauration testée une fois exprès, pour que la première urgence ne soit pas la première restauration.

Si vous suivez cette liste, Git pour les articles passe presque à l’arrière-plan. Avant une échéance, vous voulez une fiabilité ennuyeuse, pas un deuxième passe-temps.

Tous les articles