コンパイル
LaTeX、Typst、Markdown のプロジェクトをコンパイルし、エンジンごとのコンパイルオプションを選び、ログを読み、オフラインでのパッケージ取得を制御します。
新しい LaTeX プロジェクトは、 設定 → エンジン → LaTeXで選んだ既定のコンパイルエンジンで始まります。初期状態では、Oleafly に同梱されている XeTeX ベースのエンジン Tectonic です。従来の TeX ツールチェーンが必要なプロジェクトでは、そのプロジェクトだけに、または既定として、latexmk を使うこともできます。Typst プロジェクトは、組み込みの Typst か、プロジェクトが固定した別のバージョンでコンパイルされます。Markdown プロジェクトは Pandoc と Tectonic を通ります。LaTeX のコンパイラと Typst のバージョンはプロジェクトごとの設定なので、1 つのプロジェクトを変更しても、ほかのプロジェクトには影響しません。
コンパイルを開始する
「コンパイルを開始する」セクション
- ⌘↵(Ctrl+Enter)。どの画面からでも使えます。
- ツールバー右上のコンパイルボタン。プロジェクトに結果ができると、再コンパイルという表示になります。
- ⌘K コマンドパレットの再コンパイル。
- PDF パネルが表示されるビューでプロジェクトを開くと、自動で 1 回コンパイルされるので、最新のプレビューが表示されます。
- ターミナルやスクリプトでの
oleafly build。コマンドラインツールを参照してください。
コンパイルでは、必ず先にアクティブなファイルが保存されるので、PDF は画面に見えている内容と一致します。エディタのみのビューにいる場合は、コンパイルすると分割ビューが表示され、結果を確認できます。
コンパイルのオプション
「コンパイルのオプション」セクション再コンパイルの横の矢印で、コンパイルのオプションが開きます。メニューには、そのプロジェクトのエンジンで意味のあるオプションだけが表示されます。
| グループ | Tectonic の LaTeX | latexmk の LaTeX | Typst | Markdown |
|---|---|---|---|---|
| 自動コンパイル | はい | はい | はい | はい |
| コンパイルモード (通常または高速) | はい | いいえ | いいえ | いいえ |
| 構文チェック | はい | はい | いいえ | いいえ |
| コンパイラ(このプロジェクト) | はい | はい | いいえ | いいえ |
| Typst のバージョン / フォント / ビルド / バリアント | いいえ | いいえ | はい | いいえ |
| コンパイルエラーの扱い | はい | はい | いいえ | いいえ |
コンパイルを停止と最初から再コンパイルは、どのエンジンでもメニューの下部にあります。 バリアントグループは、Typst プロジェクトにビルドバリアントができると表示されます。
コンパイラ(このプロジェクト) では、 Tectonic が組み込みです。 自動は、システムの TeX を latexmk 経由で実行し、ソースからコンパイラを判断します。 pdfLaTeX / XeLaTeX / LuaLaTeX はそのコンパイラを固定し、こちらも latexmk 経由で実行します。また、upLaTeX と pLaTeX は日本語の文書をコンパイルします。Tectonic 以外のどの選択肢にも TeX ディストリビューションが必要です。このコンピュータにない場合、どれかを選んだときに Oleafly が TinyTeX のインストールを提案します。TeX が入っていないときを参照してください。Typst のグループについては Typst プロジェクトを参照してください。
自動コンパイル
「自動コンパイル」セクションコンパイルのオプションで自動コンパイルをオンにするか、⌘K パレットで自動コンパイルを有効にするを実行します。既定ではオフで、すべてのプロジェクトに適用され、同じ操作でオフに戻せます。
LaTeX または Markdown プロジェクトでは、入力を止めて約 2.5 秒後に Oleafly が再コンパイルします。きっかけになるのは実際の編集だけです。タブを切り替えたり、ファイルを開いたりしても、再コンパイルされません。
Typst プロジェクトでは、自動コンパイルがライブプレビューになります。Oleafly は Typst のプロセスを 1 つ動かし続け、開いているファイルは入力を止めた少し後に自動で保存され、PDF は同じスクロール位置のまま更新されます。自動コンパイルによるライブプレビューを参照してください。
コンパイルが積み重なることはありません。自動コンパイルの実行中に編集すると、Oleafly はそれを止めて最新のテキストでやり直すので、PDF が早く追いつきます。次の場合は、コンパイルを最後まで実行させます。あなたやエージェントが開始したコンパイル、パッケージをダウンロードしているコンパイル、ほぼ終わっているコンパイル、それ自体が再開によるコンパイルの場合です。これらの場合は、後続のコンパイルがちょうど 1 つキューに入るので、最終的な PDF には最新の編集が反映されます。
進行状況を見る
「進行状況を見る」セクションビルド中は、プレビューの上端に細い進行状況バーが表示され、最初の PDF ができる前は、パネルにおおよその進捗が割合で表示されます。ビルドが終わると、ツールバーにコンパイル時間と重大度を示すアイコンが付いたステータスチップが表示されます。
- 緑のチェック:正常にコンパイルされました。
- 琥珀色の三角:警告付きでコンパイルされました。PDF は得られます。
- 赤いバツ:エラー付きでコンパイルされました。
成功すると、プレビューは自動的に PDF に切り替わります。ログビューに切り替わるのは、本当の失敗(PDF ができなかった場合)だけです。

