# ライブ共同編集

ほかのユーザーとリアルタイムで 1 つのプロジェクトを書きます。全員が自分のコンピュータ上で実際のファイルを持ち、変更はグループが運用するサーバーを通じて届きます。

:::note[ライブ共同編集はベータ版です]
Oleafly 0.4.7-rc が必要です。[リリースページ](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)からダウンロードしてください。ダウンロードページではまだ 0.4.6 が配布されていますが、これにはライブ共同編集がありません。サーバーを運用する場合は、[1 つのコマンドでインストールする](/docs/collaboration/server/#install-with-one-command)に従って、Oleafly Server 0.1.1-rc をインストールしてください。
:::

ライブ共同編集では、複数のユーザーが同じプロジェクトを同時に書けます。入力しながら、お互いのカーソルが見えます。テキストにコメントしたり、変更を提案したり、チャットしたりでき、PDF は各自が自分のコンピュータでコンパイルします。

全員が、プロジェクト全体を通常のファイルとして自分のライブラリに持ちます。変更は、研究室、学部、所属機関が運用するサーバーや、`collab.oleafly.com` の Oleafly サーバーなどの共同編集サーバーを通じて、それらのコピーの間で届けられます。誰が参加できるかはサーバーが決めます。Oleafly のアカウントはありません。大学のログインや GitHub など、すでに持っているアカウントでサインインします。

## 仕組み

各ユーザーが、プロジェクトの完全なコピーを持っています。編集は、入力に合わせて文字単位でマージされるので、2 人が同じ段落で、互いを上書きすることなく作業できます。

接続が切れても、作業は続けられます。変更はお使いのコンピュータで待機し、再接続したときに送信されます。そのときの動作は、[オフラインと再接続](/docs/collaboration/offline/)で説明しています。

サーバーは、共有された各プロジェクトを保存し、プロジェクトのユーザー間で変更を受け渡します。サーバーは、そこで共有されたプロジェクトのファイルを読めます。 **共有**ダイアログは、共有する前にそのことを知らせます。サインイン、デバイスキー、ログの扱いは、[サーバーのセキュリティ](/security/)で説明しています。

各ユーザーは、プロジェクトが全員に設定しているエンジンとメイン文書を使って、自分のコンピュータでコンパイルします。ビルド出力、Oleafly の設定、Git の履歴は各コンピュータに残るので、Git のコミットと[保存したチェックポイント](/docs/checkpoints/)は、あなただけのものです。例外は、所有者または編集者がコンパイルした最新の PDF です。ブラウザで作業する共同執筆者が読めるように、Oleafly がこれをサーバーに送ります。共有プロジェクトの[履歴](/docs/collaboration/history/)はプロジェクトとともに保存されるので、全員に同じバージョンが見えます。

## 対象となる人

- 論文、研究費の申請書、学位論文を共同で書く研究室や研究グループ。グループ全体で 1 つのサーバーを使います。
- ほかの機関の共同執筆者。プロジェクトの所有者がゲストとして招待でき、ゲストにはそのプロジェクトだけが見えます。サーバーでブラウザからのアクセスが使える場合は、Oleafly をインストールせずに[ブラウザで作業](/docs/collaboration/browser/)できます。
- テキストを直接編集せずに、コメントや変更の提案をしてほしい指導教員や査読者。
- 学生と教員が草稿を共有し、コメントし合う授業。
- サーバーを確認し、運用する IT・セキュリティ担当者。[共同編集サーバーを運用する](/docs/collaboration/server/)と[セキュリティのページ](/security/)から始めてください。

## ざっと見てみる

共有プロジェクトを開くと、次のものがあります。

| 場所 | 見えるもの |
| --- | --- |
| ライブラリ | **あなたと共有**には、ほかのユーザーが共有してくれた、まだこのコンピュータにないプロジェクトが一覧表示されます。ライブラリ内の共有プロジェクトには、 **共有中**のバッジが付きます。 |
| ツールバー | 今プロジェクトにいるユーザーのアバター、 **編集**と**提案**の切り替え、 **共有**ボタン。 |
| エディタ | ほかのユーザーのカーソルと選択範囲。それぞれ自分の色で、名前とともに表示されます。 |
| エクスプローラー | ユーザーが開いているファイルの横に、そのユーザーの色の点。 |
| **リアルタイム共同編集**パネル | **参加者**、 **アクティビティ**、 **履歴**、 **最近削除した項目**があります。上部のアイコンで、変更が最新かどうかがわかります。 |
| **コメント**パネル | コメントのスレッドと提案された変更。ファイルごとにまとめられます。 |
| **チャット**パネル | プロジェクトの全員に向けたメッセージ。 |
| **設定 → 共同編集** | あなたのサーバー、あなたのデバイス、作業中にほかのユーザーにあなたの何が見えるか。 |

**リアルタイム共同編集**、 **コメント**、 **チャット**の各パネルは、プロジェクトのレールから開きます。いずれかに点が付いているときは、そこで何か新しいことがありました。

## 次に読むもの

- 招待された場合: [ライブ共同編集を始める](/docs/collaboration/get-started/)。
- プロジェクトを共有したい場合: [プロジェクトを共有する](/docs/collaboration/sharing/)。
- 今、ほかのユーザーと書いている場合: [共同で作業する](/docs/collaboration/working-together/)。
- 以前のバージョンに戻したい場合: [共有プロジェクトの履歴](/docs/collaboration/history/)。
- 共同執筆者が Oleafly を持っていない場合: [ブラウザで作業する](/docs/collaboration/browser/)。
- サーバーを運用している場合: [共同編集サーバーを運用する](/docs/collaboration/server/)。
