# Comece com a colaboração em tempo real

Adicione o servidor de colaboração do seu grupo, faça login, abra um projeto que alguém compartilhou com você e gerencie seus servidores e dispositivos.

:::note[A colaboração em tempo real está em beta]
Você precisa do Oleafly 0.4.7-rc. Baixe-o na [página de lançamento](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc), porque a página de download ainda oferece a 0.4.6.
:::

Para participar de um projeto compartilhado, você precisa de duas coisas da pessoa que administra o servidor do seu grupo: o endereço dele e um jeito de entrar. Ela adiciona você pelo endereço de e-mail, pelo nome de usuário ou pelo domínio da sua instituição. O proprietário de um projeto também pode convidar você como convidado. Se os seus coautores usam o servidor do Oleafly, `collab.oleafly.com`, há um botão para ele em **Adicionar servidor**.

Se você recebeu um e-mail do servidor, ele tem um link **Adicionar ao Oleafly**. Selecione-o, e o Oleafly adiciona o servidor para você. Caso contrário, adicione-o à mão.

## Adicione o servidor

1. Abra **Configurações → Colaboração** e selecione **Adicionar servidor**.
2. Digite o **Endereço do servidor** que você recebeu, como `collab.example.edu`, e selecione **Continuar**. O Oleafly verifica o servidor antes de você fazer login. Os servidores de colaboração precisam de um endereço que use https.
3. Escolha uma forma de fazer login. As opções dependem do que o administrador do servidor configurou.

Para adicionar o servidor do Oleafly, selecione **Oleafly** no topo da caixa de diálogo, acima do campo de endereço. O Oleafly preenche `https://collab.oleafly.com`, verifica o servidor e segue para o login. O botão some quando esse servidor entra na sua lista e volta se você o remover.

A caixa de diálogo **Compartilhar** oferece o mesmo atalho. Se você ainda não adicionou nenhum servidor, ela tem **Adicionar o servidor do Oleafly**.

## Faça login

### Com a sua instituição ou o GitHub

Selecione **Continuar com** seguido da opção que você quer, como **Continuar com GitHub** ou o login da sua universidade. O navegador abre. Faça login nele e depois volte ao Oleafly. O Oleafly nunca vê a sua senha.

### Com um link por e-mail

Se o servidor oferecer essa opção, selecione **Continuar com e-mail**. Uma página do servidor abre no seu navegador.

1. Digite o seu endereço de e-mail e selecione **Me enviar um link por e-mail**.
2. Abra o e-mail no mesmo computador e selecione o botão **Fazer login**.
3. Na página que abre, selecione **Fazer login**. O Oleafly continua sozinho.

O link funciona uma vez, por 15 minutos. Se você já fez login neste servidor de outra forma com o mesmo endereço verificado, o link conecta você a essa mesma conta.

### Com um código

Alguns computadores não conseguem devolver o navegador ao Oleafly depois de um login, como uma máquina de laboratório bloqueada. Use **Fazer login com um código** nesses casos. O Oleafly também oferece essa opção quando um login pelo navegador leva mais de 20 segundos.

1. O Oleafly mostra um endereço do seu servidor e um código de oito letras.
2. Em qualquer celular ou computador, abra esse endereço, digite o código e selecione **Continuar**.
3. A página mostra o nome do computador que fez o pedido. Confira o nome e depois faça login com qualquer opção que o servidor ofereça. O Oleafly termina o login sozinho.

Um código funciona uma vez e deixa de funcionar depois de 10 minutos. Se você não iniciou o login, selecione **Parar, não fui eu**.

### Quando terminar

O Oleafly diz **Conectado a** e o nome do servidor. Selecione **Concluir**. O servidor agora aparece em **Configurações → Colaboração** como **Conectado**.