ログを読む
「ログを読む」セクション
プレビューのツールバー左側のログボタンで、PDF とコンパイルログを切り替えられます。バッジにはエラー(赤)または警告(琥珀色)の数が表示されます。
- 上部に、解析された診断リスト。エラーや警告ごとに、その種類と、分かる場合は
l.42のような行の参照が表示されます。フォントが表示できなかった文字は、欠けている文字にまとめられます。 - その下に、色分けされたコンパイラの生ログ全体。エラーは太字の赤、行の参照は強調表示、ファイルの入れ子はインデントで表されます。
- ログをコピーボタンで全体をまとめてコピーでき、バグ報告やフォーラムへの投稿に使えます。ログ内で ⌘A のあとに ⌘C を押しても、すべてコピーできます。
- ログをコピーの隣の消去は、次にコンパイルするまで、ログとそのエラーを非表示にします。ビルドファイルは残り、次のコンパイルで新しいログが作成されます。
長いログも、10 万行あるものでもすぐに開き、空白が出ずにスクロールできます。
コンパイルエラーは、リンターのパイプラインを通じて、エディタ内で波線にもなります。また、エラーの修正を頼むと、AI アシスタントが get_log ツールで同じログを読めます。
Typst のエラーは、Typst が報告した範囲そのままにエディタ上でマークされ、ソースの行と Typst 自身のヒントも表示されます。よくあるエラーには、何が起きたかを分かりやすく説明した文も付きます。
パッケージとオフラインコンパイル
「パッケージとオフラインコンパイル」セクションTectonic は、文書が初めて必要とした時点で LaTeX パッケージをダウンロードし、ローカルにキャッシュします。そのコンピュータでの最初のコンパイルでは、よく使われるパッケージもまとめて取得します。その最初のコンパイルは遅くなることがあり、ネットワーク接続が必要です。以降のコンパイルではキャッシュを使います。Oleafly のパッケージミラーが失敗した場合、コンパイルはアップストリームの取得元に切り替わり、ログにもそのことが表示されます。
設定の「一般」またはコマンドパレットにあるオフラインモードを使うと、Tectonic についてはこれが保証されます。コンパイラは --only-cached で実行され、パッケージを取得することは決してありません。キャッシュにないパッケージが必要な文書は、可能な場合はファイル名を示すメッセージで失敗し、オフにしてコンパイルを選ぶと、オフラインモードをオフにして再びコンパイルします。
オフラインモードは Typst にも適用されます。オンの間、Typst はパッケージをダウンロードできないため、すべての @preview パッケージが、すでにキャッシュにあるか、プロジェクトの typst-packages フォルダに取り込まれている必要があります。Typst Universe のパッケージを参照してください。Markdown プロジェクトはオフラインモードの対象外で、ログにもそのことが表示されます。
latexmk は、お使いのマシンにすでにインストールされている TeX ディストリビューションを使います。Oleafly はまず、MacTeX、TeX Live、MiKTeX、TinyTeX などのシステムのディストリビューションを確認し、設定 → エンジン → LaTeX では、コンパイルに使っているものに使用中と表示されます。どれもない場合は、アプリが独自の TinyTeX を用意して管理できます。MiKTeX で latexmk を実行するには Perl も必要です。MiKTeX と Perlを参照してください。システムの TeX のプロセスは、あなたのユーザーアカウントで読めるファイルを読み取れるため、latexmk は信頼できるプロジェクトでのみ使ってください。
latexmk のビルドで .sty、.cls、参考文献スタイル、フォントファイル、babel の言語ファイル、TikZ のライブラリなどの TeX ファイルが見つからない場合、Oleafly はエラーメッセージに探してインストールを表示することがあります。ファイル名とパッケージ名は異なることがよくあります。たとえば tikz.sty は TeX Live のパッケージ pgf に含まれます。Oleafly はその所属パッケージを特定し、tlmgr でインストールし、パッケージ一覧を更新して、再コンパイルします。Debian、Ubuntu、Fedora では、TeX Live はシステムのパッケージマネージャが管理しているため、Oleafly は代わりに apt か dnf のコマンドを示します。先に検索したい場合や、パッケージを手動で管理したい場合は、 設定 → エンジン → LaTeX のパッケージの一覧を使ってください。
制限と安全装置
「制限と安全装置」セクション- プロジェクトごとに、コンパイルは同時に 1 つだけ実行され、最新のものだけを残すキューで処理されます。新しい要求が古い要求に取って代わるので、ビルド中にプロジェクトを切り替えても間違った PDF が表示されることはなく、入力中にコンパイルが殺到することもありません。
- 新しい要求に取って代わられたビルドやタイムアウトしたビルドは、実際にキャンセルされます。Oleafly は、どのプラットフォームでも、コンパイラのプロセスツリー全体を終了させ、バックグラウンドで動かし続けることはありません。
- 5 分を超えて続くコンパイルは、延々と動き続けるのではなく、停止されます。Tectonic がまだパッケージをダウンロードしている間は、ダウンロードのたびに制限が先へ延び、合計で最大 30 分になります。Markdown から PDF へのビルドは 15 分、Quarto と Calepin は 1 時間です。
- 結果には要求に紐づいた識別子が付くので、順序が入れ替わって終わった古い PDF は、表示されずに拒否されます。
よくある失敗と簡単な対処
「よくある失敗と簡単な対処」セクション- オフラインモードでの「パッケージがありません」:メッセージのオフにしてコンパイルを選ぶか、1 回のコンパイルだけオフラインモードをオフにしてパッケージを取得・キャッシュし、その後オンに戻します。
- 「このコンパイラには動作する TeX ディストリビューションが必要です」:pdfLaTeX などの
latexmkのコンパイラはこのコンピュータに TeX が必要なので、TeX がない状態で選ぶとこのダイアログが開きます。TinyTeX をダウンロードして使うを選ぶか、Tectonic に戻すを選んで組み込みのエンジンに戻します。すでにこの理由でコンパイルが失敗している場合、プレビューにはTinyTeX をダウンロードして使うと Tectonic を使うが表示されます。TeX が入っていないときを参照してください。 - MiKTeX での「latexmk には Perl が必要です」:Strawberry Perl をインストールするか、独自の Perl が付いてくる TinyTeX をインストールします。MiKTeX と Perlを参照してください。
latexmkのビルドでファイルが見つからない:探してインストールを使います。検索に失敗した場合は、設定 → エンジン → LaTeX のパッケージの一覧で、ファイル名またはパッケージ名を検索します。Debian、Ubuntu、Fedora では、aptかdnfでインストールします。MiKTeX のパッケージは MiKTeX Console で管理します。- upLaTeX や pLaTeX がインストールされていない:表示されたら**日本語対応をインストール(約 450 MB)**を選ぶか、メッセージに示されたコマンドを実行します。日本語の文書: upLaTeX と pLaTeXを参照してください。
- PDF からテキストが欠けている(韓国語、中国語、日本語であることが多い):フォントにそれらの文字のグリフがなく、TeX は失敗させずに省いています。Oleafly が警告を出し、ログには貼り付けて使える設定が示されます。PDF から文字が欠けるときを参照してください。Typst については 文字が四角で表示されるときを参照してください。
- 索引、用語集、記号一覧が PDF にない:Tectonic は
makeindexを実行できません。プロジェクトをlatexmkに切り替えるか、外部ツールが不要な\makenoidxglossariesで用語集を作ります。latexmkでは、xindyや\newglossaryで作る一覧は作成されません。 - コンパイルが時間切れになった:もう一度コンパイルします。パッケージがまだダウンロード中だった場合は、ダウンロードが止まったところから再開されます。Tectonic で長い下書きを扱う場合は、コンパイルモードを高速にします。
- Tectonic での EPS 図、強制された
pdftexドライバ、見つからないバンドルファイル:エンジンのダイアログが開きます。開かないとき、または閉じてしまったときは、エンジンを選択を選びます。Tectonic では足りないときに、各ビューでの場所が載っています。おすすめと表示された選択肢を選んでください。Oleafly が動作する TeX ディストリビューションを見つけたときはシステムの LaTeX、見つからないときは TinyTeX をダウンロードして使うです。パッケージが見つからない場合は、切り替え後に Oleafly がインストーラーへ進めます。 minted、PythonTeX、\write18がブロックされる:プロジェクト内のすべてのファイルを信頼できる場合は、エディタ上部のバナーで外部コマンドを許可を選びます。外部コマンドを許可するを参照してください。- Tectonic でパッケージのダウンロードに失敗した:接続を確認し、メッセージのもう一度コンパイルを選びます。Oleafly はミラーのあとにアップストリームの取得元をすでに試していて、ダウンロードは止まったところから再開されます。コンピュータがオフラインだった場合は、接続が戻ると自動でもう一度コンパイルされます。
- 「Typst 0.13.1 がインストールされていません」:プロジェクトが、このコンピュータにない Typst のバージョンを固定しています。プレビューで Typst 0.13.1 をダウンロードを選ぶか、既定のバージョンの Typst を使うを選んで、固定を外します。固定したバージョンがないときを参照してください。
- 未定義の引用や参照の警告:プリフライトが、ファイルと行を付けてすべて特定します。
- 解釈できないエラー:AI に頼みます。「LaTeX のエラーを修正して」と頼むと、コンパイル、ログの読み取り、的を絞った編集、再コンパイルというループが実行されます。選択中の承認ポリシーが適用されます。
ほかのドキュメントエンジン
「ほかのドキュメントエンジン」セクションLaTeX のコンパイラの選択は、プロジェクトのドキュメントエンジンとは別のものです。
- Typst プロジェクトは、組み込みの Typst 0.15.1 か、プロジェクトが固定したバージョンでコンパイルされます。Typst プロジェクトを参照してください。
- Markdown プロジェクトは、管理された Pandoc を使い、PDF エンジンに Tectonic を使って PDF にビルドされます。
- Quarto プロジェクトは、
.qmdと.Rmdのファイルを Quarto で PDF またはウェブページにレンダリングします。Quartoを参照してください。 - Calepin プロジェクトは、Typst の文書内のコードを Calepin で実行してから、組み込みの Typst で PDF をビルドします。Calepinを参照してください。どちらのエンジンも、あなたが許可するまで、プロジェクトのコードを実行しません。
- タグ付きのアクセシブルな PDF には、システムの TeX、または Oleafly が管理する TinyTeX による LuaLaTeX を使います。LaTeX のエンジンとパッケージを参照してください。Typst 0.14 以降は、追加の手順なしにすべての PDF にタグが付きます。
エンジンはプロジェクトを作成するときに決める、プロジェクトごとの選択で、インターフェースもそれに合わせて変わります。エンジンが対応していない操作は、失敗するまま放置されるのではなく、非表示になります。LaTeX プロジェクトを Typst に移すには、新しい Typst プロジェクトに変換します。
成功したビルドのソースを残す
「成功したビルドのソースを残す」セクションチェックポイントを有効にすると、コンパイルに成功したときのソースが保存されます。手動の Git のワークフローを変えずに、以前のビルドを比較したり復元したりできます。
コンパイル済みの PDF そのものをプロジェクトフォルダに残すには、プレビューの保存メニューでコンパイル時に PDF を同期をオンにします。