# Prendre en main la collaboration en direct

Ajoutez le serveur de collaboration de votre groupe, connectez-vous, ouvrez un projet que quelqu'un a partagé avec vous, et gérez vos serveurs et vos appareils.

:::note[La collaboration en direct est en version bêta]
Il vous faut Oleafly 0.4.7-rc. Téléchargez-le depuis la [page des versions](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc), car la page de téléchargement propose encore la 0.4.6.
:::

Pour rejoindre un projet partagé, il vous faut deux choses de la part de la personne qui gère le serveur de votre groupe : son adresse, et un moyen d'y entrer. Elle vous ajoute par adresse courriel, par nom de connexion ou par le domaine de votre institution. Le propriétaire d'un projet peut aussi vous inviter en tant qu'invité. Si vos co-auteurs utilisent le serveur Oleafly, `collab.oleafly.com`, un bouton le propose dans **Ajouter un serveur**.

Si vous avez reçu un courriel du serveur, il contient un lien **Ajouter à Oleafly**. Sélectionnez-le et Oleafly ajoute le serveur pour vous. Sinon, ajoutez-le à la main.

## Ajouter le serveur

1. Ouvrez **Paramètres → Collaboration** et sélectionnez **Ajouter un serveur**.
2. Saisissez l'**adresse du serveur** qu'on vous a donnée, par exemple `collab.example.edu`, puis sélectionnez **Continuer**. Oleafly vérifie le serveur avant que vous vous connectiez. Les serveurs de collaboration exigent une adresse qui utilise https.
3. Choisissez un moyen de vous connecter. Les options dépendent de ce que l'administrateur du serveur a configuré.

Pour ajouter le serveur Oleafly, sélectionnez **Oleafly** en haut du dialogue, au-dessus du champ d'adresse. Oleafly saisit `https://collab.oleafly.com`, le vérifie et passe à la connexion. Le bouton disparaît une fois ce serveur dans votre liste, et revient si vous le retirez.

Le dialogue **Partager** propose le même raccourci. Si vous n'avez ajouté aucun serveur, il affiche **Ajouter le serveur Oleafly**.

## Se connecter

### Avec votre institution ou GitHub

Sélectionnez **Continuer avec**, puis l'option voulue, par exemple **Continuer avec GitHub** ou la connexion de votre université. Votre navigateur s'ouvre. Connectez-vous là-bas, puis revenez dans Oleafly. Oleafly ne voit jamais votre mot de passe.

### Avec un lien par courriel

Si le serveur le propose, sélectionnez **Continuer avec Courriel**. Une page du serveur s'ouvre dans votre navigateur.

1. Saisissez votre adresse courriel et sélectionnez **M'envoyer un lien par courriel**.
2. Ouvrez le courriel sur le même ordinateur et sélectionnez son bouton **Se connecter**.
3. Sur la page qui s'ouvre, sélectionnez **Se connecter**. Oleafly continue tout seul.

Le lien fonctionne une seule fois, pendant 15 minutes. Si vous vous êtes déjà connecté à ce serveur d'une autre façon avec la même adresse vérifiée, le lien vous connecte à ce même compte.

### Avec un code

Certains ordinateurs ne peuvent pas renvoyer le navigateur vers Oleafly après une connexion, par exemple une machine de laboratoire verrouillée. Utilisez-y **Se connecter avec un code**. Oleafly le propose aussi quand une connexion via le navigateur prend plus de 20 secondes.

1. Oleafly affiche une adresse sur votre serveur et un code de huit lettres.
2. Sur n'importe quel téléphone ou ordinateur, ouvrez cette adresse, saisissez le code et sélectionnez **Continuer**.
3. La page indique le nom de l'ordinateur à l'origine de la demande. Vérifiez ce nom, puis connectez-vous avec l'une des options proposées par le serveur. Oleafly termine la connexion tout seul.

Un code fonctionne une seule fois et cesse de fonctionner après 10 minutes. Si vous n'êtes pas à l'origine de cette connexion, sélectionnez **Arrêter, ce n'était pas moi**.

### Quand vous avez terminé

Oleafly affiche **Connecté à** suivi du nom du serveur. Sélectionnez **Terminé**. Le serveur apparaît alors dans **Paramètres → Collaboration** comme **Connecté**.

Si le serveur répond « Vous n'êtes pas encore sur la liste de ce serveur », demandez à son administrateur de vous ajouter. La page [Dépannage](/docs/collaboration/troubleshooting/#sign-in-problems) couvre les autres messages de connexion.

## Ouvrir un projet partagé avec vous

Les projets partagés avec vous apparaissent dans la bibliothèque sous **Partagés avec vous**, au-dessus de vos propres projets. Chaque ligne indique le propriétaire, le serveur et votre rôle. Sélectionnez **Ouvrir**. Oleafly copie le projet dans votre bibliothèque et l'ouvre.

Dès lors, le projet se trouve dans votre bibliothèque comme n'importe quel autre, avec une marque **Partagé**. Ses fichiers sont de vrais fichiers dans votre dossier de projets. Son document principal et son moteur sont définis pour tout le projet, donc ils sont les mêmes pour tout le monde.

