文書ツール
パッケージ
CTAN で LaTeX パッケージを、Typst Universe で Typst パッケージを検索し、エディタのツールバーから文書に追加します。
LaTeX と Typst の文書は、追加機能のほとんどをパッケージから得ています。エディタのツールバーの右端にあるパッケージのボタンを押すと、プロジェクトの言語に対応した、検索できる一覧が開き、パッケージを読み込む行を代わりに書き込んでくれます。Markdown プロジェクトには、パッケージのボタンはありません。
⌘K のパレットから LaTeX パッケージを見る または Typst パッケージを見る でも一覧を開けます。
LaTeX パッケージ
「LaTeX パッケージ」セクションLaTeX プロジェクトでは LaTeX パッケージ を選びます。パッケージ名や説明で CTAN を検索できます。CTAN に接続できない場合や、オフラインの場合は、ダイアログにその旨が表示され、代わりに Oleafly 組み込みの一覧が表示されます。更新できなかった一覧には、ダウンロードした日付が表示されます。
各行には、次のラベルが表示されることがあります。
- 文書で使用中: メインファイルが、すでにこのパッケージを読み込んでいます。
- ドキュメントクラス: この項目はパッケージではなくクラスです。クラスは
\documentclassで指定するため、この行では、その行をコピーできますが、追加はできません。 - インストール済み: お使いの TeX ディストリビューションに、すでにそのパッケージがあります。
各行には、次の操作もあります。
- オプション:
margin=2cmのようなパッケージのオプションを入れる欄です。波かっこの対応が取れている必要があり、]と%は使えません。 - プリアンブルに追加:
\usepackage[options]{name}をメインファイルのプリアンブルに書き込みます。ファイルがすでにそのパッケージを読み込んでいる場合は、何も変わらず、ダイアログでそれが通知されます。 - 行をコピー: 同じ
\usepackageの行をコピーします。クラスの場合は\documentclassの行です。 - CTAN: CTAN にあるそのパッケージのページを開きます。
- インストール: TeX ディストリビューションにないパッケージ用です。下を参照してください。
LaTeX パッケージをインストールする
「LaTeX パッケージをインストールする」セクション「インストール済み」が何を意味するかは、プロジェクトのコンパイル方法によって変わります。
- 組み込みのコンパイラである Tectonic は、文書が初めてパッケージを使うときにダウンロードします。インストールするものはなく、ダイアログの上部にもその旨が表示されます。
- TeX Live または TinyTeX を使う latexmk: TeX ディストリビューションに
tlmgrがある場合、Oleafly はどのパッケージがあるかを調べて、インストール済み と表示し、残りには インストール を提示します。インストールでは、その 1 つのパッケージに対してtlmgrを実行します。 - Debian、Ubuntu、Fedora の TeX Live: システムのパッケージマネージャが管理しているため、ダイアログには
aptかdnfでパッケージをインストールするよう表示され、インストール ボタンはありません。 - MiKTeX などのほかの TeX 環境: Oleafly はどのパッケージがあるかを判別できないので、各行にインストールの状態は表示されません。MiKTeX には MiKTeX Console を使ってください。
TeX Live または TinyTeX では、ファイルが見つからないコンパイルのエラーに 探してインストール が表示され、そのファイルがどのパッケージに属するかを調べます。見つからないファイルから復旧するを参照してください。
コンパイラは 再コンパイル の横の矢印から選びます。LaTeX のエンジンを参照してください。
Typst パッケージ
「Typst パッケージ」セクションTypst プロジェクトでは Typst パッケージ を選んで Typst Universe を閲覧します。名前、キーワード、カテゴリで検索するか、カテゴリのチップで一覧を絞り込みます。ダイアログに一度に表示されるのは最大 100 件のパッケージなので、一覧が長いときは検索してください。
各行には、パッケージ名、最新バージョン、テンプレートのパッケージには テンプレート のバッジ、短い説明が表示されます。プロジェクトが使っているよりも新しい Typst をパッケージが必要とする場合は、必要なバージョンが行に表示されます。
- import を挿入 は、開いている
.typファイルの先頭にあるインポートの後ろに#import "@preview/name:version": *を追加します。ファイルがすでにそのパッケージをインポートしている場合は、バージョン番号だけが変わります。エディタで Typst ファイルを開いている必要があります。 - import をコピー は、同じ行をコピーします。
更新のヒント
「更新のヒント」セクションファイルの @preview インポートが Typst Universe の最新リリースより古い場合、エディタはそのバージョンに、「cetz 0.4.2 が利用できます。この import は 0.3.4 を使っています。」のようなヒントを表示します。ヒントの 0.4.2 に更新 という操作で、その場で番号が書き換わります。
パッケージをプロジェクトに保持する
「パッケージをプロジェクトに保持する」セクションTypst は、プロジェクトが初めてパッケージをインポートしたときに、共有キャッシュにダウンロードします。プロジェクトが独自のコピーを持つようにするには、ダイアログの下部にある プロジェクトのパッケージ を使います。
- プロジェクトフォルダのパッケージを使う をオンにすると、Typst はまずプロジェクトの
typst-packagesフォルダを探します。この設定にしたプロジェクトは、オフラインでも、ほかのコンピュータでもコンパイルできます。 - パッケージをプロジェクトに取り込む は、プロジェクトがインポートするすべてのパッケージを、キャッシュから
typst-packagesにコピーします。キャッシュにまだないパッケージがある場合は、オンラインでいったんコンパイルしてから、もう一度取り込みます。
どちらも Typst 0.12 以降が必要です。Typst 0.11 に固定されているプロジェクトでは、セクションにその旨が表示されます。
このセクションには、プロジェクトが保持しているパッケージの数も表示されます。
オフライン
「オフライン」セクションオフラインモードがオンのときは、ダイアログは前回ダウンロードしたパッケージの一覧を使い、その日付を表示します。一覧を一度もダウンロードしていない場合は、オンラインになるまで一覧を表示できません。