# 外部の編集とバージョン

ほかのエディタ、スクリプト、Git による変更が共有プロジェクトに届く仕組み、Oleafly が送信前に確認する場合、そして復元するときに共有プロジェクトの履歴、チェックポイント、Git がどう関係するかを説明します。

共有プロジェクトは、お使いのコンピュータ上の通常のフォルダです。ほかのプログラムがそのファイルを変更することもあり、Oleafly はそうした変更を共有プロジェクトに取り込みます。

## ほかのエディタとスクリプト

ほかのエディタ、フォーマッター、スクリプト、コマンドラインツールがプロジェクトフォルダ内のファイルを保存すると、Oleafly はそれを検出し、変更を全員に送信します。ほかのユーザーがそのファイルに入力している最中でも動作します。

Oleafly は、保存されたファイルを、最後にそこへ書き込んだ版と比べます。反映されるのは、ほかのプログラムが変更した部分だけです。その間に共同執筆者が入力したテキストは、そのまま残ります。ほかのユーザーが入力している間に毎秒保存するエディタでも問題ありません。

## 大きな変更は先に確認する

Git のブランチの切り替え、プル、プロジェクトの上へのアーカイブの展開、古いバージョンの復元など、一度に多くのファイルを変更する操作があります。Oleafly はそのような変更を保留し、全員に届く前に確認します。確認するのは、一度に 10 件以上のファイルが変更された場合と、3 件以上のファイルが変更され、それがプロジェクトのファイルの 30% 以上を占める場合です。

エディタの上のバナーに、Oleafly の外で何件のファイルが変更されたかが表示され、変更を全員に送信するか、ローカルにとどめるかを尋ねられます。

- **送信**は、変更を送信します。ほかのユーザーが入力している内容とマージされます。
- **ローカルに保持**は、それらのファイルを、このコンピュータ上だけの状態に保ちます。ほかの全員は、共有されている版のままです。あとでそれらのファイルのどれかを編集した場合は、新しい編集だけが送信されます。

### プロジェクトフォルダがなくなったとき

たとえば取り外したドライブ上にあるなど、プロジェクトフォルダが使えなくなった場合、Oleafly はすべてのファイルが削除されたとは扱わず、そのプロジェクトの同期を一時停止します。その旨が表示され、フォルダが戻ると同期が再開します。

## 共有プロジェクトでの Git

Git の履歴は共有されません。各ユーザーは、プロジェクト内に自分のリポジトリを持ち、自分のリモートにコミットやプッシュができます。[Git とソース管理](/docs/git-history/)をご覧ください。

Git はディスク上のファイルを変更し、それが Oleafly が共有するファイルです。別のブランチをチェックアウトしたりプルしたりすると、多くのファイルが変わる場合は上の確認のあとで、そのファイルが全員に送信されます。別のブランチを見るだけの場合は、 **ローカルに保持**を選ぶか、共有プロジェクトの外に別のクローンを作って使ってください。

### 差分ビューは読み取り専用

共有プロジェクトでは、ソース管理の差分は読み取り専用です。差分には「共有プロジェクトでは、この差分は読み取り専用です。ファイルはエディタで編集してください。」と表示されます。変更はエディタで行ってください。そうすれば、ほかの全員の入力とマージされます。

## バージョン履歴

共有プロジェクトには、プロジェクトの全員に見える[共有プロジェクトの履歴](/docs/collaboration/history/)があります。すべての変更と、誰がいつ行ったかが記録され、バージョンを開く、比較する、名前を付ける、復元することができます。

各ユーザーは、プロジェクトについて自分自身の履歴も持ちます。

- [保存したチェックポイント](/docs/checkpoints/)は、通常のプロジェクトと同じように、コンパイルに成功したあと、お使いのコンピュータで取得されます。
- [Git のコミット](/docs/git-history/)は、自分のリポジトリで行ったものです。
- **アクティビティ**の**レビュー**には、離れている間にほかのユーザーが変更した内容が表示されます。[再接続したとき](/docs/collaboration/offline/#when-you-reconnect)をご覧ください。

## バージョンを復元する

共有プロジェクトの履歴のある時点に戻すには、 **履歴**でそのバージョンを開き、 **このファイルを復元**か**プロジェクト全体を復元**を選びます。[ファイルまたはプロジェクト全体を復元する](/docs/collaboration/history/#restore-a-file-or-the-whole-project)をご覧ください。

自分のチェックポイントとコミットの復元は、通常のプロジェクトと同じように行います。 **バージョン管理 → 保存したチェックポイント**か**バージョン管理 → Git の履歴**を開き、戻したいバージョンの**復元**を選びます。復元できるのは、所有者と編集者です。

共有プロジェクトでは、復元すると全員の共有ファイルが変わります。Oleafly は復元したテキストを編集として送信するので、その時点でほかのユーザーが入力している内容はそれとマージされ、失われません。復元で多くのファイルが変わる場合は、先に**送信**か**ローカルに保持**かの確認が表示されます。

結果は全員に届くので、復元する前に共同執筆者に知らせてください。

## 削除したファイルを復元する

削除されたファイルは、 **リアルタイム共同編集**パネルの**最近削除した項目**に残っています。 **復元**を選ぶと、全員のファイルが元に戻ります。[最近削除したファイル](/docs/collaboration/files/#recently-deleted)をご覧ください。
