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

Open uw accountinstellingen

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

GitLab in de accountinstellingen

2

Autoriseer op GitLab

GitLab 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 GitLab-account is gekoppeld, en op de knop staat nu Unlink.
De sectie GitLab van de accountinstellingen met een knop Unlink

Uw GitLab-account is gekoppeld

Als uw account nog niet is gekoppeld, vragen Import from GitLab en de kaart GitLab in de editor u om dat eerst te doen. Klik op Link to your GitLab 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 GitLab met een knop Link to your GitLab account

De melding wanneer uw account niet is gekoppeld

Een repository importeren

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

Open het importvenster

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

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 groepen.
Het dialoogvenster Import from GitLab met vier repository's

Uw GitLab-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 GitLab in de editor

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

Het paneel Integrations

2

Vul de repository in

Kies de Owner: uzelf of een van uw groepen. Wanneer u een groep kiest, heet dit veld Organization. Repository Name begint als de naam van het project. De beschrijving is optioneel, en Private is standaard geselecteerd. Klik op Create a GitLab repository.
Het ingevulde formulier Export Project to GitLab

Export Project to GitLab

Als de naam 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 GitLab 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 GitLab.Recent commits in GitLab toont wat er in het project binnenkomt.
Het dialoogvenster Sync with GitLab met één nieuwe commit

Een nieuwe commit wacht in GitLab

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 GitLab met een ingevuld commitbericht

Het commitbericht voor uw wijzigingen

3

Klik op Sync

Klik op Sync. Nieuwe commits uit GitLab 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.
4

Controleer het resultaat

Het dialoogvenster toont No new commits in GitLab since last merge. en het veld voor het commitbericht is verdwenen. De bestanden in de editor en de commits op GitLab zijn bijgewerkt.
Het dialoogvenster Sync with GitLab 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 merge request vanuit die branch op GitLab.
Het dialoogvenster Sync with GitLab met een waarschuwing over een mergeconflict

Een conflict

  1. Voeg die branch op GitLab of met Git samen in de standaardbranch. 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 GitLab staan, tenzij u hem bij het samenvoegen hebt verwijderd. Verwijder hem wanneer u hem niet meer nodig hebt.
Hetzelfde dialoogvenster verschijnt wanneer de mergeregels van de repository de merge request tegenhouden, bijvoorbeeld omdat er een goedkeuring nodig is, ook als er geen regels conflicteren. Zodra de regel het toestaat, voegt u de merge request samen op GitLab en klikt u op I have manually merged. Continue. Zie Hoe synchroniseren met GitLab 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 GitLab dat vraagt om het ontkoppelen te bevestigen

Bevestig het ontkoppelen

3

Controleer het resultaat

Het dialoogvenster toont nu Export Project to GitLab. 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 GitLab, op Unlink en daarna nogmaals op Unlink in het dialoogvenster.
Het dialoogvenster Unlink GitLab 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