# ファイルとデータ

プロジェクトと一緒に移動するもの、およびソース、履歴、アプリのデータをバックアップする方法を把握します。

原稿は、ふつうのソースファイルが入ったフォルダです。それらのファイルは別のエディタで開いたり、バックアップしたり、Oleafly の外に持ち出したりできます。

## プロジェクトのファイル

ライブラリのプロジェクトは、通常 `~/.oleafly/projects/` の下にあります。プロジェクトには、LaTeX、Typst、Markdown のメイン文書、参考文献、図、研究資料を入れられます。

`project.json` には、プロジェクトの識別情報と設定が記録されます。メイン文書、エンジン、固定された Typst バージョンもここに含まれます。`.git` ディレクトリには Git の履歴が入ります。Oleafly が作成または読み込んだプロジェクトは、通常、ファイルを 1 つのコミットにまとめた状態から始まり、そのコミットは「Create project」という名前です（[Git とソース管理](/docs/git-history/#the-first-commit)を参照）。`.oleafly/build/` ディレクトリには、生成されたビルド出力が入っていて、コンパイルすれば再作成できます。

Typst プロジェクトは、読み込んでいるパッケージのコピーを `typst-packages` フォルダに保持できるので、オフラインでも、ほかのコンピュータでもコンパイルできます。Typst は、プロジェクトの `fonts` フォルダにあるフォントも使います。どちらのフォルダも、プロジェクトと一緒に移動します。

[その場で開いた](/docs/library/#folders-opened-in-place)フォルダは、元の場所にとどまります。Oleafly は、そのフォルダのビルド、設定、チェックポイント、チャットを、独自のデータフォルダに保持するので、あなたのフォルダには何も追加されません。

## プロジェクトの外に保存されるデータ

アプリの環境設定、暗号化されたプロバイダの認証情報、チャットと使用状況の記録、追加の Typst バージョンなどのダウンロードしたツール、保存したチェックポイントは、ローカルのアプリのストレージに属します。アシスタントやエージェントのターンの前ごとに Oleafly が保持するプロジェクトのコピー（そのターンで変更されたファイルを元に戻せるようにするもの）も同じです。`@` 検索が読み取る Zotero ライブラリのコピーもそこにあり、プロジェクトの中にはありません。原稿のフォルダをコピーしても、これらのアプリのデータがすべてコピーされるわけではありません。

[リンクしたフォルダ](/docs/linked-folders/)は、元の場所にとどまります。リンクしたというだけでは、ソースのアーカイブにそれらの内容は含まれません。

## ノートの置き場所

[ノート](/docs/notes/)は、自分のコンピュータにある Markdown ファイルです。個人のノートはそれぞれ、プロジェクトのフォルダの中にあるフォルダで、ライブラリのプロジェクトと並んで保存されます。プロジェクトのノートは、プロジェクトの `notes` フォルダにある `.md` ファイルなので、プロジェクトと一緒に移動します。Windows、macOS、Linux でのフォルダと、ノートのフォルダに入っているものについては、[ノートの保存場所](/docs/notes/#where-notes-are-stored)を参照してください。

## TinyTeX の置き場所

**設定 → エンジン → LaTeX** から TinyTeX をインストールすると、Oleafly は `~/.oleafly/tinytex` に置きます。例外は Windows で、ユーザーフォルダの名前に、韓国語や中国語の名前のようなアクセント付き文字や非ラテン文字が含まれる場合です。TeX Live はそのようなフォルダから実行できないためです。その場合、TinyTeX は、通常は `C:\ProgramData` にある ProgramData の中の、`Oleafly-` に短いコードを付けた名前のフォルダに置かれます。管理者権限は不要です。Oleafly がそのフォルダも用意できない場合は、そう知らせます。Tectonic でコンパイルを続けるか、TeX Live を自分で `C:\texlive` にインストールできます。

**TeX ディストリビューションの管理**にある TinyTeX の行にはフォルダが表示されます。ぼかされたパスにカーソルを重ねると読めます。TinyTeX を削除するときは、フォルダを手動で削除せず、その行から削除してください。

## 作業をバックアップする

| 残したいもの | 残し方 |
| --- | --- |
| 原稿のソースとプロジェクトのアセット | プロジェクトのフォルダをコピーするか、ソースの ZIP を書き出す |
| Git のコミット | リポジトリをバックアップするか、設定したリモートにプッシュする |
| 保存したチェックポイント | バージョン管理から、暗号化した履歴アーカイブを書き出す |
| アプリの環境設定とローカルの記録 | Oleafly のデータディレクトリを、コンピュータの通常のバックアップに含める |
| リンクしたデータと参考文献 | 元のフォルダをバックアップする |
| このコンピュータの外にある、ライブラリのプロジェクトと設定 | [クラウド同期](/docs/cloud-sync/)をオンにして、Dropbox にコピーを残す |

ソースの ZIP には、ビルドのキャッシュと Git は含まれません。リモートリポジトリには [GitHub 同期](/docs/github-sync/)を、チェックポイントの履歴には[チェックポイントのアーカイブ](/docs/checkpoints/)を使います。

## 別のコンピュータに移る

Oleafly をインストールし、原稿のプロジェクトをコピーまたはクローンします。そのマシンで、リンクしたフォルダとモデルプロバイダを再接続します。プロジェクトはコンパイラの選択とメタデータを引き継ぎますが、追加のツールやパッケージは、インストールが必要な場合があります。このコンピュータにないバージョンを固定した Typst プロジェクトは、コンパイルの前にそのバージョンのダウンロードを提案します。

## 画面に表示されるパス

ホームフォルダ内のパスは、設定、バージョン履歴、エンジンとエージェントの詳細、チャットで `~/…` と表示されます。設定では、ファイルとフォルダのパスは、マウスを重ねるか Tab で移動するまでぼかされているので、スクリーンショットにファイルの場所が写りません。

## ネットワークへのアクセス

執筆とローカルでの校正は、お使いのマシンで行われます。ホスティングされた AI は、選択したプロバイダに渡された文脈を受け取ります。画像とスキャンした PDF を読むツールは、ホスティングされたモデルや Mathpix を選ばない限り、ローカルの Ollama モデルを使います。選んだ場合は、ファイルがそのサービスに送られます。Zotero の引用は、お使いのコンピュータの Zotero アプリと通信し、アカウントを接続した場合は zotero.org と通信します。引用の検索、Zotero の読み込み、alphaXiv のツール、GitHub 同期、Typst のパッケージとバージョンのダウンロード、その他のダウンロード、アップデートの確認は、それぞれのサービスに接続します。[ライブ共同編集](/docs/collaboration/)は、共有された各プロジェクトを、それが共有されている共同編集サーバーに送ります。[クラウド同期](/docs/cloud-sync/)は、ライブラリのプロジェクトと設定を、あなた自身の Dropbox に送ります。設定 → ヘルプと情報を開くと、公開されている数字を取得します。プロジェクトの GitHub のスター数とフォーク数、そして Discord コミュニティでオンラインのメンバー数です。これらのリクエストには、アカウント、プロジェクト、使用状況の情報は含まれず、オフラインモードでは Discord へのリクエストは行われません。Tectonic と Typst は、どちらもオフラインモードでのキャッシュ済みコンパイルに対応しています。

[製品の原則を読む →](/docs/philosophy/)
