Naar hoofdinhoud gaan
Verbind een project met een Gitea-repository. Wijzigingen gaan in beide richtingen, en alleen wanneer u op Sync klikt: niets wordt vanzelf gesynchroniseerd.
Een beheerder moet eerst de Gitea-synchronisatie inschakelen.
Dit doet u één keer.
1

Open uw accountinstellingen

Klik op Account en daarna op Account settings. Zoek onder Project synchronisation naar Gitea en klik op Link.
De sectie Gitea van de accountinstellingen met een knop Link

Gitea in de accountinstellingen

2

Autoriseer op Gitea

Gitea wordt geopend. Meld u aan als daarom wordt gevraagd en autoriseer daarna de applicatie.
3

Controleer de koppeling

U bent terug in de accountinstellingen. Een groene melding geeft aan dat uw Gitea-account is gekoppeld, en op de knop staat nu Unlink.
De sectie Gitea van de accountinstellingen met een knop Unlink

Uw Gitea-account is gekoppeld

Als uw account nog niet is gekoppeld, vragen Import from Gitea en de kaart Gitea in de editor u om dat eerst te doen. Klik op Link to your Gitea account. Ook zo komt u in de accountinstellingen terecht, in een nieuw tabblad als u in de editor bent begonnen. Ga daarna terug en begin opnieuw.
Het dialoogvenster Import from Gitea met een knop Link to your Gitea account

De melding wanneer uw account niet is gekoppeld

Een repository importeren

Hiermee maakt u een nieuw project van een Gitea-repository, dat er al aan is gekoppeld.
1

Open het importvenster

Klik op de projectenpagina op New project en daarna op Import from Gitea.
Het menu New project met Import from Gitea

Het menu New project

2

Kies de repository

Klik op Import to Overleaf naast de repository. De lijst bevat uw repository’s en die van uw organisaties. Een lege repository wordt niet getoond: er is minstens één commit nodig.
Het dialoogvenster Import from Gitea met vier repository's

Uw Gitea-repository's

3

Controleer het project

Het nieuwe project wordt geopend met de bestanden van de repository.
De editor met het geïmporteerde project, de bestanden en de gecompileerde pdf

Het geïmporteerde project

Een project exporteren naar een nieuwe repository

Hiermee maakt u een repository van een project en koppelt u ze. Een project kan alleen op deze manier of door te importeren worden gekoppeld: u kunt het niet koppelen aan een repository die al bestaat.
1

Open Gitea in de editor

Open het project. Klik in de linkerbalk op Integrations en daarna op Gitea.
Het paneel Integrations met de kaart Gitea

Het paneel Integrations

2

Vul de repository in

Kies de Owner: uzelf of een van uw organisaties. Wanneer u een organisatie kiest, heet dit veld Organization. Repository Name begint als de naam van het project: als die naam spaties bevat, wijzig hem dan, want Gitea accepteert geen spaties. De beschrijving is optioneel, en Private is standaard geselecteerd. Klik op Create a Gitea repository.
Het ingevulde formulier Export Project to Gitea

Export Project to Gitea

Als de naam spaties bevat of al in gebruik is, toont het dialoogvenster Please check that the repository name is valid, and that you have permission to create the repository. Wijzig de naam en klik opnieuw op de knop.
3

Controleer de koppeling

Het dialoogvenster toont nu This project is linked to en de naam van de repository.
Het dialoogvenster Sync with Gitea na de export

Het project is gekoppeld

Synchroniseren

1

Open het synchronisatievenster

Open een gekoppeld project. Klik in de linkerbalk op Integrations en daarna op Gitea.Recent commits in Gitea toont wat er in het project binnenkomt.
Het dialoogvenster Sync with Gitea met één nieuwe commit

Een nieuwe commit wacht in Gitea

2

Beschrijf uw wijzigingen

Als u iets in het project hebt gewijzigd, verschijnt een veld voor het commitbericht. Het is optioneel: als u het leeg laat, heet de commit Updates from Overleaf.
Het dialoogvenster Sync with Gitea met een ingevuld commitbericht

Het commitbericht voor uw wijzigingen

3

Klik op Sync

Klik op Sync. Nieuwe commits uit Gitea komen in het project, en uw wijzigingen gaan naar de standaardbranch van de repository. Als beide kanten verschillende dingen hebben gewijzigd, worden ze voor u samengevoegd via een pull request, die als vastlegging op Gitea blijft staan.
4

Controleer het resultaat

Het dialoogvenster toont No new commits in Gitea since last merge. en het veld voor het commitbericht is verdwenen. De bestanden in de editor en de commits op Gitea zijn bijgewerkt.
Het dialoogvenster Sync with Gitea na het synchroniseren, zonder nieuwe commits

Alles is gesynchroniseerd

Als dezelfde regels aan beide kanten zijn gewijzigd

Het dialoogvenster meldt dat de wijzigingen niet konden worden samengevoegd en noemt een nieuwe branch, overleaf-YYYY-MM-DD-HHMMSS, die uw wijzigingen bevat. Overleaf opent ook een pull request vanuit die branch op Gitea.
Het dialoogvenster Sync with Gitea met een waarschuwing over een mergeconflict

Een conflict

  1. Voeg die branch met Git samen in de standaardbranch en los het conflict op. U kunt het dialoogvenster intussen sluiten: het toont dezelfde melding wanneer u het opnieuw opent.
  2. Klik op I have manually merged. Continue. Het samengevoegde resultaat komt in het project. Als u erop klikt voordat de branch is samengevoegd, blijft het dialoogvenster ongewijzigd.
  3. De branch blijft op Gitea staan en de bijbehorende pull request blijft open. Sluit de pull request en verwijder de branch wanneer u ze niet meer nodig hebt.
Hetzelfde dialoogvenster verschijnt wanneer een branchbeveiligingsregel de pull request tegenhoudt, bijvoorbeeld omdat er een goedkeuring nodig is, ook als er geen regels conflicteren. Zodra de regel het toestaat, voegt u de pull request samen op Gitea en klikt u op I have manually merged. Continue. Zie Hoe synchroniseren met Gitea werkt. Doe dit wanneer u niet meer wilt dat het project synchroniseert.
1

Klik op Unlink

Klik in het synchronisatievenster op Unlink.
2

Bevestig

Klik op Confirm. Dit verwijdert alleen de koppeling: de verbinding met een repository waarvan u eigenaar bent, die de waarschuwing noemt, is een mogelijkheid die u daarna hebt, niet iets wat nu gebeurt.
Het dialoogvenster Sync with Gitea dat vraagt om het ontkoppelen te bevestigen

Bevestig het ontkoppelen

3

Controleer het resultaat

Het dialoogvenster toont nu Export Project to Gitea. Het project en de repository behouden allebei hun inhoud. Om opnieuw te synchroniseren, exporteert u het project naar een nieuwe repository of importeert u de repository in een nieuw project.
Klik in Account settings, onder Gitea, op Unlink en daarna nogmaals op Unlink in het dialoogvenster.
Het dialoogvenster Unlink Gitea Account

Uw account ontkoppelen

Uw projecten blijven gekoppeld aan hun repository’s. U kunt ze pas weer synchroniseren wanneer u uw account opnieuw koppelt.
Wie wat kan doen in een gedeeld project, leest u in Wie kan koppelen en synchroniseren.
Laatst gewijzigd op 20 november 2026