> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione Git

> Crea un token di accesso, clona un progetto con Git, poi esegui pull e push.

Lavora su un progetto dal tuo computer con Git. Le modifiche vengono trasferite solo quando esegui `git pull` o `git push`.

> [!NOTE]
>
> Un amministratore deve prima attivare l'[integrazione Git](https://ayakaleaf-pro.mintlify.site/it/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Creare un token

Git accede con un token di autenticazione Git, non con la password del tuo account.

**1. Apri le impostazioni dell'account**

Fai clic su **Account**, poi su **Account settings**. In **Git integration**, fai clic su **Generate token**. Quando hai già un token, questo pulsante si chiama **Add another token**.

![La sezione Git integration delle impostazioni dell'account con un pulsante Generate token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-settings.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4ff1f16eb46266f7bf31956bf3b9d89)

L'integrazione Git nelle impostazioni dell'account

**2. Copia il token**

Fai clic su **Copy** e conserva il token in un luogo sicuro. Lo vedi una sola volta. Poi fai clic su **Close**.

![La finestra di dialogo del token di autenticazione Git con un pulsante Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Il tuo nuovo token

**3. Controlla il token**

L'elenco mostra ora l'inizio del token, quando è stato creato e quando è stato usato l'ultima volta. Scade dopo un anno. Puoi avere fino a 10 token.

![L'elenco dei token con un token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

I tuoi token

## Clonare un progetto

**1. Apri l'integrazione Git nell'editor**

Apri il progetto. Nella barra a sinistra, fai clic su **Integrations**, poi su **Git integration**.

![Il pannello Integrations con la scheda Git integration](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-panel.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=3fb82c63ba8d205191eadb5015bdefb5)

Il pannello Integrations

**2. Copia il comando**

La finestra di dialogo **Clone with Git** mostra il comando, con l'indirizzo del tuo sito e l'ID del progetto. Fai clic su **Copy**. Se non hai ancora un token, **Go to settings** apre le impostazioni dell'account in una nuova scheda.

![La finestra di dialogo Clone with Git con il comando git clone](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-clone.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f6d69046df7caf4cbee07f49e8dd6540)

Il comando di clonazione

**3. Eseguilo**

Incolla il comando in un terminale. Quando Git chiede una password, incolla il tuo token.

```text theme={null}
$ git clone https://git@<your-site>/git/<project-id>
Cloning into '<project-id>'...
Password for 'https://git@<your-site>': <your-token>
```

Una cartella con il nome dell'ID del progetto contiene ora i file del progetto, sul branch `main`. Per scegliere il nome della cartella, aggiungilo alla fine del comando.

Git chiede il token ogni volta che contatta il sito. Per farlo ricordare, attiva un credential helper: Git lo chiede ancora una volta, poi lo conserva. L'helper `store` lo salva non cifrato in `~/.git-credentials`.

```bash theme={null}
git config --global credential.helper store
```

## Scaricare le modifiche dall'editor

All'interno della cartella, esegui:

```bash theme={null}
git pull
```

Git elenca i file modificati. Le modifiche fatte nell'editor arrivano come commit chiamati `Update on Overleaf.`.

```text theme={null}
Updating db007e3..c3e6332
Fast-forward
 main.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
```

## Inviare le tue modifiche

Esegui il commit delle modifiche, poi inviale con push:

```bash theme={null}
git add main.tex
git commit -m "Add a line from Git"
git push
```

L'ultima riga dell'output mostra il branch che è avanzato:

```text theme={null}
   53aca61..db007e3  main -> main
```

Le modifiche compaiono nell'editor, e un editor aperto si aggiorna da solo. Nuovi file, cartelle e rinomine compaiono nell'albero dei file. In **History**, la tua modifica è contrassegnata come **You (via Git)**. Il messaggio di commit non viene mostrato lì.

![La cronologia del progetto con la riga inviata, contrassegnata come You (via Git)](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-history.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f4d5575612ebd75db3656cac1ea495)

Un push nella cronologia del progetto

### Se Git rifiuta il tuo push

Se nel frattempo il progetto è cambiato, Git rifiuta il push:

```text theme={null}
 ! [rejected]        main -> main (fetch first)
```

Scarica prima quelle modifiche, poi esegui di nuovo il push:

```bash theme={null}
git pull --no-rebase --no-edit
git push
```

Un semplice `git pull` può fermarsi con `fatal: Need to specify how to reconcile divergent branches.` L'opzione `--no-rebase` qui sopra risolve il problema: unisce i due lati.

Se le stesse righe sono cambiate su entrambi i lati, il pull si ferma con `CONFLICT (content): Merge conflict in main.tex`. Correggi il file, poi:

```bash theme={null}
git add main.tex
git commit -m "Merge the changes from the editor"
git push
```

Il sito non accetta due cose:

* Altri branch: `! [remote rejected] feature -> feature (wrong branch)`. Esiste solo `main`, quindi invia lì il tuo lavoro.
* Force push: `! [remote rejected] main -> main (forced push prohibited)`. Metti invece le tue modifiche sopra il `main` attuale.

### Se Git risponde Authentication failed

```text theme={null}
remote: Enter your Git authentication token when prompted for a password.
fatal: Authentication failed for 'https://<your-site>/git/<project-id>/'
```

Il token è errato o è stato eliminato, oppure hai inserito la password dell'account. Crea un nuovo token se non lo hai più, perché non puoi rivedere un token esistente.

## Eliminare un token

In **Account settings**, sotto **Git integration**, fai clic sull'icona di eliminazione accanto al token, poi su **Delete** nella finestra di dialogo. Da quel momento, Git risponde `Authentication failed` a quel token.

![La finestra di dialogo Delete Authentication token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-delete-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=1708062228778239c6465b0369614a18)

Eliminare un token

> [!NOTE]
>
> Per sapere cosa possono fare i collaboratori con accesso in sola lettura, consulta il Q\&A dell'[integrazione Git](https://ayakaleaf-pro.mintlify.site/it/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.