Passer au contenu principal
Connectez un projet à un dépôt Gitea. Les modifications circulent dans les deux sens, et uniquement lorsque vous cliquez sur Sync : rien ne se synchronise tout seul.
Un administrateur doit d’abord activer la synchronisation Gitea.
Vous ne le faites qu’une fois.
1

Ouvrir les paramètres de votre compte

Cliquez sur Account, puis sur Account settings. Sous Project synchronisation, trouvez Gitea et cliquez sur Link.
La section Gitea des paramètres du compte avec un bouton Link

Gitea dans les paramètres du compte

2

Autoriser sur Gitea

Gitea 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. Un message vert indique que votre compte Gitea est lié, et le bouton indique maintenant Unlink.
La section Gitea des paramètres du compte avec un bouton Unlink

Votre compte Gitea est lié

Si votre compte n’est pas encore lié, Import from Gitea et la carte Gitea de l’éditeur vous demandent d’abord de le lier. Cliquez sur Link to your Gitea 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 Gitea avec un bouton Link to your Gitea 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 Gitea, 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 Gitea.
Le menu New project avec Import from Gitea

Le menu New project

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. Un dépôt vide n’est pas listé : il lui faut au moins un commit.
La boîte de dialogue Import from Gitea listant quatre dépôts

Vos dépôts Gitea

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 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 Gitea dans l'éditeur

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

Le panneau Integrations

2

Renseigner le dépôt

Choisissez l’Owner, qui peut être vous ou l’une de vos organisations. Lorsque vous choisissez une organisation, ce champ s’appelle Organization. Repository Name reprend au départ le nom du projet : si ce nom contient des espaces, modifiez-le, car Gitea ne les accepte pas. La description est facultative, et Private est sélectionné par défaut. Cliquez sur Create a Gitea repository.
Le formulaire Export Project to Gitea rempli

Export Project to Gitea

Si le nom contient des espaces ou est déjà pris, la boîte de dialogue affiche Please check that the repository name is valid, and that you have permission to create the repository. Changez le nom et cliquez à nouveau sur le bouton.
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 Gitea 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 Gitea.Recent commits in Gitea liste ce qui va arriver dans le projet.
La boîte de dialogue Sync with Gitea listant un nouveau commit

Un nouveau commit en attente sur Gitea

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 Gitea avec un message de commit rempli

Le message de commit de vos modifications

3

Cliquer sur Sync

Cliquez sur Sync. Les nouveaux commits de Gitea 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 via une pull request, qui reste sur Gitea comme trace.
4

Vérifier le résultat

La boîte de dialogue affiche No new commits in Gitea since last merge. et le champ de message de commit a disparu. Les fichiers de l’éditeur et les commits sur Gitea sont à jour.
La boîte de dialogue Sync with Gitea 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. Overleaf ouvre aussi une pull request depuis cette branche sur Gitea.
La boîte de dialogue Sync with Gitea avec un avertissement de conflit de fusion

Un conflit

  1. Fusionnez cette branche dans la branche par défaut avec Git, et corrigez le conflit. 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. Si vous cliquez avant que la branche soit fusionnée, la boîte de dialogue reste inchangée.
  3. La branche reste sur Gitea et sa pull request reste ouverte. Fermez la pull request et supprimez la branche lorsque vous n’en avez plus besoin.
La même boîte de dialogue apparaît lorsqu’une règle de protection de branche bloque la pull request, par exemple lorsqu’elle nécessite une approbation, même si aucune ligne n’est en conflit. Dès que la règle le permet, fusionnez la pull request sur Gitea et cliquez sur I have manually merged. Continue. Consultez Fonctionnement de la synchronisation avec Gitea. Faites-le lorsque vous ne voulez plus que le projet se synchronise.
1

Cliquer sur Unlink

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

Confirmer

Cliquez sur Confirm. Cela supprime uniquement le lien : la connexion à un dépôt dont vous êtes propriétaire, mentionnée dans l’avertissement, est une option dont vous disposez ensuite, pas quelque chose qui se produit maintenant.
La boîte de dialogue Sync with Gitea 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 Gitea. 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 Gitea, cliquez sur Unlink, puis à nouveau sur Unlink dans la boîte de dialogue.
La boîte de dialogue Unlink Gitea 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.
Dernière modification le 20 novembre 2026