Git per LaTeX

Cronologia, confronto e ripristino: versiona i tuoi progetti LaTeX su BlaBLaTeX.

BlaBLaTeX integra Git per LaTeX per gestire la cronologia, le versioni e la tracciabilità dei tuoi progetti. Puoi clonare un progetto, lavorare in locale (editor, script), quindi fare push per ritrovare automaticamente le tue modifiche nel workspace. Puoi anche partire da un repository Git locale già esistente e collegarlo a un progetto BlaBLaTeX.

Vai all’essenziale

Trovare l’URL Git · Avvio rapido · Repository locale già esistente · Workflow consigliato · Documentazione

Tornare indietro

Ripristina una versione stabile (commit) senza moltiplicare le copie dei file.

Confrontare

Identifica le differenze tra due versioni (diff) e valida una correzione.

Tracciare

Cronologia chiara: chi ha cambiato cosa, quando e perché (messaggio di commit).

Condividere

Sincronizza da/verso il workspace BlaBLaTeX per la revisione e il lavoro di squadra.

Passo 1

Trovare l’URL Git del tuo progetto BlaBLaTeX

Ogni progetto BlaBLaTeX possiede un URL Git dedicato costruito a partire dall’identificatore presente nell’URL del workspace:

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

Se sai già usare Git: ricorda clone, pull e push.

Passo 2

Avvio rapido: clonare, modificare, inviare

Copia l’URL Git del tuo progetto (sezione precedente), poi: 

# 1) Clonare il progetto
git clone https://git.blablatex.com/project/<ID_DEL_PROGETTO>.git
cd <cartella_del_progetto>

# 2) Verificare lo stato
git status
git log --oneline -n 10

# 3) Modificare e inviare verso BlaBLaTeX
git add -A
git commit -m "Aggiornamento del documento"
git push

Dopo git push, i file vengono aggiornati automaticamente nel tuo workspace BlaBLaTeX.

Passo 3

Partire da un repository Git locale già esistente

Se hai già un progetto versionato localmente, puoi collegarlo direttamente a BlaBLaTeX. Inizia creando un progetto BlaBLaTeX, recupera il suo identificatore, poi aggiungi il remote corrispondente.

Se il tuo branch locale si chiama main: 

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

Se il tuo branch locale si chiama master: 

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

Al primo invio, il progetto BlaBLaTeX viene inizializzato a partire dal contenuto del tuo repository locale.

Buone pratiche

Workflow consigliato (Git ↔ BlaBLaTeX)

Se a volte modifichi il progetto nell’interfaccia BlaBLaTeX, recupera prima le modifiche prima di eseguire il push: 

# Prima di lavorare
git pull

# Modifiche locali
git add -A
git commit -m "Descrizione chiara delle modifiche"

# Inviare a BlaBLaTeX
git push

Se usi un remote chiamato blablatex

Per recuperare esplicitamente le modifiche da BlaBLaTeX: 

# Branch locale main
git pull blablatex main

# Branch locale master
git pull blablatex master

Usa i comandi adatti al branch che utilizzi localmente.

Cosa puoi fare

A cosa serve Git per LaTeX su BlaBLaTeX?

Versionare un rapporto, una tesi o un articolo

Conserva una cronologia pulita di main.tex, dei capitoli, delle immagini e della bibliografia, e torna a una versione stabile in qualsiasi momento.

Lavorare con i tuoi strumenti

Editor locale, script, automazione, CI… mantenendo BlaBLaTeX come fonte di riferimento.

Collaborare senza moltiplicare le copie

Il commit diventa il tuo punto di controllo: messaggio chiaro, tracciabilità e revisione più semplice.

Confrontare le modifiche

Comprendi rapidamente cosa è cambiato tra due versioni grazie a git diff e alla cronologia.