# 开始使用实时协作

添加你所在小组的协作服务器，登录，打开别人与你共享的项目，并管理你的服务器和设备。

:::note[实时协作处于测试阶段]
你需要 Oleafly 0.4.7-rc。请从[发布页面](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)下载，因为下载页面仍然提供 0.4.6。
:::

要加入一个共享项目，你需要向运行你所在小组服务器的人索取两样东西：它的地址，以及进入的方式。他们会按电子邮箱地址、登录名或你所在机构的域名添加你。项目所有者也可以邀请你成为访客。如果你的合作作者使用 Oleafly 服务器 `collab.oleafly.com`，**添加服务器**中有一个对应的按钮。

如果你收到了服务器发来的邮件，里面有一个 **Add to Oleafly** 链接。点击它，Oleafly 会为你添加服务器。否则，请手动添加。

## 添加服务器

1. 打开**设置 → 协作**，选择**添加服务器**。
2. 输入你拿到的**服务器地址**，例如 `collab.example.edu`，然后选择**继续**。Oleafly 会在你登录之前检查该服务器。协作服务器需要使用 https 的地址。
3. 选择一种登录方式。可用的选项取决于服务器管理员的设置。

要添加 Oleafly 服务器，请在对话框顶部、地址输入框上方选择 **Oleafly**。Oleafly 会填入 `https://collab.oleafly.com`，检查它，然后进入登录步骤。该服务器加入你的列表后，这个按钮就会消失；如果你移除该服务器，按钮会重新出现。

**共享**对话框也提供同样的捷径。如果你还没有添加任何服务器，它会显示**添加 Oleafly 服务器**。

## 登录

### 使用你的机构或 GitHub

选择与你想要的方式对应的“使用……继续”，例如**使用 GitHub 继续**或你所在大学的登录。浏览器会打开。在那里登录，然后回到 Oleafly。Oleafly 永远看不到你的密码。

### 使用电子邮件链接

如果服务器提供，请选择**使用电子邮件继续**。服务器的一个页面会在浏览器中打开。

1. 输入你的电子邮箱地址并选择**发送链接到我的邮箱**。
2. 在同一台电脑上打开邮件，并点击其中的**登录**按钮。
3. 在打开的页面上，选择**登录**。Oleafly 会自动继续。

这个链接只能使用一次，有效期 15 分钟。如果你已经用另一种方式、以同一个已验证的地址登录过这台服务器，这个链接会让你登录到同一个账户。

### 使用登录码

有些电脑在登录后无法把浏览器交还给 Oleafly，例如被严格锁定的实验室电脑。请在那里使用**用登录码登录**。当浏览器登录耗时超过 20 秒时，Oleafly 也会提供它。

1. Oleafly 会显示你的服务器上的一个地址和一个八位字母的登录码。
2. 在任何手机或电脑上打开该地址，输入登录码并选择**继续**。
3. 页面会写明发起请求的电脑名称。核对名称，然后用服务器提供的任一方式登录。Oleafly 会自动完成登录。

登录码只能使用一次，10 分钟后失效。如果登录不是你发起的，请选择**停止，这不是我**。

### 完成之后

Oleafly 会显示**已连接到**和服务器的名称。选择**完成**。该服务器现在会出现在**设置 → 协作**中，状态为**已登录**。

