# ライブ共同編集を始める

グループの共同編集サーバーを追加し、サインインして、共有されたプロジェクトを開きます。サーバーとデバイスの管理方法も説明します。

:::note[ライブ共同編集はベータ版です]
Oleafly 0.4.7-rc が必要です。ダウンロードページではまだ 0.4.6 が配布されているので、[リリースページ](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)からダウンロードしてください。
:::

共有プロジェクトに参加するには、グループのサーバーを運用している人から、サーバーのアドレスと、入る方法の 2 つを受け取る必要があります。メールアドレス、サインイン名、または所属機関のドメインで追加してもらいます。プロジェクトの所有者が、ゲストとして招待することもできます。共同執筆者が Oleafly サーバー (`collab.oleafly.com`) を使っている場合は、 **サーバーを追加**にそのためのボタンがあります。

サーバーからメールが届いている場合は、そこに **Oleafly に追加**のリンクがあります。それを選ぶと、Oleafly がサーバーを追加します。そうでない場合は、手動で追加します。

## サーバーを追加する

1. **設定 → 共同編集**を開き、 **サーバーを追加**を選びます。
2. 教えられた**サーバーのアドレス** (たとえば `collab.example.edu`) を入力し、 **続行**を選びます。Oleafly は、サインインの前にサーバーを確認します。共同編集サーバーには、https を使うアドレスが必要です。
3. サインインの方法を選びます。選べる方法は、サーバーの管理者の設定によって決まります。

Oleafly サーバーを追加するには、ダイアログの上部、アドレス欄の上にある **Oleafly** を選びます。Oleafly が `https://collab.oleafly.com` を入力して確認し、サインインに進みます。このボタンは、そのサーバーがリストに入ると消え、リストから取り除くと再び表示されます。

**共有**ダイアログにも同じ近道があります。サーバーをまだ 1 つも追加していない場合は、 **Oleafly サーバーを追加**が表示されます。

## サインイン

### 所属機関または GitHub で

使いたい方法のボタン (たとえば **GitHub で続ける** や、大学のログイン) を選びます。ブラウザが開くので、そこでサインインしてから Oleafly に戻ります。Oleafly があなたのパスワードを目にすることはありません。

### メールのリンクで

サーバーが対応している場合は、 **メールで続ける**を選びます。ブラウザでサーバーのページが開きます。

1. メールアドレスを入力し、 **リンクをメールで送る**を選びます。
2. 同じコンピュータでそのメールを開き、 **サインイン**ボタンを選びます。
3. 開いたページで**サインイン**を選びます。あとは Oleafly が自動で続けます。

リンクは 1 回だけ、15 分間使えます。すでに別の方法でこのサーバーに、同じ確認済みのアドレスでサインインしたことがある場合、このリンクでは同じアカウントにサインインします。

### コードで

制限の厳しい研究室のマシンのように、サインイン後にブラウザから Oleafly に戻れないコンピュータがあります。そうした場合は**コードでサインイン**を使います。ブラウザでのサインインに 20 秒以上かかった場合も、Oleafly がこの方法を案内します。

1. Oleafly に、サーバー上のアドレスと、8 文字のコードが表示されます。
2. スマートフォンやコンピュータで、そのアドレスを開き、コードを入力して**続行**を選びます。
3. ページに、リクエストしたコンピュータの名前が表示されます。名前を確認してから、サーバーが用意している方法のどれかでサインインします。サインインの仕上げは、Oleafly が自動で行います。

コードは 1 回だけ使え、10 分で無効になります。サインインを始めた覚えがない場合は、 **中止する。自分ではありません**を選びます。

### 完了したら

Oleafly に**接続先**とサーバーの名前が表示されます。 **完了**を選びます。サーバーは、 **設定 → 共同編集**に**サインイン済み**として表示されます。

