# 開始使用即時協作

新增你團隊的協作伺服器、登入、開啟別人與你共用的專案，並管理你的伺服器與裝置。

:::note[即時協作為測試版]
你需要 Oleafly 0.4.7-rc。請從[發行頁面](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)下載，因為下載頁面仍提供 0.4.6。
:::

要加入共用專案，你需要向負責執行團隊伺服器的人取得兩樣東西：伺服器的位址，以及進入的方式。他們會依電子郵件地址、登入名稱或你所屬機構的網域來新增你。專案擁有者也可以邀請你成為訪客。如果你的共同作者使用 Oleafly 伺服器 `collab.oleafly.com`，**新增伺服器** 中有一個專門的按鈕。

如果你收到伺服器寄來的電子郵件，裡面有一個 **新增至 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 會詢問要如何處理：

- **保留本機副本** 會把每個這類專案留在這台電腦上，成為一個未共用的一般專案，名稱為「*專案名稱*（本機副本）」，其中包含你的變更。接著它會讓你登出。
- **保持登入** 會讓你維持登入狀態，等你重新上線後可以再試一次。

伺服器卡片上的 **移除** 會讓你登出並忘記該伺服器。它會針對尚未送出的變更問同樣的問題。已經在這台電腦上的專案會留在原處。
