# プロジェクトのノートと共有ノート

ノートをプロジェクトにリンクし、プロジェクトの notes フォルダにノートを置き、共同編集サーバーを通じてほかの人とノートを書きます。

ノートは実験的な機能で、オンにするまでオフのままです。[ノートをオンにする](/docs/notes/#turn-on-notes)を参照してください。

ノートがプロジェクトに属するしかたは、2 つあります。個人のノートは「ノート」にあり、プロジェクトにリンクできます。見られるのは自分だけです。プロジェクトのノートは、プロジェクトの `notes` フォルダにあるファイルなので、プロジェクトと一緒に移動し、プロジェクトを共有しているすべての人にも渡ります。

## ノートをプロジェクトにリンクする

「ノート」のノートのヘッダーには、そのノートの位置が表示されます。**ノートのホーム**を表す家のアイコン、プロジェクト、タイトルの順です。

![「Long-context LLMs: thesis hub」のヘッダーには、家のアイコンから LLaMA プロジェクト、そしてタイトルまでの位置が表示され、サイドバーではそのプロジェクトの下に一覧されています。](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-workspace-dark-window-v2.png#view=0,0,1060,930)

1. 「ノート」でノートを開きます。
2. ヘッダーで、プロジェクト名を選びます。プロジェクトのないノートでは、そこに**プロジェクトを選択**と表示されます。
3. 一覧からプロジェクトを選びます。**プロジェクトなし**を選ぶと、リンクが外れます。

ノートの**その他**メニューの**プロジェクトにリンク**でも、ノートのサイドバーでノートを右クリックして開くメニューでも、同じことができます。まだ存在しないプロジェクトにノートをリンクするには、ノートのヘッダーで**新規プロジェクト**を選びます。作成したプロジェクトが、そのノートにリンクされます。

リンクしたノートも、個人のノートのままです。「ノート」に残り、プロジェクトを共有している相手には渡りません。リンクは、このコンピュータにだけ保存されます。

ノートをリンクすると、次のようになります。

- ノートの引用を、プロジェクトの文献リストから取り込めます。
- ノートのアシスタントは、プロジェクトのファイルを読めます。プロジェクトのアシスタントには、ノートのタイトルと短い要約が渡ります。詳しくは、[AI でノートを使う](/docs/notes/ai/)を参照してください。

## プロジェクトの「ノート」パネル

プロジェクトを開いた状態で、プロジェクトのサイドレールの**ノート**を選ぶか、コマンドパレットから**このプロジェクトのノートを開く**を実行します。パネルには、2 つのリストがあります。

- **プロジェクトのノート**は、プロジェクトの `notes` フォルダにあるファイルです。プロジェクトを持つ全員が持っています。
- **自分のノート**は、このプロジェクトにリンクした個人のノートです。「ノート」に残ります。

![LLaMA プロジェクトのノートパネルでは、プロジェクトのノートの一覧が空で、自分のノートの下に個人のノートが 4 つあり、このコンピュータだけでプロジェクトにリンクされています。](https://cdn.oleafly.com/images/screenshots/desktop/docs/notes-project-panel-dark-window-v2.png#view=0,0,700,580)

2 つのリストを合わせてノートが 8 個を超えるときは、その上に検索フィールドが表示されます。

### プロジェクトの中の個人のノート

**自分のノート**の横の**個人のノートを新規作成**（**+**）を選ぶか、**このプロジェクトの個人のノートを新規作成**を実行すると、プロジェクトにリンクした個人のノートが始まります。ファイルの横のタブで開きます。タブには、**個人のノート**と**自分だけが閲覧できます**、ノートを共有しているときは**ノートから共有**と表示されます。**ノートで開く**は、同じノートを「ノート」で開きます。

**自分のノート**の各行には、ノートを最後に編集した時刻が表示されます。メニューには、**プロジェクトに移動**、**ノートで開く**、**名前を変更**、**このプロジェクトとのリンクを解除**、**ごみ箱に移動**があります。ノートのリンクを解除した後は、メッセージに**元に戻す**が表示されます。

## プロジェクトのノート

プロジェクトのノートは、プロジェクトの `notes/<Title>.md` にある Markdown ファイルです。フロントマターに `kind: note` があることで、Oleafly がそれをノートとして開きます。`notes` にある、その行のない Markdown ファイルは、**プロジェクトのノート**には一覧されず、ほかの Markdown ファイルと同じように開きます。

### プロジェクトのノートを作成する

1. プロジェクトのサイドレールで**ノート**を選びます。
2. **プロジェクトのノート**の横の**プロジェクトのノートを新規作成**（**+**）を選びます。Oleafly が `notes/Untitled.md` を作成して開きます。
3. リストに現れたフィールドにタイトルを入力して、Enter を押します。Oleafly がファイル名を `notes/<Title>.md` に変更します。

タイトルを入力せずにフィールドを離れると、ノートは Untitled のままです。コマンドパレットの**プロジェクトのノートを新規作成**でも、Untitled のノートが始まります。タイトルは、ノートの上部に入力します。

ファイル名は、タイトルに従います。

- `/`、`\`、`:`、`*`、`?`、`"`、`<`、`>`、`|` など、システムによってはファイル名に使えない文字は、スペースになります。
- 名前は 80 文字までです。
- `CON` や `AUX` など、Windows が予約している名前には、`notes/CON note.md` のように「note」が付きます。
- 名前がすでに使われているときは、`notes/Methods-2.md` のように、Oleafly が番号を付けます。

### 開いて編集する

**プロジェクトのノート**の下のノートを選ぶか、ファイルツリーの `notes` フォルダからそのファイルを開きます。**プロジェクトのノート**と**このプロジェクトのファイルと一緒に保存されます**というマークが付いたタブで開きます。

- **Markdown として編集**は、ファイルのソースを表示します。「このノートを Markdown として編集しています。」というバナーにある**ノートとして編集**で、元に戻せます。タブを右クリックしても、同じ切り替えができます。
- **自分のノートにコピー**は、そのノートから、プロジェクトにリンクした個人のノートを作り、使っている画像やファイルも一緒にコピーします。コピーは、別のノートです。

リストはディスク上のフォルダに従うため、別のプログラムがノートのファイルを追加、変更、削除すると、**プロジェクトのノート**も更新されます。フォルダから最大 200 個の Markdown ファイルを読み込み、一覧に載せなかった数を表示します。

ノートをオフにしても、ファイルはプロジェクトに残り、普通の Markdown として開きます。

### 名前を変更する

行のメニューで**名前を変更**を選ぶか、ノートの上部のタイトルを変更します。Oleafly は、フロントマターのタイトルを更新し、それに合わせてファイル名も変更します。たとえば、Draft を Results に変更すると、`notes/Draft.md` が `notes/Results.md` になります。同じ名前のファイルがすでにあるときは、新しい名前に番号が付きます。

Oleafly は、まず開いているノートを保存します。そのうちの 1 つでも保存できないときは、何も名前が変更されず、「保存されていない変更があるノートがあるため、ノートの名前を変更しませんでした。保存してから、もう一度お試しください。」と表示されます。

### 削除する

ノートの行のメニューの最後の項目で、ノートを削除します。項目の名前と動作は、プロジェクトがどこにあるかによって変わります。

- ライブラリのプロジェクトでは、**削除**でファイルが削除されます。この操作は取り消せません。
- [その場で開いたフォルダ](/docs/library/#folders-opened-in-place)では、macOS と Linux では**ごみ箱に入れる**、Windows では**ごみ箱に移動**を選ぶと、ファイルがごみ箱に移り、そこから復元できます。

### 個人のノートをプロジェクトに移動する

1. プロジェクトで個人のノートを開き、**プロジェクトに移動**を選びます。**自分のノート**の下のノートの行のメニューと、タブの右クリックメニューにもあります。
2. ダイアログに、プロジェクトの全員がそのノートを閲覧、編集できるようになるという警告が表示されます。**プロジェクトに移動**を選びます。

Oleafly は、ノートを `notes/<Title>.md` に書き出し、ノートが使っている画像やファイルを `notes/assets` にコピーして、開きます。個人のコピーは、**設定 → データの保存**の[ごみ箱](/docs/settings/storage/#recycle-bin)に移ります。`notes/assets` に、同じ名前の別のファイルがすでにあるときは、コピーに番号が付き、ノートのリンクはそれを指します。

## 共有プロジェクトのプロジェクトのノート

[プロジェクトを共有](/docs/collaboration/sharing/)すると、`notes` フォルダはほかのフォルダと同じように一緒に渡り、個人のノートは自分の手元に残ります。ノートがオンのときは、**共有**ダイアログにそう表示されます。「プロジェクトのノートは、このプロジェクトの全員と共有されます。個人のノートは非公開のままです。」フォルダにノートがないときは、「個人のノートは非公開のままです。共有されるのは、プロジェクトのノートフォルダにあるノートだけです。」と表示されます。

共有プロジェクトでは、次のようになります。

- **ノート**パネルには、「プロジェクトのノートは、このプロジェクトの全員と共有されます。個人のノートは非公開のままです。」と表示されます。
- プロジェクトのノートのタブには、**このプロジェクトの全員が閲覧、編集できます**と表示されます。
- プロジェクトのノートは、入力しながら一緒に書け、ノートの中に各人のカーソルと名前が表示されます。
- プロジェクトのノートを変更できるのは、所有者と編集者だけです。ほかの人は読むことができ、ノートには「このノートは閲覧できますが、編集はできません。」と表示されます。

## ほかの人とノートを書く

個人のノートは、プロジェクトなしで、共同編集サーバーを通じて単独で共有できます。サーバーのアカウントが必要です。サーバーの追加とサインインの方法は、[はじめに](/docs/collaboration/get-started/)にあります。

### ノートを共有する

1. 「ノート」でノートを開き、ヘッダーの**共有**を選びます。**共有**は、ノートのサイドバーのノートのメニューにもあります。
2. **ユーザー**タブで、**サーバー**を選びます。
3. 概要を確認します。ノートの**ファイル**と**サイズ**が表示され、それを読めるサーバーの名前が示されます。
4. **共有**を選びます。

ノートの画像やほかのファイルは、ノートと一緒に共有されます。Oleafly の設定と Git の履歴は共有されません。同じタブに、続けて**アクセスできる人**が表示されます。プロジェクトと同じように、ユーザーを追加して、役割を選びます。[メンバーを追加する](/docs/collaboration/sharing/#add-people)を参照してください。共有したノートには、サイドバーとノートのホームに**共有中**のマークが付きます。

共有プロジェクトのプロジェクトのノートと同じく、ノートに書き込めるのは所有者と編集者だけです。レビュアー、コメント投稿者、閲覧者は読むことができ、アシスタントも、代わりに変更することはできません。

共有を終了するには、所有者が同じタブで**共有を停止**を選び、ほかの人は**プロジェクトから退出**を選びます。所有者が共有を停止すると、全員がノートのコピーを持ったままになりますが、同期はされなくなります。自分が退出すると、自分のコピーはこのコンピュータに残り、同期が止まります。[共有を停止する](/docs/collaboration/sharing/#stop-sharing)と[プロジェクトから退出する](/docs/collaboration/sharing/#leave-a-project)を参照してください。

### 共同編集者に必要なもの

- 同じサーバーのアカウントで、Oleafly にサインインしていること。
- ノートをオンにしていること。

ノートは、共有プロジェクトと同じように、相手のライブラリの**あなたと共有されたプロジェクト**に表示されます。**開く**でダウンロードして、「ノート」で開きます。一覧とリンクについては、[共有されたプロジェクトを開く](/docs/collaboration/get-started/#open-a-project-shared-with-you)を参照してください。

### 一緒に編集する

ほかの人がノートに入っている間は、次のようになります。

- その人たちのアバターが、ノートのヘッダーに並びます。アバターにポインタを合わせると、その人の名前、役割、**編集**に続けてノートのタイトルなど、いま何をしているかが表示されます。アバターを選ぶと、その人がいるブロックまでスクロールします。
- 各人のカーソルが、その人の色と名前で表示されます。左の余白の色付きのバーは、誰かがいるブロックを示します。ポインタを合わせると、誰かがわかります。
- アバターの横の同期の状態で、変更が全員に届いているかがわかります。たとえば、**最新の状態**や**同期中**です。すべての状態は、[同期の状態](/docs/collaboration/working-together/#the-sync-status)にあります。

リアルタイムで編集できる共有ノートは、一度に 1 つです。最初のノートが画面に開いたまま別の共有ノートに移ると、2 つ目のノートに「別のノートでリアルタイム編集がオンになっています」と表示されます。**ここでリアルタイム編集**を選ぶと、リアルタイム編集がそのノートに移ります。

### 変更が送信されないとき

Oleafly が最後の変更を送信できないときは、ノートの上のお知らせにそう表示されます。

- 「現在は閲覧のみのため、このノートへの最後の変更は送信されませんでした。」
- 「Oleafly はこのノートへの最後の変更を送信できなかったため、その変更は破棄されました。」

お知らせを閉じるには、**×** を選びます。

### 接続がないとき

接続が切れても、そのまま書き続けてください。ノートは自分のコンピュータに保存され、Oleafly が自動で再接続して変更を送信します。変更が待機している間、同期の状態には、数とともに**オフライン。未送信の変更:** と表示されます。再接続とマージのしくみは、[オフラインと再接続](/docs/collaboration/offline/)で説明しています。

## 読み取り専用のコピーを公開する

同じダイアログの**公開**タブは、ノートの読み取り専用のコピーを公開リンクに置きます。リンクを知っている人は、サインインせずに読めます。先に、誰かとノートを共有する必要はありません。

1. 「ノート」でノートを開き、**共有**、続けて**公開**を選びます。
2. **サーバー**を選びます。
3. **公開**を選びます。タブに、**リンクをコピー**と**開く**が付いた**公開リンク**が表示されます。

ページには、画像、グラフ、ダイアグラム、数式、Typst、分子が含まれます。HTML、React、CSV、配列、ノートブックのブロックは含まれません。

ページは、ノートに追従しません。ノートを変更すると、タブに「前回の公開後にこのノートを変更しています。ページを更新するには、もう一度公開してください。」と表示されます。**再公開**を選ぶと、更新されます。**公開を停止**は、リンクをすぐに止めますが、ページのコピーを保存した人の手元には残ります。**設定 → 共同編集**の各サーバーのカードにある**公開中のノート**には、そこで公開したものが一覧されます。

いくつかの制限があります。

- 公開できるのは、ノートの所有者だけです。
- サーバーの管理者が、管理コンソールの設定で**ノートの公開リンクを許可**をオンにする必要があります。既定ではオフです。
- 管理者は、公開されたページを取り下げられます。管理者が元に戻すまで、読者はそのページを開けず、自分も再公開できません。公開の停止は引き続きできます。
