Vai al contenuto principale
Collega un progetto a un repository GitLab. Le modifiche vanno in entrambe le direzioni, e solo quando fai clic su Sync: niente si sincronizza da solo.
Un amministratore deve prima attivare la sincronizzazione con GitLab.
Lo fai una sola volta.
1

Apri le impostazioni dell'account

Fai clic su Account, poi su Account settings. In Project synchronisation, trova GitLab e fai clic su Link.
La sezione GitLab delle impostazioni dell'account con un pulsante Link

GitLab nelle impostazioni dell'account

2

Autorizza su GitLab

Si apre GitLab. Accedi se richiesto, poi autorizza l’applicazione.
3

Controlla il collegamento

Torni alle impostazioni dell’account. Un messaggio verde indica che il tuo account GitLab è collegato, e il pulsante ora indica Unlink.
La sezione GitLab delle impostazioni dell'account con un pulsante Unlink

Il tuo account GitLab è collegato

Se il tuo account non è ancora collegato, Import from GitLab e la scheda GitLab nell’editor ti chiedono prima di collegarlo. Fai clic su Link to your GitLab account. Anche così arrivi alle impostazioni dell’account, in una nuova scheda se hai iniziato dall’editor. Poi torna indietro e ricomincia.
La finestra di dialogo Import from GitLab con un pulsante Link to your GitLab account

La richiesta quando il tuo account non è collegato

Importare un repository

Crea un nuovo progetto da un repository GitLab, già collegato a esso.
1

Apri la finestra di importazione

Nella pagina dei progetti, fai clic su New project, poi su Import from GitLab.
Il menu New project con Import from GitLab

Il menu New project

2

Scegli il repository

Fai clic su Import to Overleaf accanto al repository. L’elenco include i tuoi repository e quelli dei tuoi gruppi.
La finestra di dialogo Import from GitLab con quattro repository

I tuoi repository GitLab

3

Controlla il progetto

Il nuovo progetto si apre con i file del repository.
L'editor con il progetto importato, i suoi file e il PDF compilato

Il progetto importato

Esportare un progetto in un nuovo repository

Crea un repository da un progetto e li collega. Un progetto può essere collegato solo in questo modo o tramite importazione: non puoi collegarlo a un repository già esistente.
1

Apri GitLab nell'editor

Apri il progetto. Nella barra a sinistra, fai clic su Integrations, poi su GitLab.
Il pannello Integrations con la scheda GitLab

Il pannello Integrations

2

Compila il repository

Scegli l’Owner, che può essere tu o uno dei tuoi gruppi. Quando scegli un gruppo, questo campo si chiama Organization. Repository Name parte dal nome del progetto. La descrizione è facoltativa, e Private è selezionato per impostazione predefinita. Fai clic su Create a GitLab repository.
Il modulo Export Project to GitLab compilato

Export Project to GitLab

Se il nome è già in uso, la finestra di dialogo mostra Please check that the repository name is valid, and that you have permission to create the repository. Cambia il nome e fai di nuovo clic sul pulsante.
3

Controlla il collegamento

La finestra di dialogo ora indica This project is linked to e il nome del repository.
La finestra di dialogo Sync with GitLab dopo l'esportazione

Il progetto è collegato

Sincronizzare

1

Apri la finestra di sincronizzazione

Apri un progetto collegato. Nella barra a sinistra, fai clic su Integrations, poi su GitLab.Recent commits in GitLab elenca ciò che entrerà nel progetto.
La finestra di dialogo Sync with GitLab con un nuovo commit

Un nuovo commit in attesa su GitLab

2

Descrivi le tue modifiche

Se hai modificato qualcosa nel progetto, compare un campo per il messaggio di commit. È facoltativo: se lo lasci vuoto, il commit si chiama Updates from Overleaf.
La finestra di dialogo Sync with GitLab con un messaggio di commit compilato

Il messaggio di commit delle tue modifiche

3

Fai clic su Sync

Fai clic su Sync. I nuovi commit da GitLab entrano nel progetto, e le tue modifiche vanno al branch predefinito del repository. Se entrambi i lati hanno modificato cose diverse, vengono unite per te.
4

Controlla il risultato

La finestra di dialogo mostra No new commits in GitLab since last merge. e il campo del messaggio di commit è sparito. I file nell’editor e i commit su GitLab sono aggiornati.
La finestra di dialogo Sync with GitLab dopo la sincronizzazione, senza nuovi commit

Tutto è sincronizzato

Se le stesse righe sono cambiate su entrambi i lati

La finestra di dialogo indica che le modifiche non sono state unite e nomina un nuovo branch, overleaf-YYYY-MM-DD-HHMMSS, che contiene le tue modifiche. Overleaf apre anche una merge request da quel branch su GitLab.
La finestra di dialogo Sync with GitLab con un avviso di conflitto di merge

Un conflitto

  1. Unisci quel branch nel branch predefinito su GitLab o con Git. Nel frattempo puoi chiudere la finestra di dialogo: mostra lo stesso messaggio quando la riapri.
  2. Fai clic su I have manually merged. Continue. Il risultato unito entra nel progetto. Se fai clic prima che il branch sia unito, la finestra di dialogo resta invariata.
  3. Il branch resta su GitLab, a meno che tu non l’abbia eliminato durante il merge. Eliminalo quando non ti serve più.
La stessa finestra di dialogo compare quando le regole di merge del repository trattengono la merge request, ad esempio perché richiede un’approvazione, anche se nessuna riga è in conflitto. Quando la regola lo consente, unisci la merge request su GitLab e fai clic su I have manually merged. Continue. Consulta Come funziona la sincronizzazione con GitLab. Fallo quando non vuoi più che il progetto si sincronizzi.
1

Fai clic su Unlink

Nella finestra di sincronizzazione, fai clic su Unlink.
2

Conferma

Fai clic su Confirm. Questo rimuove solo il collegamento: la connessione a un repository di tua proprietà, menzionata nell’avviso, è un’opzione che hai in seguito, non qualcosa che accade ora.
La finestra di dialogo Sync with GitLab che chiede di confermare lo scollegamento

Conferma lo scollegamento

3

Controlla il risultato

La finestra di dialogo ora mostra Export Project to GitLab. Il progetto e il repository conservano entrambi il loro contenuto. Per sincronizzare di nuovo, esporta il progetto in un nuovo repository o importa il repository in un nuovo progetto.
In Account settings, sotto GitLab, fai clic su Unlink, poi di nuovo su Unlink nella finestra di dialogo.
La finestra di dialogo Unlink GitLab Account

Scollega il tuo account

I tuoi progetti restano collegati ai loro repository. Non puoi sincronizzarli finché non colleghi di nuovo il tuo account.
Per sapere chi può fare cosa in un progetto condiviso, consulta Chi può collegare e sincronizzare.
Ultima modifica il 20 novembre 2026