> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Synchronisation Gitea

> Liez votre compte Gitea, importez ou exportez un projet, synchronisez les modifications dans les deux sens et supprimez le lien.

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.

> [!NOTE]
>
> Un administrateur doit d'abord activer la [synchronisation Gitea](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md).

## Lier votre compte 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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5514bcd66b524c3dde2376db09935feb)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b0eb94a11ff546a6770d4f5a8b5250de)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b9f6e8fc7d3aa2d3328423f660de5a9c)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=de3258081da7ec5af1083ae6c127d510)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9b8c86ed6705efddab590e0e8f62892c)

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é](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=bd72f7c7594e0f80e0966d4691598db3)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=12710e50eecf8f3b385565c85b4a45a4)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=867cf2d205d151a87dd35529b4e40d56)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=aa8d526d60f9733ba1885e73621ab8d6)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=0403560179cb63a6b5d3853f4590e6a5)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=014cd300d4deff341310920221c63a30)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=7a53483772e17e5ad75d5ceb7f44e34e)

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9acaf32d0930decd2cfce516037a37b1)

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.

   ```bash theme={null}
   git clone <repository-address>
   cd <repository-name>
   git merge origin/overleaf-YYYY-MM-DD-HHMMSS
   # fix the conflict in the file Git names
   git add <file>
   git commit
   git push
   ```
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](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#how-syncing-works-with-gitea).

## Supprimer le lien d'un projet

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=796d5581463a481fed1772d6695430d1)

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.

## Supprimer le lien de votre compte Gitea

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](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3995614c688a587c031de666d71ce64)

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.

> [!NOTE]
>
> Pour savoir qui peut faire quoi dans un projet partagé, consultez [Qui peut lier et synchroniser](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#who-can-link-and-sync).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.