Passer au contenu principal
Connectez un projet à un dépôt GitHub. Les modifications circulent dans les deux sens, et uniquement lorsque vous cliquez sur Sync : rien ne se synchronise tout seul.
Si vous ne voyez aucune option GitHub dans Account settings ni dans l’éditeur, demandez à votre administrateur d’activer la synchronisation GitHub.
Vous ne le faites qu’une fois.
1

Ouvrir les paramètres de votre compte

Cliquez sur Account, puis sur Account settings. Faites défiler jusqu’à GitHub et cliquez sur Link.
La section GitHub des paramètres du compte avec un bouton Link

GitHub dans les paramètres du compte

2

Autoriser sur GitHub

GitHub s’ouvre. Connectez-vous si on vous le demande, puis autorisez l’application.
3

Vérifier le lien

Vous revenez aux paramètres du compte, et le bouton indique maintenant Unlink.
La section GitHub des paramètres du compte avec un bouton Unlink

Votre compte GitHub est lié

Si votre compte n’est pas encore lié, Import from GitHub et la carte GitHub de l’éditeur vous demandent d’abord de le lier. Cliquez sur Link to your GitHub account. Vous arrivez également dans les paramètres du compte, dans un nouvel onglet si vous étiez dans l’éditeur. Revenez ensuite en arrière et recommencez.
La boîte de dialogue Import from GitHub avec un bouton Link to your GitHub account

L'invite lorsque votre compte n'est pas lié

Importer un dépôt

Cela crée un nouveau projet à partir d’un dépôt GitHub, déjà lié à celui-ci.
1

Ouvrir la boîte de dialogue d'importation

Sur la page des projets, cliquez sur New project, puis sur Import from GitHub.
Le menu New project avec Import from GitHub

Le menu New project

New project apparaît dès que vous avez un projet. Le menu Create a new project de la page d’accueil ne propose pas d’importation : créez donc d’abord un projet vide.
2

Choisir le dépôt

Cliquez sur Import to Overleaf à côté du dépôt. La liste contient vos dépôts et ceux de vos organisations.
La boîte de dialogue Import from GitHub listant quatre dépôts

Vos dépôts GitHub

S’il manque le dépôt d’une organisation, cliquez sur Can’t see what you’re looking for? pour consulter l’aide de GitHub sur l’approbation de l’application pour cette organisation.
3

Vérifier le projet

Le nouveau projet s’ouvre avec les fichiers du dépôt.
L'éditeur affichant le projet importé avec ses fichiers et le PDF compilé

Le projet importé

Exporter un projet vers un nouveau dépôt

Cela crée un dépôt à partir d’un projet dont vous êtes propriétaire et les lie. Un projet ne peut être lié que de cette façon ou par importation : vous ne pouvez pas le lier à un dépôt qui existe déjà.
1

Ouvrir GitHub dans l'éditeur

Ouvrez le projet. Dans la barre de gauche, cliquez sur Integrations, puis sur GitHub.
Le panneau Integrations avec la carte GitHub

Le panneau Integrations

2

Renseigner le dépôt

Choisissez l’Owner, qui peut être vous ou l’une de vos organisations. Repository Name reprend au départ le nom du projet. La description est facultative, et Private est sélectionné par défaut. Cliquez sur Create a GitHub repository.
Le formulaire Export Project to GitHub rempli

Export Project to GitHub

3

Vérifier le lien

La boîte de dialogue indique maintenant This project is linked to et nomme le dépôt.
La boîte de dialogue Sync with GitHub après l'exportation

Le projet est lié

Synchroniser

1

Ouvrir la boîte de dialogue de synchronisation

Ouvrez un projet lié. Dans la barre de gauche, cliquez sur Integrations, puis sur GitHub.Recent commits in GitHub liste ce qui va arriver dans le projet.
La boîte de dialogue Sync with GitHub listant un nouveau commit

Un nouveau commit en attente sur GitHub

2

Décrire vos modifications

Si vous avez modifié quelque chose dans le projet, un champ de message de commit apparaît. Il est facultatif : si vous le laissez vide, le commit s’appelle Updates from Overleaf.
La boîte de dialogue Sync with GitHub avec un message de commit rempli

Le message de commit de vos modifications

3

Cliquer sur Sync

Cliquez sur Sync. Les nouveaux commits de GitHub arrivent dans le projet, et vos modifications partent vers la branche par défaut du dépôt. Si les deux côtés ont modifié des choses différentes, elles sont fusionnées pour vous.
4

Vérifier le résultat

La boîte de dialogue affiche No new commits in GitHub since last merge. et le champ de message de commit a disparu. Les fichiers de l’éditeur et les commits sur GitHub sont à jour.
La boîte de dialogue Sync with GitHub après la synchronisation, sans nouveau commit

Tout est synchronisé

Si les mêmes lignes ont changé des deux côtés

La boîte de dialogue indique que les modifications n’ont pas pu être fusionnées et nomme une nouvelle branche, overleaf-YYYY-MM-DD-HHMMSS, qui contient vos modifications.
La boîte de dialogue Sync with GitHub avec un avertissement de conflit de fusion

Un conflit

  1. Fusionnez cette branche dans la branche par défaut sur GitHub ou avec Git. Vous pouvez fermer la boîte de dialogue entre-temps : elle affiche le même message lorsque vous la rouvrez.
  2. Cliquez sur I have manually merged. Continue. Le résultat fusionné arrive dans le projet.
  3. La branche reste sur GitHub. Supprimez-la lorsque vous n’en avez plus besoin.
Faites-le lorsque vous ne voulez plus que le projet se synchronise. Seul le propriétaire du projet peut le faire.
1

Cliquer sur Unlink

Dans la boîte de dialogue de synchronisation, cliquez sur Unlink.
2

Confirmer

Cliquez sur Confirm. La mention d’un abonnement ne vous empêche pas de lier à nouveau le projet.
La boîte de dialogue Sync with GitHub demandant de confirmer la suppression du lien

Confirmer la suppression du lien

3

Vérifier le résultat

La boîte de dialogue affiche maintenant Export Project to GitHub. Le projet et le dépôt conservent tous deux leur contenu. Pour synchroniser à nouveau, exportez le projet vers un nouveau dépôt, ou importez le dépôt dans un nouveau projet.
Dans Account settings, sous GitHub, cliquez sur Unlink, puis à nouveau sur Unlink dans la boîte de dialogue.
La boîte de dialogue Unlink GitHub Account

Supprimer le lien de votre compte

Vos projets restent liés à leurs dépôts. Vous ne pouvez pas les synchroniser tant que vous n’avez pas lié à nouveau votre compte.
Pour savoir qui peut faire quoi dans un projet partagé, consultez Qui peut lier et synchroniser. Chaque collaborateur qui synchronise lie son propre compte GitHub.
Dernière modification le 20 novembre 2026