# Synchronisation GitHub

Connectez GitHub avec un code d'appareil ou un jeton, publiez un projet comme dépôt nouveau ou existant, poussez et tirez entre machines, et découvrez comment votre jeton est protégé.

La synchronisation GitHub est une sauvegarde facultative hors de la machine et un relais entre plusieurs ordinateurs, bâtie sur le [vrai dépôt Git](/docs/git-history/) qu'est déjà chaque projet. Les commits locaux fonctionnent sans GitHub. Quand vous vous connectez, il n'y a toujours aucun compte Oleafly dans l'image : seulement votre GitHub.

## Connecter votre compte

Paramètres, **Intégrations**, **GitHub**, puis l'une ou l'autre voie :

- **Connecter GitHub** (recommandé) : un flux à code d'appareil. Oleafly affiche un code court, votre navigateur ouvre `github.com/login/device` (avec un bouton **Copier** pour le code), vous approuvez, et l'application le détecte en quelques secondes. La connexion ne demande que les portées `repo` et `read:user`.
- **Jeton d'accès personnel** : dépliez « Avancé : utiliser un jeton d'accès personnel » et collez un PAT si vous préférez créer vos propres identifiants.

Une fois connecté, votre avatar et votre nom d'utilisateur apparaissent dans Paramètres et dans le menu GitHub de la barre d'outils supérieure. **Déconnecter** oublie le jeton.

### Comment votre jeton est protégé

Le jeton est stocké dans un fichier local chiffré AES-256-GCM, restreint à son propriétaire, et n'est jamais transmis à la couche d'interface de l'application ; l'interface ne connaît jamais que « connecté en tant que @vous ». Quand Git doit s'authentifier, le jeton est injecté par un assistant d'identification en mémoire, donc il n'apparaît jamais dans une ligne de commande, dans `.git/config` ni dans l'historique de votre shell. Les anciennes versions qui incorporaient des jetons dans les URL distantes sont nettoyées automatiquement au démarrage.

## Publier un projet

Dans le panneau Contrôle de version, cliquez sur **Publier sur GitHub** :

- **Créer un dépôt** : choisissez un nom (prérempli depuis le projet), gardez **Privé** (recommandé) coché ou non, puis **Créer et pousser**. Oleafly crée le dépôt, valide les fichiers du projet, configure `origin` et pousse.
- **Lier un dépôt existant** : choisissez dans une liste filtrable de vos dépôts (les privés affichent un cadenas), puis **Lier et pousser**.

Après la publication, le menu GitHub de la barre d'outils propose **Ouvrir dans GitHub** et **Copier le lien du dépôt**.

### Les fichiers qui ressemblent à des secrets restent locaux

La publication ne valide jamais les fichiers qui contiennent habituellement des clés ou des mots de passe, comme `.env`, `*.pem`, les clés privées SSH ou `credentials.json`. Ils restent dans le dossier du projet, non indexés, et la boîte de dialogue les nomme. Pour en publier un quand même, indexez-le et validez-le vous-même dans le Contrôle de version. Les modèles comme `.env.example`, les clés publiques et les fichiers Keynote `.key` sont publiés comme d'habitude.

Un push téléverse tout l'historique. Si un fichier portant l'un de ces noms a déjà été validé, Oleafly le liste et attend **Annuler** ou **Publier quand même** avant de créer quoi que ce soit sur GitHub.

## Synchronisation au quotidien

Les boutons **Pousser** et **Tirer** du panneau Contrôle de version font ce qu'ils annoncent, vers `origin` sur votre branche actuelle. **Récupérer** et **Synchroniser** sont dans le menu **Plus d'actions de contrôle de version**, et **Valider et pousser** et **Valider et synchroniser** sont dans le menu à côté de **Valider**. L'indicateur **d'avance/retard** (↑ ↓) à côté de la pastille de branche vous dit quand il y a quelque chose à pousser ou tirer.

### Deux ordinateurs

1. Sur la machine A : publiez le projet, travaillez, **Pousser**.
2. Sur la machine B : connectez le même compte GitHub, puis choisissez **Importer un projet → GitHub** et sélectionnez le dépôt. Voir le [guide d'importation](/docs/import-project/#import-from-github). Dès lors, **Tirer**, travaillez, **Pousser**.
3. De retour sur A : **Tirer** avant de commencer. L'indicateur vous le rappelle.

La couleur de couverture, le choix du document principal et l'historique voyagent tous, parce qu'ils vivent dans le dossier du projet lui-même.

## Changer d'avis

Une fois un distant configuré, le menu **Plus d'actions de contrôle de version** contient deux éléments de plus :

- **Changer de dépôt** rouvre la boîte de dialogue de publication pour pointer `origin` ailleurs.
- **Délier** retire le distant ; le projet local et son historique restent intacts.

## Conflits et branches

Si un tirage rencontre un conflit de fusion, le Contrôle de version liste les fichiers en conflit. Choisissez **Garder la version actuelle** ou **Prendre la version entrante** pour chacun, ou modifiez le fichier et choisissez **Marquer comme résolu**, puis **Terminer la fusion**. **Abandonner la fusion** remet les fichiers comme ils étaient. Pousser et Tirer agissent sur la branche extraite, et le menu de branche en haut du panneau change ou crée des branches. Voir [Git et le contrôle de version](/docs/git-history/#branches-and-stashes).

## Limites, dites franchement

Oleafly authentifie les distants HTTPS. La publication en configure un correctement pour vous.

## Si quelque chose échoue

- « Pas de distant 'origin' » : publiez d'abord ; Pousser et Tirer ont besoin d'un distant.
- Push rejeté parce que le distant a des commits : tirez d'abord, puis poussez.
- « Aucun jeton GitHub défini » : connectez-vous dans Paramètres, Intégrations, GitHub.

Plus dans la [FAQ](/docs/faq/#history-and-collaboration).