サーバーが「このサーバーのリストにまだ載っていません。」と答えた場合は、管理者に追加を頼んでください。ほかのサインインのメッセージについては、[トラブルシューティング](/docs/collaboration/troubleshooting/#sign-in-problems)をご覧ください。

## 共有されたプロジェクトを開く

あなたと共有されたプロジェクトは、ライブラリの**あなたと共有**に、自分のプロジェクトの上に表示されます。各行に、所有者、サーバー、あなたの役割が表示されます。 **開く**を選びます。Oleafly がプロジェクトをライブラリにコピーして開きます。

以降、そのプロジェクトは、ほかのプロジェクトと同じようにライブラリに入り、 **共有中**のバッジが付きます。ファイルは、プロジェクトフォルダにある実際のファイルです。メイン文書とエンジンはプロジェクト全体で設定されるので、全員で同じになります。

### リンクからプロジェクトを開く

プロジェクトのリンクを送ってもらうこともできます。

- **メールから**の場合、リンクを開くと Oleafly が直接開きます。
- **それ以外**の場合は、ライブラリで**読み込む**を開き、 **共有プロジェクトのリンクを開く…** を選び、リンクを貼り付けて**開く**を選びます。

参加する前に、Oleafly が「この共有プロジェクトに参加しますか？」と尋ね、プロジェクト、所有者、サーバー、あなたの役割を表示します。参加すると、プロジェクトのファイルがこのコンピュータにコピーされます。リンクを送ってきた人が誰かわかっている場合にだけ、 **参加**を選んでください。

リンクがまだ追加していないサーバーのものである場合は、先にそのサーバーを追加してから、もう一度リンクを開きます。

## 編集を始める

通常のプロジェクトと同じように入力します。あなたの変更は入力しながらほかのユーザーに届き、ほかのユーザーの変更もあなたに届きます。画面に表示される内容は、[共同で作業する](/docs/collaboration/working-together/)で説明しています。

レビュアーの場合、入力した内容は提案になります。コメント投稿者の場合、エディタは読み取り専用ですが、テキストを選択してコメントできます。閲覧者の場合、エディタは読み取り専用ですが、読む、コンパイルする、書き出すことはできます。各役割にできることは、[役割](/docs/collaboration/sharing/#roles)に一覧があります。

サーバーでブラウザからのアクセスが使える場合は、Oleafly がなくても、Web ブラウザでプロジェクトを開けます。[ブラウザで作業する](/docs/collaboration/browser/)をご覧ください。

## ほかのユーザーに見えるものを選ぶ

**設定 → 共同編集**の**ほかのユーザーに見えるもの**で、次のいずれかを選びます。

- **カーソルを表示**: ほかのユーザーに、あなたのカーソル、選択範囲、開いているファイルが見えます。
- **開いているファイルだけを表示**: ほかのユーザーには、ファイルは見えますが、その中のどこにいるかは見えません。
- **表示しない**: ほかのユーザーには、あなたのカーソルも、開いているファイルも見えません。

この設定は、コンピュータごとに別々に行います。

## 複数のサーバー

サーバーは複数追加できます。たとえば、研究室用と、他大学とのプロジェクト用です。共有プロジェクトは、それぞれ 1 つのサーバーにあります。 **あなたと共有**には、サインインしているすべてのサーバーのプロジェクトが一覧表示されます。

## あなたのデバイス

使うコンピュータごとにサインインします。 **設定 → 共同編集**のサーバーのカードに**お使いの端末**が一覧表示され、それぞれが追加された日と、最後に使われた日が示されます。使わなくなったコンピュータの横の**サインアウト**を選びます。そのコンピュータは、誰かがもう一度サインインするまで、同期されなくなります。

サーバーにサインインした各 Web ブラウザも、この一覧に表示されます。ブラウザの横の**サインアウト**を選ぶと、そのブラウザでのセッションが終了します。

サーバーがメールを送信する場合、アカウントが新しいコンピュータでサインインすると、サーバーからデバイスの名前、システム、時刻がメールで届きます。自分ではない場合は、そのデバイスをサインアウトしてください。

共用のコンピュータでは、ユーザーごとに、そのコンピュータの自分専用のユーザーアカウントが必要です。同じユーザーアカウントから、すでにほかのユーザーがサーバーにサインインしている場合、Oleafly は 2 人目をサインインさせません。

## サーバーからのメール

誰かがあなたをプロジェクトに追加すると、サーバーから、プロジェクトのタイトル、共有した人、あなたの役割、プロジェクトを開くリンクがメールで届くことがあります。これを止めるには、サーバーのカードで**誰かがプロジェクトを共有したときにメールを送る**をオフにします。共有されたプロジェクトは、引き続き**あなたと共有**に表示されます。

誰かがコメントであなたをメンションすると、サーバーからそのことがメールで届きます。[ユーザーにメンションする](/docs/collaboration/comments/#mention-someone)をご覧ください。

サーバーがメールを送信しない場合、これらのメッセージは届きません。それ以外は、すべて同じように動作します。

## サインアウト

サーバーのカードで**サインアウト**を選びます。Oleafly はまず、サーバーにまだ届いていない変更を送ろうと、数秒間試みます。

まだ送られていない変更がある場合は、Oleafly がその扱いを尋ねます。

- **ローカルコピーを残す**は、該当する各プロジェクトを、変更を含めて、「*プロジェクト名* (ローカルコピー)」という名前の、共有されない通常のプロジェクトとしてこのコンピュータに残します。そのあと、サインアウトします。
- **サインインしたままにする**は、サインインした状態を保つので、オンラインに戻ってからもう一度試せます。

サーバーのカードの**取り除く**は、サインアウトして、サーバーを忘れます。未送信の変更について、同じ質問が表示されます。すでにこのコンピュータにあるプロジェクトは、そのまま残ります。
