> ## 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.

# Integração com Git

> Crie um token de acesso, clone um projeto com Git e depois faça pull e push.

Trabalhe em um projeto no seu próprio computador com Git. As alterações só são transferidas quando você executa `git pull` ou `git push`.

> [!NOTE]
>
> Um administrador precisa ativar primeiro a [integração com Git](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).

## Criar um token

O Git faz login com um token de autenticação do Git, não com a senha da sua conta.

**1. Abra as configurações da conta**

Clique em **Account** e depois em **Account settings**. Em **Git integration**, clique em **Generate token**. Depois que você tiver um token, esse botão passa a se chamar **Add another token**.

![A seção Git integration das configurações da conta com um botão 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)

A integração com Git nas configurações da conta

**2. Copie o token**

Clique em **Copy** e guarde o token em um lugar seguro. Você só o vê uma vez. Depois clique em **Close**.

![A caixa de diálogo do token de autenticação do Git com um botão Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Seu novo token

**3. Verifique o token**

A lista agora mostra o início do token, quando ele foi criado e quando foi usado pela última vez. Ele expira após um ano. Você pode ter até 10 tokens.

![A lista de tokens com um token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Seus tokens

## Clonar um projeto

**1. Abra a integração com Git no editor**

Abra o projeto. Na barra à esquerda, clique em **Integrations** e depois em **Git integration**.

![O painel Integrations com o cartão 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)

O painel Integrations

**2. Copie o comando**

A caixa de diálogo **Clone with Git** mostra o comando, com o endereço do seu site e o ID do projeto. Clique em **Copy**. Se você ainda não tiver um token, **Go to settings** abre as configurações da sua conta em uma nova aba.

![A caixa de diálogo Clone with Git com o 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)

O comando de clonagem

**3. Execute o comando**

Cole o comando em um terminal. Quando o Git pedir uma senha, cole seu 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>
```

Uma pasta com o nome do ID do projeto agora contém os arquivos do projeto, no branch `main`. Para escolher o nome da pasta, adicione-o ao final do comando.

O Git pede o token toda vez que se conecta ao site. Para que ele seja lembrado, ative um credential helper: o Git pede mais uma vez e depois guarda o token. O helper `store` o guarda sem criptografia em `~/.git-credentials`.

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

## Trazer as alterações do editor

Dentro da pasta, execute:

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

O Git lista os arquivos que mudaram. As alterações feitas no editor chegam como commits chamados `Update on Overleaf.`.

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

## Enviar suas alterações

Faça commit das suas alterações e depois envie-as com push:

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

A última linha da saída mostra o branch que avançou:

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

As alterações aparecem no editor, e um editor aberto se atualiza sozinho. Novos arquivos, pastas e renomeações aparecem na árvore de arquivos. Em **History**, sua alteração aparece marcada como **You (via Git)**. Sua mensagem de commit não é mostrada ali.

![O histórico do projeto mostrando a linha enviada, marcada como 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)

Um push no histórico do projeto

### Se o Git recusar seu push

Se o projeto mudou nesse meio-tempo, o Git rejeita o push:

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

Traga essas alterações primeiro e depois faça push de novo:

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

Um `git pull` simples pode parar com `fatal: Need to specify how to reconcile divergent branches.` A opção `--no-rebase` acima resolve isso: ela mescla os dois lados.

Se as mesmas linhas mudaram dos dois lados, o pull para com `CONFLICT (content): Merge conflict in main.tex`. Corrija o arquivo e depois execute:

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

Há duas coisas que o site não aceita:

* Outros branches: `! [remote rejected] feature -> feature (wrong branch)`. Só existe `main`, então envie seu trabalho para ele.
* Force push: `! [remote rejected] main -> main (forced push prohibited)`. Em vez disso, coloque suas alterações sobre o `main` atual.

### Se o Git disser 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>/'
```

O token está errado ou foi excluído, ou você digitou a senha da sua conta. Crie um novo token se não tiver mais o antigo, porque não é possível ver um token existente de novo.

## Excluir um token

Em **Account settings**, em **Git integration**, clique no ícone de exclusão ao lado do token e depois em **Delete** na caixa de diálogo. A partir daí, o Git responde `Authentication failed` para esse token.

![A caixa de diálogo 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)

Excluir um token

> [!NOTE]
>
> Para saber o que colaboradores com acesso somente leitura podem fazer, consulte o Q\&A da [integração com Git](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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