# FAQ とトラブルシューティング

はじめかた、プロジェクト、コンパイル、アシスタント、バックアップについての簡単な答えをまとめています。

## はじめに

### アカウントは必要ですか？

いいえ。Oleafly をダウンロードして開けば、すぐに書き始められます。クラウドの AI プロバイダ、GitHub、Dropbox といった任意のサービスは、それぞれ専用のアカウントを使います。

### Oleafly は LaTeX、Typst、Markdown に対応していますか？

はい。エンジンはプロジェクトを作成するときに選びます。エンジンごとに、編集と書き出しの機能が異なります。[クイックスタート](/docs/getting-started/)で、最初の PDF を作るまでの流れを説明しています。

### 既存の論文や履歴書を持ち込めますか？

はい。プロジェクトのソース、ZIP アーカイブ、Git リポジトリを読み込めます。DOCX やテキストベースの PDF からの変換経路もあります。[既存の作業を Oleafly に取り込む](/docs/import-project/)を読んで、合う経路を選んでください。

### オフラインで作業できますか？

クラウドに接続しなくても、執筆、ファイルの整理、ローカルの校正、ダウンロード済みのローカル AI モデルの実行ができます。Tectonic は、キャッシュ済みのパッケージを使ってコンパイルできます。新しいパッケージ、リモートの参考文献、クラウドのモデル、GitHub、ダウンロードには接続が必要です。オフラインに持ち出す前に、コンパイルを一度成功させてプロジェクトを準備しておいてください。

### ファイルはどこにありますか？

プロジェクトは、ローカルのライブラリにあるふつうのフォルダです。コピーしたり、バックアップしたり、別のツールで開いたりできます。プロジェクトのファイル、アプリの設定、チェックポイントについては、[データの保存場所](/docs/where-your-data-lives/)で説明しています。

### 学位論文や履歴書にも Oleafly を使えますか？

はい。[学位論文のワークフロー](/docs/workflows/thesis/)または[履歴書のワークフロー](/docs/workflows/resume/)から始めてください。どちらも、研究論文と同じエディタ、プレビュー、参考文献、書き出しのツールを使います。

## インストール

### OS がインストーラーをブロックする

