Saltar para o conteúdo principal
Conecte um projeto a um repositório do Gitea. As alterações vão nos dois sentidos, e só quando você clica em Sync: nada é sincronizado sozinho.
Um administrador precisa ativar primeiro a sincronização com Gitea.
Você faz isso uma vez.
1

Abra as configurações da conta

Clique em Account e depois em Account settings. Em Project synchronisation, encontre Gitea e clique em Link.
A seção Gitea das configurações da conta com um botão Link

Gitea nas configurações da conta

2

Autorize no Gitea

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

Verifique o vínculo

Você volta às configurações da conta. Uma mensagem verde informa que sua conta do Gitea está vinculada, e o botão agora diz Unlink.
A seção Gitea das configurações da conta com um botão Unlink

Sua conta do Gitea está vinculada

Se sua conta ainda não estiver vinculada, Import from Gitea e o cartão Gitea no editor pedem que você a vincule primeiro. Clique em Link to your Gitea 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 Gitea com um botão Link to your Gitea account

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 Gitea, 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 Gitea.
O menu New project com Import from Gitea

O menu New project

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. Um repositório vazio não aparece na lista: ele precisa de pelo menos um commit.
A caixa de diálogo Import from Gitea listando quatro repositórios

Seus repositórios do Gitea

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

O projeto importado

Exportar um projeto para um novo repositório

Isso cria um repositório a partir de um projeto 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 Gitea no editor

Abra o projeto. Na barra à esquerda, clique em Integrations e depois em Gitea.
O painel Integrations com o cartão Gitea

O painel Integrations

2

Preencha o repositório

Escolha o Owner, que pode ser você ou uma das suas organizações. Quando você escolhe uma organização, esse campo se chama Organization. Repository Name começa com o nome do projeto: se esse nome tiver espaços, altere-o, porque o Gitea não os aceita. A descrição é opcional, e Private vem selecionado por padrão. Clique em Create a Gitea repository.
O formulário Export Project to Gitea preenchido

Export Project to Gitea

Se o nome tiver espaços ou já estiver em uso, a caixa de diálogo diz Please check that the repository name is valid, and that you have permission to create the repository. Altere o nome e clique no botão de novo.
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 Gitea após a exportação

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 Gitea.Recent commits in Gitea lista o que vai entrar no projeto.
A caixa de diálogo Sync with Gitea listando um novo commit

Um novo commit esperando no Gitea

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 Gitea com uma mensagem de commit preenchida

A mensagem de commit das suas alterações

3

Clique em Sync

Clique em Sync. Os novos commits do Gitea 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ê por meio de um pull request, que fica no Gitea como registro.
4

Verifique o resultado

A caixa de diálogo mostra No new commits in Gitea since last merge. e o campo da mensagem de commit desaparece. Os arquivos no editor e os commits no Gitea estão atualizados.
A caixa de diálogo Sync with Gitea após a sincronização, sem novos commits

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. O Overleaf também abre um pull request a partir desse branch no Gitea.
A caixa de diálogo Sync with Gitea com um aviso de conflito de mesclagem

Um conflito

  1. Mescle esse branch no branch padrão com Git e corrija o conflito. 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. Se você clicar antes de o branch ser mesclado, a caixa de diálogo continua como está.
  3. O branch fica no Gitea e o pull request dele continua aberto. Feche o pull request e exclua o branch quando não precisar mais deles.
A mesma caixa de diálogo aparece quando uma regra de proteção de branch retém o pull request, por exemplo quando ele precisa de uma aprovação, mesmo que nenhuma linha esteja em conflito. Assim que a regra permitir, mescle o pull request no Gitea e clique em I have manually merged. Continue. Consulte Como a sincronização com o Gitea funciona. Faça isso quando não quiser mais que o projeto seja sincronizado.
1

Clique em Unlink

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

Confirme

Clique em Confirm. Isso só remove o vínculo: a conexão com um repositório do qual você é dono, mencionada no aviso, é uma opção que você terá depois, não algo que acontece agora.
A caixa de diálogo Sync with Gitea pedindo para confirmar a desvinculação

Confirme a desvinculação

3

Verifique o resultado

A caixa de diálogo agora mostra Export Project to Gitea. 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.
Em Account settings, em Gitea, clique em Unlink e depois em Unlink novamente na caixa de diálogo.
A caixa de diálogo Unlink Gitea Account

Desvincule sua conta

Seus projetos continuam vinculados aos repositórios. Você não pode sincronizá-los até vincular sua conta de novo.
Para saber quem pode fazer o quê em um projeto compartilhado, consulte Quem pode vincular e sincronizar.
Última modificação em 20 de novembro de 2026