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

# Sincronização com GitHub

> Vincule sua conta do GitHub, importe ou exporte um projeto, sincronize alterações nos dois sentidos e desvincule.

Conecte um projeto a um repositório do GitHub. As alterações vão nos dois sentidos, e só quando você clica em **Sync**: nada é sincronizado sozinho.

> [!NOTE]
>
> Se você não vir nenhuma opção do GitHub em **Account settings** ou no editor, peça ao seu administrador para ativar a [sincronização com GitHub](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md).

## Vincular sua conta do GitHub

Você faz isso uma vez.

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

Clique em **Account** e depois em **Account settings**. Role até **GitHub** e clique em **Link**.

![A seção GitHub das configurações da conta com um botão Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8812ab1604914a8aa6c1f0937f0e1b2e)

GitHub nas configurações da conta

**2. Autorize no GitHub**

O GitHub abre. Faça login se for solicitado e depois autorize o aplicativo.

**3. Verifique o vínculo**

Você volta às configurações da conta, e o botão agora diz **Unlink**.

![A seção GitHub das configurações da conta com um botão Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=910b756aa0adea66bda5bb2e5776214e)

Sua conta do GitHub está vinculada

Se sua conta ainda não estiver vinculada, **Import from GitHub** e o cartão **GitHub** no editor pedem que você a vincule primeiro. Clique em **Link to your GitHub account**. Você também chega às configurações da conta, em uma nova aba se tiver começado no editor. Depois volte e comece de novo.

![A caixa de diálogo Import from GitHub com um botão Link to your GitHub account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=05546893169a57f837a8938f904db194)

O aviso quando sua conta não está vinculada

## Importar um repositório

Isso cria um novo projeto a partir de um repositório do GitHub, já vinculado a ele.

**1. Abra a caixa de diálogo de importação**

Na página de projetos, clique em **New project** e depois em **Import from GitHub**.

![O menu New project com Import from GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=384e6663f982016a5c295f35c4709413)

O menu New project

> [!NOTE]
>
> **New project** aparece quando você tem um projeto. O menu **Create a new project** da página de boas-vindas não tem importação, então crie primeiro um projeto em branco.

**2. Escolha o repositório**

Clique em **Import to Overleaf** ao lado do repositório. A lista inclui seus repositórios e os das suas organizações.

![A caixa de diálogo Import from GitHub listando quatro repositórios](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=54a0bd11655ddbfad4ae16e5e7473b74)

Seus repositórios do GitHub

Se faltar o repositório de uma organização, clique em **Can't see what you're looking for?** para ver a ajuda do GitHub sobre como aprovar o aplicativo para essa organização.

**3. Verifique o projeto**

O novo projeto abre com os arquivos do repositório.

![O editor mostrando o projeto importado com seus arquivos e o PDF compilado](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=90dfe6947c2e0ed420abfc8c81992768)

O projeto importado

## Exportar um projeto para um novo repositório

Isso cria um repositório a partir de um projeto do qual você é dono e os vincula. Um projeto só pode ser vinculado dessa forma ou por importação: não é possível vinculá-lo a um repositório que já existe.

**1. Abra o GitHub no editor**

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

![O painel Integrations com o cartão GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5c96ec0031a5940c337393254b06e0d3)

O painel Integrations

**2. Preencha o repositório**

Escolha o **Owner**, que pode ser você ou uma das suas organizações. **Repository Name** começa com o nome do projeto. A descrição é opcional, e **Private** vem selecionado por padrão. Clique em **Create a GitHub repository**.

![O formulário Export Project to GitHub preenchido](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=24bd26a171943d43efaa3c4aed69d1e8)

Export Project to GitHub

**3. Verifique o vínculo**

A caixa de diálogo agora diz **This project is linked to** e nomeia o repositório.

![A caixa de diálogo Sync with GitHub após a exportação](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=93ebf2c62d4a34c7d2c41ffbca9d0740)

O projeto está vinculado

## Sincronizar

**1. Abra a caixa de diálogo de sincronização**

Abra um projeto vinculado. Na barra à esquerda, clique em **Integrations** e depois em **GitHub**.

**Recent commits in GitHub** lista o que vai entrar no projeto.

![A caixa de diálogo Sync with GitHub listando um novo commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6a3c23a6993f04d0fa818bceb565ce3e)

Um novo commit esperando no GitHub

**2. Descreva suas alterações**

Se você alterou algo no projeto, aparece um campo para a mensagem de commit. Ele é opcional: se você deixá-lo vazio, o commit se chama `Updates from Overleaf`.

![A caixa de diálogo Sync with GitHub com uma mensagem de commit preenchida](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3fe2cbcae8335c7363fcd220d2b993c)

A mensagem de commit das suas alterações

**3. Clique em Sync**

Clique em **Sync**. Os novos commits do GitHub entram no projeto, e suas alterações vão para o branch padrão do repositório. Se os dois lados alteraram coisas diferentes, elas são mescladas para você.

**4. Verifique o resultado**

A caixa de diálogo mostra **No new commits in GitHub since last merge.** e o campo da mensagem de commit desaparece. Os arquivos no editor e os commits no GitHub estão atualizados.

![A caixa de diálogo Sync with GitHub após a sincronização, sem novos commits](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=851a620d8601a3ebaf9260f0f1c1685a)

Tudo está sincronizado

### Se as mesmas linhas mudaram dos dois lados

A caixa de diálogo informa que as alterações não puderam ser mescladas e nomeia um novo branch, `overleaf-YYYY-MM-DD-HHMMSS`, que contém suas alterações.

![A caixa de diálogo Sync with GitHub com um aviso de conflito de mesclagem](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b67dd69bb98605672da34b3a372be582)

Um conflito

1. Mescle esse branch no branch padrão no GitHub ou com Git. Você pode fechar a caixa de diálogo nesse meio-tempo: ela mostra a mesma mensagem quando você a abre de novo.
2. Clique em **I have manually merged. Continue**. O resultado mesclado entra no projeto.
3. O branch fica no GitHub. Exclua-o quando não precisar mais dele.

## Desvincular um projeto

Faça isso quando não quiser mais que o projeto seja sincronizado. Só o dono do projeto pode fazer isso.

**1. Clique em Unlink**

Na caixa de diálogo de sincronização, clique em **Unlink**.

**2. Confirme**

Clique em **Confirm**. A observação sobre uma assinatura não impede que você vincule o projeto de novo.

![A caixa de diálogo Sync with GitHub pedindo para confirmar a desvinculação](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f2e541c2e9e8d000baa0dacd28a328)

Confirme a desvinculação

**3. Verifique o resultado**

A caixa de diálogo agora mostra **Export Project to GitHub**. O projeto e o repositório mantêm seu conteúdo. Para sincronizar de novo, exporte o projeto para um novo repositório ou importe o repositório para um novo projeto.

## Desvincular sua conta do GitHub

Em **Account settings**, em **GitHub**, clique em **Unlink** e depois em **Unlink** novamente na caixa de diálogo.

![A caixa de diálogo Unlink GitHub Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=94ce090cb4d8b98231886319d6e6d903)

Desvincule sua conta

Seus projetos continuam vinculados aos repositórios. Você não pode sincronizá-los até vincular sua conta de novo.

> [!NOTE]
>
> Para saber quem pode fazer o quê em um projeto compartilhado, consulte [Quem pode vincular e sincronizar](https://ayakaleaf-pro.mintlify.site/pt/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md#who-can-link-and-sync). Cada colaborador que sincroniza vincula a própria conta do GitHub.


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