Naar hoofdinhoud gaan
Verbind een project met een GitHub-repository. Wijzigingen gaan in beide richtingen, en alleen wanneer u op Sync klikt: niets wordt vanzelf gesynchroniseerd.
Als u geen GitHub-optie ziet in Account settings of in de editor, vraag uw beheerder dan om GitHub-synchronisatie in te schakelen.
Dit doet u één keer.
1

Open uw accountinstellingen

Klik op Account en daarna op Account settings. Scrol naar GitHub en klik op Link.
De sectie GitHub van de accountinstellingen met een knop Link

GitHub in de accountinstellingen

2

Autoriseer op GitHub

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

Controleer de koppeling

U bent terug in de accountinstellingen, en op de knop staat nu Unlink.
De sectie GitHub van de accountinstellingen met een knop Unlink

Uw GitHub-account is gekoppeld

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

De melding wanneer uw account niet is gekoppeld

Een repository importeren

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

Open het importvenster

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

Het menu New project

New project verschijnt zodra u een project hebt. Het menu Create a new project op de welkomstpagina heeft geen import, dus maak eerst een leeg project aan.
2

Kies de repository

Klik op Import to Overleaf naast de repository. De lijst bevat uw repository’s en die van uw organisaties.
Het dialoogvenster Import from GitHub met vier repository's

Uw GitHub-repository's

Als de repository van een organisatie ontbreekt, klikt u op Can’t see what you’re looking for? voor de hulp van GitHub over het goedkeuren van de applicatie voor die organisatie.
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 waarvan u eigenaar bent 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 GitHub in de editor

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

Het paneel Integrations

2

Vul de repository in

Kies de Owner: uzelf of een van uw organisaties. Repository Name begint als de naam van het project. De beschrijving is optioneel, en Private is standaard geselecteerd. Klik op Create a GitHub repository.
Het ingevulde formulier Export Project to GitHub

Export Project to GitHub

3

Controleer de koppeling

Het dialoogvenster toont nu This project is linked to en de naam van de repository.
Het dialoogvenster Sync with GitHub 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 GitHub.Recent commits in GitHub toont wat er in het project binnenkomt.
Het dialoogvenster Sync with GitHub met één nieuwe commit

Een nieuwe commit wacht in GitHub

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

Het commitbericht voor uw wijzigingen

3

Klik op Sync

Klik op Sync. Nieuwe commits uit GitHub 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 GitHub since last merge. en het veld voor het commitbericht is verdwenen. De bestanden in de editor en de commits op GitHub zijn bijgewerkt.
Het dialoogvenster Sync with GitHub 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.
Het dialoogvenster Sync with GitHub met een waarschuwing over een mergeconflict

Een conflict

  1. Voeg die branch op GitHub 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.
  3. De branch blijft op GitHub staan. Verwijder hem wanneer u hem niet meer nodig hebt.
Doe dit wanneer u niet meer wilt dat het project synchroniseert. Alleen de eigenaar van het project kan dit.
1

Klik op Unlink

Klik in het synchronisatievenster op Unlink.
2

Bevestig

Klik op Confirm. De opmerking over een abonnement houdt u niet tegen om het project opnieuw te koppelen.
Het dialoogvenster Sync with GitHub dat vraagt om het ontkoppelen te bevestigen

Bevestig het ontkoppelen

3

Controleer het resultaat

Het dialoogvenster toont nu Export Project to GitHub. 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 GitHub, op Unlink en daarna nogmaals op Unlink in het dialoogvenster.
Het dialoogvenster Unlink GitHub 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. Elke medewerker die synchroniseert, koppelt zijn eigen GitHub-account.
Laatst gewijzigd op 20 november 2026