### Ouvrir un projet depuis un lien

On peut aussi vous envoyer le lien d'un projet.

- **Depuis un courriel**, le lien ouvre Oleafly directement.
- **Depuis n'importe où ailleurs**, ouvrez **Importer** dans la bibliothèque, choisissez **Ouvrir un lien de projet partagé…**, collez le lien et sélectionnez **Ouvrir**.

Avant que vous rejoigniez le projet, Oleafly demande « Rejoindre ce projet partagé ? » et affiche le projet, son propriétaire, le serveur et votre rôle. Le rejoindre copie les fichiers du projet sur cet ordinateur. Ne sélectionnez **Rejoindre** que si vous savez qui vous a envoyé le lien.

Si le lien appartient à un serveur que vous n'avez pas encore ajouté, ajoutez d'abord le serveur, puis rouvrez le lien.

## Commencer à écrire

Tapez comme dans n'importe quel projet. Vos modifications atteignent les autres au fil de la frappe, et les leurs vous atteignent. La page [Travailler ensemble](/docs/collaboration/working-together/) explique ce que vous voyez à l'écran.

Si vous êtes relecteur, ce que vous tapez devient une suggestion. Si vous êtes commentateur, l'éditeur est en lecture seule, mais vous pouvez sélectionner du texte et le commenter. Si vous êtes lecteur, l'éditeur est en lecture seule, mais vous pouvez toujours lire, compiler et exporter. La page [Rôles](/docs/collaboration/sharing/#roles) indique ce que chaque rôle peut faire.

Si le serveur propose l'accès par navigateur, vous pouvez aussi ouvrir le projet dans un navigateur web, sans Oleafly. Lisez [Travailler dans un navigateur](/docs/collaboration/browser/).

## Choisir ce que les autres voient

Sous **Ce que les autres voient** dans **Paramètres → Collaboration**, choisissez une option :

- **Afficher mon curseur** : les autres voient votre curseur, votre sélection et le fichier dans lequel vous vous trouvez.
- **Afficher uniquement le fichier où je suis** : les autres voient le fichier, mais pas votre position dedans.
- **Me masquer** : les autres ne voient ni votre curseur, ni le fichier dans lequel vous êtes.

Réglez cela séparément sur chaque ordinateur.

## Plus d'un serveur

Vous pouvez ajouter plusieurs serveurs, par exemple un pour votre laboratoire et un pour un projet avec une autre université. Chaque projet partagé vit sur un seul serveur. **Partagés avec vous** liste les projets de tous les serveurs auxquels vous êtes connecté.

## Vos appareils

Connectez-vous sur chaque ordinateur que vous utilisez. La carte du serveur dans **Paramètres → Collaboration** liste **Vos appareils**, avec la date d'ajout et la date de dernière vue de chacun. Sélectionnez **Déconnecter** à côté d'un ordinateur que vous n'utilisez plus. Cet ordinateur cesse de se synchroniser jusqu'à ce que quelqu'un s'y connecte à nouveau.

Chaque navigateur web depuis lequel vous vous êtes connecté au serveur figure aussi dans la liste. **Déconnecter** à côté d'un navigateur y met fin à sa session.

Quand votre compte se connecte sur un nouvel ordinateur, le serveur vous envoie par courriel le nom de l'appareil, son système et l'heure, s'il envoie des courriels. Si ce n'était pas vous, déconnectez cet appareil.

Sur un ordinateur partagé, chaque personne doit avoir son propre compte utilisateur. Si quelqu'un d'autre s'est déjà connecté au serveur depuis le même compte utilisateur, Oleafly ne connectera pas une seconde personne.

## Courriels du serveur

Quand quelqu'un vous ajoute à un projet, le serveur peut vous envoyer par courriel le titre du projet, qui l'a partagé, votre rôle et un lien qui l'ouvre. Pour arrêter ces messages, désactivez **M'envoyer un courriel quand quelqu'un partage un projet** sur la carte du serveur. Les projets partagés avec vous continuent d'apparaître sous **Partagés avec vous**.

Quand quelqu'un vous mentionne dans un commentaire, le serveur vous envoie un courriel à ce sujet. Lisez [Mentionner quelqu'un](/docs/collaboration/comments/#mention-someone).

Si le serveur n'envoie pas de courriels, vous ne recevrez pas ces messages. Tout le reste fonctionne pareil.

## Se déconnecter

Sélectionnez **Se déconnecter** sur la carte du serveur. Oleafly essaie d'abord pendant quelques secondes d'envoyer les modifications que le serveur n'a pas encore.

S'il en reste qui ne sont pas parties, Oleafly demande quoi en faire :

- **Garder une copie locale** conserve chacun de ces projets sur cet ordinateur comme un projet ordinaire non partagé, nommé « *projet* (copie locale) », avec vos modifications dedans. Puis Oleafly vous déconnecte.
- **Rester connecté** vous garde connecté, pour pouvoir réessayer une fois de retour en ligne.

**Retirer** sur la carte du serveur vous déconnecte et fait oublier le serveur à Oleafly. Oleafly pose la même question à propos des modifications non envoyées. Les projets déjà présents sur cet ordinateur restent où ils sont.