Se o servidor responder “Você ainda não está na lista deste servidor”, peça ao administrador dele que adicione você. [Solução de problemas](/docs/collaboration/troubleshooting/#sign-in-problems) cobre outras mensagens de login.

## Abra um projeto compartilhado com você

Os projetos compartilhados com você aparecem na biblioteca em **Compartilhados com você**, acima dos seus próprios projetos. Cada linha mostra o proprietário, o servidor e a sua função. Selecione **Abrir**. O Oleafly copia o projeto para a sua biblioteca e o abre.

A partir daí, o projeto fica na sua biblioteca como qualquer outro, com um selo **Compartilhado**. Os arquivos dele são arquivos de verdade na sua pasta de projetos. O documento principal e o motor dele são definidos para o projeto inteiro, então são os mesmos para todos.

### Abra um projeto por um link

As pessoas também podem enviar a você o link de um projeto.

- **Por e-mail**, o link abre o Oleafly diretamente.
- **De qualquer outro lugar**, abra **Importar** na biblioteca, escolha **Abrir link de projeto compartilhado…**, cole o link e selecione **Abrir**.

Antes de você participar, o Oleafly pergunta “Participar deste projeto compartilhado?” e mostra o projeto, o proprietário, o servidor e a sua função. Participar copia os arquivos do projeto para este computador. Só selecione **Participar** se você souber quem enviou o link.

Se o link pertence a um servidor que você ainda não adicionou, adicione primeiro o servidor e depois abra o link de novo.

## Comece a editar

Digite como em qualquer projeto. Suas alterações chegam aos outros enquanto você digita, e as deles chegam a você. [Trabalhe em conjunto](/docs/collaboration/working-together/) explica o que você vê na tela.

Se você é revisor, o que você digita vira uma sugestão. Se é comentarista, o editor é somente leitura, mas você pode selecionar texto e comentá-lo. Se é leitor, o editor é somente leitura, e você ainda pode ler, compilar e exportar. [Funções](/docs/collaboration/sharing/#roles) lista o que cada função pode fazer.

Se o servidor tem acesso pelo navegador, você também pode abrir o projeto em um navegador da web, sem o Oleafly. Leia [Trabalhe no navegador](/docs/collaboration/browser/).

## Escolha o que as outras pessoas veem

Em **O que as outras pessoas veem**, em **Configurações → Colaboração**, escolha uma opção:

- **Mostrar meu cursor**: as outras pessoas veem o seu cursor, a sua seleção e o arquivo em que você está.
- **Mostrar só em qual arquivo estou**: as outras pessoas veem o arquivo, mas não onde você está dentro dele.
- **Me ocultar**: as outras pessoas não veem o seu cursor nem em qual arquivo você está.

Defina isso separadamente em cada computador.

## Mais de um servidor

Você pode adicionar vários servidores, por exemplo um para o seu laboratório e outro para um projeto com outra universidade. Cada projeto compartilhado fica em um servidor. **Compartilhados com você** lista os projetos de todos os servidores em que você fez login.

## Seus dispositivos

Faça login em cada computador que você usa. O cartão do servidor em **Configurações → Colaboração** lista **Seus dispositivos**, com a data em que cada um foi adicionado e visto pela última vez. Selecione **Encerrar sessão** ao lado de um computador que você não usa mais. Esse computador para de sincronizar até alguém fazer login nele de novo.

Cada navegador da web em que você fez login no servidor também aparece na lista. **Encerrar sessão** ao lado de um navegador encerra a sessão dele.

Quando a sua conta faz login em um computador novo, o servidor envia por e-mail o nome do dispositivo, o sistema dele e a hora, se o servidor envia e-mails. Se não foi você, encerre a sessão desse dispositivo.

Em um computador compartilhado, cada pessoa precisa da própria conta de usuário. Se outra pessoa já fez login no servidor a partir da mesma conta de usuário, o Oleafly não conecta uma segunda pessoa.

## E-mails do servidor

Quando alguém adiciona você a um projeto, o servidor pode enviar a você por e-mail o título do projeto, quem o compartilhou, a sua função e um link que o abre. Para parar de receber esses e-mails, desative **Me avisar por e-mail quando alguém compartilhar um projeto** no cartão do servidor. Os projetos compartilhados com você continuam aparecendo em **Compartilhados com você**.

Quando alguém menciona você em um comentário, o servidor envia um e-mail sobre isso. Leia [Mencione alguém](/docs/collaboration/comments/#mention-someone).

Se o servidor não envia e-mails, você não recebe essas mensagens. Todo o resto funciona do mesmo jeito.

## Encerre a sessão

Selecione **Encerrar sessão** no cartão do servidor. O Oleafly primeiro tenta, por alguns segundos, enviar as alterações que o servidor ainda não tem.

Se algumas ainda não saíram, o Oleafly pergunta o que fazer com elas:

- **Manter uma cópia local** mantém cada um desses projetos neste computador como um projeto comum, não compartilhado, chamado “*projeto* (cópia local)”, com as suas alterações nele. Depois, encerra a sua sessão.
- **Continuar conectado** mantém você conectado, para você tentar de novo quando voltar a ficar online.

**Remover** no cartão do servidor encerra a sua sessão e esquece o servidor. Ele faz a mesma pergunta sobre as alterações não enviadas. Os projetos que já estão neste computador continuam onde estão.
