Passer au contenu principal
Travaillez sur un projet depuis votre propre ordinateur avec Git. Les modifications ne sont transférées que lorsque vous exécutez git pull ou git push.
Un administrateur doit d’abord activer l’intégration Git.

Créer un jeton

Git se connecte avec un jeton d’authentification Git, et non avec le mot de passe de votre compte.
1

Ouvrir les paramètres de votre compte

Cliquez sur Account, puis sur Account settings. Sous Git integration, cliquez sur Generate token. Une fois que vous avez un jeton, ce bouton s’appelle Add another token.
La section Git integration des paramètres du compte avec un bouton Generate token

L'intégration Git dans les paramètres du compte

2

Copier le jeton

Cliquez sur Copy et conservez le jeton en lieu sûr. Vous ne le voyez qu’une seule fois. Cliquez ensuite sur Close.
La boîte de dialogue du jeton d'authentification Git avec un bouton Copy

Votre nouveau jeton

3

Vérifier le jeton

La liste affiche maintenant le début du jeton, sa date de création et sa dernière utilisation. Il expire au bout d’un an. Vous pouvez avoir jusqu’à 10 jetons.
La liste des jetons avec un jeton

Vos jetons

Cloner un projet

1

Ouvrir l'intégration Git dans l'éditeur

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

Le panneau Integrations

2

Copier la commande

La boîte de dialogue Clone with Git affiche la commande, avec l’adresse de votre site et l’ID du projet. Cliquez sur Copy. Si vous n’avez pas encore de jeton, Go to settings ouvre les paramètres de votre compte dans un nouvel onglet.
La boîte de dialogue Clone with Git avec la commande git clone

La commande de clonage

3

L'exécuter

Collez la commande dans un terminal. Lorsque Git demande un mot de passe, collez votre jeton.
Un dossier portant l’ID du projet contient maintenant les fichiers du projet, sur la branche main. Pour choisir le nom du dossier, ajoutez-le à la fin de la commande.
Git demande le jeton chaque fois qu’il contacte le site. Pour qu’il soit mémorisé, activez un credential helper : Git le demande une dernière fois, puis le conserve. Le helper store le conserve non chiffré dans ~/.git-credentials.

Récupérer les modifications de l’éditeur

Dans le dossier, exécutez :
Git liste les fichiers modifiés. Les modifications faites dans l’éditeur arrivent sous forme de commits nommés Update on Overleaf..

Envoyer vos modifications

Faites un commit de vos modifications, puis envoyez-les avec push :
La dernière ligne de la sortie indique la branche qui a avancé :
Les modifications apparaissent dans l’éditeur, et un éditeur ouvert se met à jour de lui-même. Les nouveaux fichiers, dossiers et renommages apparaissent dans l’arborescence des fichiers. Dans History, votre modification est marquée You (via Git). Votre message de commit n’y est pas affiché.
L'historique du projet affichant la ligne envoyée, marquée You (via Git)

Un push dans l'historique du projet

Si Git refuse votre push

Si le projet a changé entre-temps, Git rejette le push :
Récupérez d’abord ces modifications, puis renvoyez :
Un simple git pull peut s’arrêter avec fatal: Need to specify how to reconcile divergent branches. L’option --no-rebase ci-dessus y répond : elle fusionne les deux côtés. Si les mêmes lignes ont changé des deux côtés, le pull s’arrête avec CONFLICT (content): Merge conflict in main.tex. Corrigez le fichier, puis :
Le site n’accepte pas deux choses :
  • Les autres branches : ! [remote rejected] feature -> feature (wrong branch). Seule main existe, envoyez donc votre travail sur celle-ci.
  • Les force push : ! [remote rejected] main -> main (forced push prohibited). Placez plutôt vos modifications par-dessus la main actuelle.

Si Git affiche Authentication failed

Le jeton est erroné ou a été supprimé, ou vous avez saisi le mot de passe de votre compte. Créez un nouveau jeton si vous ne l’avez plus, car vous ne pouvez pas revoir un jeton existant.

Supprimer un jeton

Dans Account settings, sous Git integration, cliquez sur l’icône de suppression à côté du jeton, puis sur Delete dans la boîte de dialogue. Dès lors, Git répond Authentication failed à ce jeton.
La boîte de dialogue Delete Authentication token

Supprimer un jeton

Pour savoir ce que peuvent faire les collaborateurs en lecture seule, consultez le Q&A de l’intégration Git.
Dernière modification le 20 novembre 2026