FAQ とトラブルシューティング
はじめかた、プロジェクト、コンパイル、アシスタント、バックアップについての簡単な答えをまとめています。
はじめに
「はじめに」セクションアカウントは必要ですか?
「アカウントは必要ですか?」セクションいいえ。Oleafly をダウンロードして開けば、すぐに書き始められます。クラウドの AI プロバイダ、GitHub、Dropbox といった任意のサービスは、それぞれ専用のアカウントを使います。
Oleafly は LaTeX、Typst、Markdown に対応していますか?
「Oleafly は LaTeX、Typst、Markdown に対応していますか?」セクションはい。エンジンはプロジェクトを作成するときに選びます。エンジンごとに、編集と書き出しの機能が異なります。クイックスタートで、最初の PDF を作るまでの流れを説明しています。
既存の論文や履歴書を持ち込めますか?
「既存の論文や履歴書を持ち込めますか?」セクションはい。プロジェクトのソース、ZIP アーカイブ、Git リポジトリを読み込めます。DOCX やテキストベースの PDF からの変換経路もあります。既存の作業を Oleafly に取り込むを読んで、合う経路を選んでください。
オフラインで作業できますか?
「オフラインで作業できますか?」セクションクラウドに接続しなくても、執筆、ファイルの整理、ローカルの校正、ダウンロード済みのローカル AI モデルの実行ができます。Tectonic は、キャッシュ済みのパッケージを使ってコンパイルできます。新しいパッケージ、リモートの参考文献、クラウドのモデル、GitHub、ダウンロードには接続が必要です。オフラインに持ち出す前に、コンパイルを一度成功させてプロジェクトを準備しておいてください。
ファイルはどこにありますか?
「ファイルはどこにありますか?」セクションプロジェクトは、ローカルのライブラリにあるふつうのフォルダです。コピーしたり、バックアップしたり、別のツールで開いたりできます。プロジェクトのファイル、アプリの設定、チェックポイントについては、データの保存場所で説明しています。
学位論文や履歴書にも Oleafly を使えますか?
「学位論文や履歴書にも Oleafly を使えますか?」セクションはい。学位論文のワークフローまたは履歴書のワークフローから始めてください。どちらも、研究論文と同じエディタ、プレビュー、参考文献、書き出しのツールを使います。
インストール
「インストール」セクションOS がインストーラーをブロックする
「OS がインストーラーをブロックする」セクションファイルが公式のリリース (新しいタブで開きます)から入手したもので、お使いのプラットフォームに合っていることを確認してください。プラットフォームごとの初回起動の手順は、インストールガイドに従ってください。
Linux ではどのパッケージを使えばよいですか?
「Linux ではどのパッケージを使えばよいですか?」セクションお使いのコンピュータに合うアーキテクチャを選び、AppImage、Debian パッケージ、RPM のいずれかを使います。システム要件は Linux へのインストールを参照してください。
コンパイル
「コンパイル」セクション最初のコンパイルが遅い
「最初のコンパイルが遅い」セクションTectonic が、この文書で使うパッケージをダウンロードしている可能性があります。そのコンピュータでの最初のコンパイルでは、よく使われるパッケージもまとめて取得します。ダウンロードしたパッケージは、次回以降のビルドのためにキャッシュされます。パッケージがまだダウンロード中の間は、コンパイルが通常の 5 分の制限を超えて続くことがあります。何が起きているかは、ログを開くと確認できます。
パッケージが見つからない
「パッケージが見つからない」セクションオフラインモードがオンの場合は、メッセージのオフにしてコンパイルを選ぶか、1 回のコンパイルだけオフにして、パッケージを取得します。システムの TeX ツールチェーンでは、エラーの探してインストールを使います。Debian、Ubuntu、Fedora の TeX Live は、パッケージを apt か dnf で入れます。LaTeX のエンジンとパッケージを参照してください。
pdfLaTeX を選んだら Oleafly が TeX ディストリビューションを求める
「pdfLaTeX を選んだら Oleafly が TeX ディストリビューションを求める」セクションpdfLaTeX、XeLaTeX、LuaLaTeX、upLaTeX、pLaTeX は、お使いのコンピュータにインストールされた TeX ディストリビューションで動きます。ない場合は、どれかを選ぶと、コンパイルの前にダイアログが開きます。TinyTeX をダウンロードして使うを選ぶとインストールされ、Tectonic に戻すを選ぶと組み込みのエンジンに戻ります。コンパイルが失敗したあとは、プレビューに同じ選択肢がTinyTeX をダウンロードして使うと Tectonic を使うとして表示されます。TeX が入っていないときを参照してください。
MiKTeX で latexmk に Perl が必要と表示される
「MiKTeX で latexmk に Perl が必要と表示される」セクションMiKTeX の latexmk は Perl で動きますが、MiKTeX には Perl が含まれていません。Strawberry Perl をインストールするか、設定 → エンジン → LaTeX から TinyTeX をインストールしてください。TinyTeX は独自の Perl が付いていて、MiKTeX に代わってコンパイルを引き受けます。MiKTeX と Perlを参照してください。
PDF からテキストが欠けている
「PDF からテキストが欠けている」セクションフォントにそれらの文字のグリフがありません。韓国語、中国語、日本語のテキストで最もよく起こり、TeX はコンパイルを失敗させずに、その文字を省きます。Oleafly が警告を出し、ログに一覧を表示します。LaTeX では、警告に示された、お使いの文字体系用の設定を貼り付けます。Typst では、通知に表示されるフォントパックをダウンロードするか、その文字を持つフォントをプロジェクトの fonts フォルダに追加します。Markdown では、YAML ヘッダーの mainfont か CJKmainfont を、その文字を持つフォントに設定します。PDF から文字が欠けるときと文字が四角で表示されるときを参照してください。
Oleafly がコンパイルに時間がかかりすぎるとして止めた
「Oleafly がコンパイルに時間がかかりすぎるとして止めた」セクションコンパイルは 5 分間実行できます。パッケージがまだダウンロード中の間は、制限が最大 30 分まで延びます。Markdown から PDF へのビルドは 15 分、Quarto と Calepin は 1 時間です。もう一度コンパイルしてください。ダウンロードは止まったところから再開されます。Tectonic で長い下書きを扱う場合は、コンパイルメニューでコンパイルモードを高速にします。
新しいプロジェクトで自分の TeX インストールを使えますか?
「新しいプロジェクトで自分の TeX インストールを使えますか?」セクションはい。 設定 → エンジン → LaTeX を開いて 既定のコンパイルエンジン を latexmk(システム TeX) に設定します。新規、読み込み、変換のいずれの LaTeX プロジェクトも、それで始まるようになります。新規プロジェクトの既定を設定するを参照してください。
文書で minted や PythonTeX を使っている
「文書で minted や PythonTeX を使っている」セクションこれらのパッケージは、文書のコンパイル中に別のプログラムを実行しますが、Oleafly は既定でそれをブロックします。システムの LaTeX が必要です。プロジェクト内のすべてのファイルを信頼できるなら、エディタの上のバナーで 外部コマンドを許可 を選びます。外部コマンドを許可するを参照してください。
コンパイルは警告付きで終わった
「コンパイルは警告付きで終わった」セクションログ を開き、まず未定義の引用と参照を確認します。書き出す前に、プリフライトで該当するソースの場所を見つけられます。
ビルドエラーの意味がわからない
「ビルドエラーの意味がわからない」セクションアシスタントに、ログを読み、エラーを直して、もう一度コンパイルするよう頼みます。途中の提案を確認したいときは 承認を求める を使います。ログを Discord のヘルプフォーラムに投稿することもできます。
書き出し形式が表示されないのはなぜですか?
「書き出し形式が表示されないのはなぜですか?」セクション使える形式は、エンジンと文書の種類によって決まります。書き出しの表を確認してください。
AI アシスタント
「AI アシスタント」セクションどのアシスタントを使えますか?
「どのアシスタントを使えますか?」セクションモデルのプロバイダを接続するか、ローカルモデルを使うか、CLI エージェントを選びます。各経路は AI のセットアップで説明しています。
エディタを使うのに AI は必要ですか?
「エディタを使うのに AI は必要ですか?」セクションいいえ。執筆、コンパイル、引用、プレビュー、ダイアグラム、プロジェクトの履歴、書き出しは、アシスタントがなくても使えます。
アシスタントには何ができますか?
「アシスタントには何ができますか?」セクションプロジェクトのファイルを扱い、出典を調べ、PDF を確認し、図を作り、ツールを実行し、ビルドの修復を手伝えます。作業に合うプランと承認のポリシーを選んでください。チャットとツールを参照してください。
モデルの横の「検証済み」は何を意味しますか?
「モデルの横の「検証済み」は何を意味しますか?」セクションそのモデルが、ツール呼び出しの検査に合格したことを示します。プロジェクトの操作に使うモデルを選ぶ助けにはなりますが、文章や調査の質を評価するものではありません。AI のセットアップを参照してください。
使用量が「不明」と表示されるのはなぜですか?
「使用量が「不明」と表示されるのはなぜですか?」セクション使用量を報告しないプロバイダや CLI エージェントがあります。「不明」は、値を取得できないという意味です。使用量と予算を読んでください。
外部のアシスタントを接続できますか?
「外部のアシスタントを接続できますか?」セクションはい。組み込みの CLI エージェントの接続を使うか、Oleafly のローカルな MCP サーバーを有効にするか、アプリを閉じていても使える oleafly コマンドにエージェントを接続します。
履歴と共同作業
「履歴と共同作業」セクション以前のバージョンを復元するには?
「以前のバージョンを復元するには?」セクションチェックポイントを開くと、ビルドに成功した時点のソースを比較し、バージョンを復元できます。自分で管理する Git のコミットには、ソース管理を使います。
共著者と共同で作業できますか?
「共著者と共同で作業できますか?」セクションはい。ライブコラボレーションでは、グループが運営するコラボレーションサーバーを通じて、あなたと共著者が同じプロジェクトを同時に編集します。それぞれが、プロジェクトをファイルとして自分のコンピュータに保持します。ソースのアーカイブを共有したり、GitHub 同期でコミットをやり取りしたりすることもできます。
2 台のコンピュータでプロジェクトを使えますか?
「2 台のコンピュータでプロジェクトを使えますか?」セクションはい。クラウド同期は、ライブラリのプロジェクトと設定をあなた自身の Dropbox に保管し、接続した各コンピュータがそれをダウンロードできます。接続するには、設定 → データの保存 → クラウド同期を開きます。GitHub 同期でプロジェクトをコンピュータ間で移すこともできます。
ソースを書き出せばすべてバックアップされますか?
「ソースを書き出せばすべてバックアップされますか?」セクションバックアップされるのはプロジェクトのソースです。自動チェックポイント、アプリの環境設定、認証情報は別の場所にあります。必要なものを含めるには、バックアップガイドに従ってください。
問題を報告する
「問題を報告する」セクション設定 → ヘルプと情報 → 情報をコピー を開き、その内容に、短い説明、問題を再現する手順、関連するログを添えてください。報告は Issues (新しいタブで開きます) で行い、質問やワークフローの相談には Discord コミュニティを使ってください。