ファイルが[公式のリリース](https://github.com/Oleafly/Oleafly/releases/latest)から入手したもので、お使いのプラットフォームに合っていることを確認してください。プラットフォームごとの初回起動の手順は、[インストールガイド](/docs/install/#first-launch)に従ってください。

### Linux ではどのパッケージを使えばよいですか？

お使いのコンピュータに合うアーキテクチャを選び、AppImage、Debian パッケージ、RPM のいずれかを使います。システム要件は [Linux へのインストール](/docs/install/#linux)を参照してください。

## コンパイル

### 最初のコンパイルが遅い

Tectonic が、この文書で使うパッケージをダウンロードしている可能性があります。そのコンピュータでの最初のコンパイルでは、よく使われるパッケージもまとめて取得します。ダウンロードしたパッケージは、次回以降のビルドのためにキャッシュされます。パッケージがまだダウンロード中の間は、コンパイルが通常の 5 分の制限を超えて続くことがあります。何が起きているかは、[ログ](/docs/compiling/#reading-the-logs)を開くと確認できます。

### パッケージが見つからない

オフラインモードがオンの場合は、メッセージの**オフにしてコンパイル**を選ぶか、1 回のコンパイルだけオフにして、パッケージを取得します。システムの TeX ツールチェーンでは、エラーの**探してインストール**を使います。Debian、Ubuntu、Fedora の TeX Live は、パッケージを `apt` か `dnf` で入れます。[LaTeX のエンジンとパッケージ](/docs/latex-engines/#recover-from-a-missing-file)を参照してください。

### pdfLaTeX を選んだら Oleafly が TeX ディストリビューションを求める

pdfLaTeX、XeLaTeX、LuaLaTeX、upLaTeX、pLaTeX は、お使いのコンピュータにインストールされた TeX ディストリビューションで動きます。ない場合は、どれかを選ぶと、コンパイルの前にダイアログが開きます。**TinyTeX をダウンロードして使う**を選ぶとインストールされ、**Tectonic に戻す**を選ぶと組み込みのエンジンに戻ります。コンパイルが失敗したあとは、プレビューに同じ選択肢が**TinyTeX をダウンロードして使う**と **Tectonic を使う**として表示されます。[TeX が入っていないとき](/docs/latex-engines/#when-no-tex-is-installed)を参照してください。

### MiKTeX で latexmk に Perl が必要と表示される

MiKTeX の `latexmk` は Perl で動きますが、MiKTeX には Perl が含まれていません。Strawberry Perl をインストールするか、**設定 → エンジン → LaTeX** から TinyTeX をインストールしてください。TinyTeX は独自の Perl が付いていて、MiKTeX に代わってコンパイルを引き受けます。[MiKTeX と Perl](/docs/latex-engines/#miktex-and-perl)を参照してください。

### PDF からテキストが欠けている

フォントにそれらの文字のグリフがありません。韓国語、中国語、日本語のテキストで最もよく起こり、TeX はコンパイルを失敗させずに、その文字を省きます。Oleafly が警告を出し、ログに一覧を表示します。LaTeX では、警告に示された、お使いの文字体系用の設定を貼り付けます。Typst では、通知に表示されるフォントパックをダウンロードするか、その文字を持つフォントをプロジェクトの `fonts` フォルダに追加します。Markdown では、YAML ヘッダーの `mainfont` か `CJKmainfont` を、その文字を持つフォントに設定します。[PDF から文字が欠けるとき](/docs/latex-engines/#characters-missing-from-the-pdf)と[文字が四角で表示されるとき](/docs/typst/#characters-that-show-as-boxes)を参照してください。

### Oleafly がコンパイルに時間がかかりすぎるとして止めた

コンパイルは 5 分間実行できます。パッケージがまだダウンロード中の間は、制限が最大 30 分まで延びます。Markdown から PDF へのビルドは 15 分、Quarto と Calepin は 1 時間です。もう一度コンパイルしてください。ダウンロードは止まったところから再開されます。Tectonic で長い下書きを扱う場合は、コンパイルメニューで**コンパイルモード**を**高速**にします。

### 新しいプロジェクトで自分の TeX インストールを使えますか？

はい。 **設定 → エンジン → LaTeX** を開いて **既定のコンパイルエンジン** を **latexmk（システム TeX）** に設定します。新規、読み込み、変換のいずれの LaTeX プロジェクトも、それで始まるようになります。[新規プロジェクトの既定を設定する](/docs/engines/#set-a-default-for-new-projects)を参照してください。

### 文書で minted や PythonTeX を使っている

これらのパッケージは、文書のコンパイル中に別のプログラムを実行しますが、Oleafly は既定でそれをブロックします。システムの LaTeX が必要です。プロジェクト内のすべてのファイルを信頼できるなら、エディタの上のバナーで **外部コマンドを許可** を選びます。[外部コマンドを許可する](/docs/latex-engines/#allow-external-commands)を参照してください。

### コンパイルは警告付きで終わった

**ログ** を開き、まず未定義の引用と参照を確認します。書き出す前に、[プリフライト](/docs/preflight/)で該当するソースの場所を見つけられます。

### ビルドエラーの意味がわからない

アシスタントに、ログを読み、エラーを直して、もう一度コンパイルするよう頼みます。途中の提案を確認したいときは **承認を求める** を使います。ログを [Discord](/discord) のヘルプフォーラムに投稿することもできます。

### 書き出し形式が表示されないのはなぜですか？

使える形式は、エンジンと文書の種類によって決まります。[書き出しの表](/docs/export/#editable-formats)を確認してください。

## AI アシスタント

### どのアシスタントを使えますか？

モデルのプロバイダを接続するか、ローカルモデルを使うか、[CLI エージェント](/docs/cli-agents/)を選びます。各経路は [AI のセットアップ](/docs/ai-setup/)で説明しています。

### エディタを使うのに AI は必要ですか？

いいえ。執筆、コンパイル、引用、プレビュー、ダイアグラム、プロジェクトの履歴、書き出しは、アシスタントがなくても使えます。

### アシスタントには何ができますか？

プロジェクトのファイルを扱い、出典を調べ、PDF を確認し、図を作り、ツールを実行し、ビルドの修復を手伝えます。作業に合うプランと承認のポリシーを選んでください。[チャットとツール](/docs/ai-chat/)を参照してください。

### モデルの横の「検証済み」は何を意味しますか？

そのモデルが、ツール呼び出しの検査に合格したことを示します。プロジェクトの操作に使うモデルを選ぶ助けにはなりますが、文章や調査の質を評価するものではありません。[AI のセットアップ](/docs/ai-setup/)を参照してください。

### 使用量が「不明」と表示されるのはなぜですか？

使用量を報告しないプロバイダや CLI エージェントがあります。「不明」は、値を取得できないという意味です。[使用量と予算](/docs/ai-usage/)を読んでください。

### 外部のアシスタントを接続できますか？

はい。組み込みの [CLI エージェントの接続](/docs/cli-agents/)を使うか、Oleafly のローカルな [MCP サーバー](/docs/mcp/)を有効にするか、アプリを閉じていても使える [`oleafly` コマンド](/docs/cli/)にエージェントを接続します。

## 履歴と共同作業

### 以前のバージョンを復元するには？

[チェックポイント](/docs/checkpoints/)を開くと、ビルドに成功した時点のソースを比較し、バージョンを復元できます。自分で管理する Git のコミットには、[ソース管理](/docs/git-history/)を使います。

### 共著者と共同で作業できますか？

はい。[ライブコラボレーション](/docs/collaboration/)では、グループが運営するコラボレーションサーバーを通じて、あなたと共著者が同じプロジェクトを同時に編集します。それぞれが、プロジェクトをファイルとして自分のコンピュータに保持します。ソースのアーカイブを共有したり、[GitHub 同期](/docs/github-sync/)でコミットをやり取りしたりすることもできます。

### 2 台のコンピュータでプロジェクトを使えますか？

はい。[クラウド同期](/docs/cloud-sync/)は、ライブラリのプロジェクトと設定をあなた自身の Dropbox に保管し、接続した各コンピュータがそれをダウンロードできます。接続するには、**設定 → データの保存 → クラウド同期**を開きます。[GitHub 同期](/docs/github-sync/)でプロジェクトをコンピュータ間で移すこともできます。

### ソースを書き出せばすべてバックアップされますか？

バックアップされるのはプロジェクトのソースです。自動チェックポイント、アプリの環境設定、認証情報は別の場所にあります。必要なものを含めるには、[バックアップガイド](/docs/where-your-data-lives/#back-up-your-work)に従ってください。

## 問題を報告する

**設定 → ヘルプと情報 → 情報をコピー** を開き、その内容に、短い説明、問題を再現する手順、関連するログを添えてください。報告は [Issues](https://github.com/Oleafly/Oleafly/issues) で行い、質問やワークフローの相談には [Discord コミュニティ](/discord)を使ってください。