如果服务器回复“你还不在此服务器的名单上”，请让它的管理员添加你。[故障排除](/docs/collaboration/troubleshooting/#sign-in-problems)介绍了其他登录消息。

## 打开与你共享的项目

与你共享的项目会出现在库中你自己的项目上方的**与你共享的项目**下。每一行写明所有者、服务器和你的角色。选择**打开**。Oleafly 会把项目复制到你的库中并打开它。

从那以后，该项目就像其他项目一样放在你的库中，带有**已共享**标记。它的文件是你的项目文件夹中的真实文件。它的主文档和引擎是为整个项目设置的，因此对每个人都一样。

### 通过链接打开项目

别人也可以把项目的链接发给你。

- **来自邮件**的链接会直接打开 Oleafly。
- **来自其他任何地方**时，请在库中打开**导入**，选择**打开共享项目链接…**，粘贴链接并选择**打开**。

在你加入之前，Oleafly 会询问“加入此共享项目？”，并显示项目、它的所有者、服务器和你的角色。加入会把项目的文件复制到这台电脑上。只有在你知道链接是谁发给你的时候，才选择**加入**。

如果链接属于你还没有添加的服务器，请先添加该服务器，然后再次打开链接。

## 开始编辑

像在任何项目中一样输入。你的更改会在你输入时传到其他人那里，他们的更改也会传到你这里。[一起工作](/docs/collaboration/working-together/)说明了你会在屏幕上看到什么。

如果你是审阅者，你输入的内容会变成建议。如果你是评论者，编辑器是只读的，但你可以选中文本并发表评论。如果你是查看者，编辑器是只读的，你仍然可以阅读、编译和导出。[角色](/docs/collaboration/sharing/#roles)列出了每个角色可以做什么。

如果服务器开启了浏览器访问，你也可以不用 Oleafly，直接在网页浏览器中打开项目。请阅读[在浏览器中工作](/docs/collaboration/browser/)。

## 选择其他人看到的内容

在**设置 → 协作**的**其他人看到的内容**下，选择其中一项：

- **显示我的光标**：其他人会看到你的光标、你的选区和你所在的文件。
- **仅显示我在哪个文件中**：其他人会看到文件，但看不到你在文件中的位置。
- **隐藏我**：其他人看不到你的光标，也看不到你在哪个文件中。

请在每台电脑上分别设置。

## 多台服务器

你可以添加多台服务器，例如一台给你的实验室，一台给与另一所大学合作的项目。每个共享项目位于一台服务器上。**与你共享的项目**列出了你已登录的所有服务器上的项目。

## 你的设备

请在你使用的每台电脑上登录。**设置 → 协作**中该服务器的卡片会列出**你的设备**，并显示每台设备的添加日期和上次出现的时间。对你不再使用的电脑，选择它旁边的**退出登录**。那台电脑会停止同步，直到有人再次在上面登录。

你用来登录该服务器的每个网页浏览器也在这个列表中。点击浏览器旁边的**退出登录**，会结束它在那里的会话。

当你的账户在一台新电脑上登录时，如果服务器会发送邮件，它会用邮件告诉你这台设备的名称、系统和时间。如果不是你本人，请让那台设备退出登录。

在共享的电脑上，每个人都需要自己的用户账户。如果已经有其他人用同一个用户账户登录过该服务器，Oleafly 不会让第二个人登录。

## 来自服务器的邮件

当有人把你添加到项目时，服务器可以给你发邮件，写明项目标题、是谁共享的、你的角色，以及一个打开项目的链接。要停止这些邮件，请在该服务器的卡片上关闭**有人共享项目时给我发邮件**。与你共享的项目仍会显示在**与你共享的项目**下。

当有人在评论中提到你时，服务器会就此给你发邮件。请阅读[提及某人](/docs/collaboration/comments/#mention-someone)。

如果服务器不发送邮件，你就收不到这些消息。其他一切功能照常工作。

## 退出登录

在该服务器的卡片上选择**退出登录**。Oleafly 会先花几秒钟尝试发送服务器还没有的所有更改。

如果仍有一些没有发出去，Oleafly 会询问你如何处理：

- **保留本地副本**会把这些项目中的每一个，作为普通的、未共享的项目保留在这台电脑上，名称为“*项目名*（本地副本）”，其中包含你的更改。然后让你退出登录。
- **保持登录**会让你保持登录，这样你重新联网后可以再试一次。

该服务器卡片上的**移除**会让你退出登录并忘记这台服务器。它会就未发送的更改提出同样的问题。已经在这台电脑上的项目保持原位。
