Git pour LaTeX

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. Vous pouvez également partir d’un dépôt Git local déjà existant et le raccorder à un projet BlaBLaTeX.

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 et push.

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.

Partir d’un dépôt Git local déjà existant

Si vous avez déjà un projet versionné localement, vous pouvez le raccorder directement à BlaBLaTeX. Commencez par créer un projet BlaBLaTeX, récupérez son identifiant, puis ajoutez le remote correspondant.

Si votre branche locale s’appelle main :

git remote add blablatex https://git.blablatex.com/project/<ID_DU_PROJET>.git
git push blablatex main

Si votre branche locale s’appelle master :

git remote add blablatex https://git.blablatex.com/project/<ID_DU_PROJET>.git
git push blablatex master

Lors du premier envoi, le projet BlaBLaTeX est initialisé à partir du contenu de votre dépôt local.

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

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

# Envoyer vers BlaBLaTeX
git push

Si vous utilisez un remote nommé blablatex

Pour récupérer explicitement les changements depuis BlaBLaTeX :

# Branche locale main
git pull blablatex main

# Branche locale master
git pull blablatex master

Utilisez les commandes adaptées à la branche que vous utilisez localement.

À quoi sert Git pour LaTeX sur BlaBLaTeX ?