Git pour LaTeX

Historique, comparaison et restauration : versionnez vos projets LaTeX sur BlaBLaTeX.

BlaBLaTeX intègre Git pour LaTeX afin de gérer l’historique, les versions et la traçabilité de vos projets. Vous pouvez cloner un projet, travailler localement (éditeur, scripts), puis push pour retrouver automatiquement vos changements dans le workspace.

Revenir en arrière

Restaurez une version stable (commit) sans multiplier les copies de fichiers.

Comparer

Identifiez les différences entre deux versions (diff) et validez une correction.

Tracer

Historique clair : qui a changé quoi, quand, et pourquoi (message de commit).

Partager

Synchronisez depuis/vers le workspace BlaBLaTeX pour la relecture et l’équipe.

Étape 1

Trouver l’URL Git de votre projet BlaBLaTeX

Chaque projet BlaBLaTeX possède une URL Git dédiée construite à partir de l’identifiant présent dans l’URL du workspace :

  • Workspace : https://workspace.blablatex.com/project/<ID_DU_PROJET>
  • Git : https://git.blablatex.com/project/<ID_DU_PROJET>.git
Workspace : https://workspace.blablatex.com/project/6940036c696502c3fc2d49dc
Git       : https://git.blablatex.com/project/6940036c696502c3fc2d49dc.git

Si vous savez déjà utiliser Git : retenez clone, pull (idéalement --rebase) et push.

Étape 2

Démarrage rapide : cloner, modifier, envoyer

Copiez l’URL Git de votre projet (section précédente), puis :

# 1) Cloner le projet
git clone https://git.blablatex.com/project/<ID_DU_PROJET>.git
cd <dossier_du_projet>

# 2) Vérifier l’état
git status
git log --oneline -n 10

# 3) Modifier puis envoyer vers BlaBLaTeX
git add -A
git commit -m "Mise à jour du document"
git push

Après git push, les fichiers sont mis à jour automatiquement dans votre workspace BlaBLaTeX.

Bonnes pratiques

Workflow recommandé (Git ↔ BlaBLaTeX)

Si vous modifiez parfois le projet dans l’interface BlaBLaTeX, récupérez d’abord les changements avant de pousser :

# Avant de travailler
git pull --rebase

# Modifications locales
git add -A
git commit -m "Description claire des changements"

# Envoyer vers BlaBLaTeX
git push

Pourquoi --rebase ?

Cela évite souvent un commit de fusion inutile et réduit les erreurs “fetch first” lors du push.

Ce que vous pouvez faire

À quoi sert Git pour LaTeX sur BlaBLaTeX ?

Versionner un rapport, une thèse, un article

Conservez un historique propre de main.tex, des chapitres, des images et de la bibliographie, et revenez à une version stable à tout moment.

Travailler avec vos outils

Éditeur local, scripts, automatisation, CI… tout en gardant BlaBLaTeX comme source de vérité.

Collaborer sans multiplier les copies

Le commit devient votre point de contrôle : message clair, traçabilité, relecture plus simple.

Comparer des changements

Comprenez rapidement ce qui a bougé entre deux versions grâce à git diff et l’historique.