# パッケージ

CTAN で LaTeX パッケージを、Typst Universe で Typst パッケージを検索し、エディタのツールバーから文書に追加します。

LaTeX と Typst の文書は、追加機能のほとんどをパッケージから得ています。エディタのツールバーの右端にあるパッケージのボタンを押すと、プロジェクトの言語に対応した、検索できる一覧が開き、パッケージを読み込む行を代わりに書き込んでくれます。Markdown プロジェクトには、パッケージのボタンはありません。

⌘K のパレットから **LaTeX パッケージを見る** または **Typst パッケージを見る** でも一覧を開けます。

## LaTeX パッケージ

LaTeX プロジェクトでは **LaTeX パッケージ** を選びます。パッケージ名や説明で CTAN を検索できます。CTAN に接続できない場合や、オフラインの場合は、ダイアログにその旨が表示され、代わりに Oleafly 組み込みの一覧が表示されます。更新できなかった一覧には、ダウンロードした日付が表示されます。

各行には、次のラベルが表示されることがあります。

- **文書で使用中**: メインファイルが、すでにこのパッケージを読み込んでいます。
- **ドキュメントクラス**: この項目はパッケージではなくクラスです。クラスは `\documentclass` で指定するため、この行では、その行をコピーできますが、追加はできません。
- **インストール済み**: お使いの TeX ディストリビューションに、すでにそのパッケージがあります。

各行には、次の操作もあります。

- **オプション**: `margin=2cm` のようなパッケージのオプションを入れる欄です。波かっこの対応が取れている必要があり、`]` と `%` は使えません。
- **プリアンブルに追加**: `\usepackage[options]{name}` をメインファイルのプリアンブルに書き込みます。ファイルがすでにそのパッケージを読み込んでいる場合は、何も変わらず、ダイアログでそれが通知されます。
- **行をコピー**: 同じ `\usepackage` の行をコピーします。クラスの場合は `\documentclass` の行です。
- **CTAN**: CTAN にあるそのパッケージのページを開きます。
- **インストール**: TeX ディストリビューションにないパッケージ用です。下を参照してください。

### 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 では、ファイルが見つからないコンパイルのエラーに **探してインストール** が表示され、そのファイルがどのパッケージに属するかを調べます。[見つからないファイルから復旧する](/docs/latex-engines/#recover-from-a-missing-file)を参照してください。

コンパイラは **再コンパイル** の横の矢印から選びます。[LaTeX のエンジン](/docs/latex-engines/)を参照してください。

## 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 に固定されているプロジェクトでは、セクションにその旨が表示されます。

このセクションには、プロジェクトが保持しているパッケージの数も表示されます。

### オフライン

オフラインモードがオンのときは、ダイアログは前回ダウンロードしたパッケージの一覧を使い、その日付を表示します。一覧を一度もダウンロードしていない場合は、オンラインになるまで一覧を表示できません。

## 関連ページ

- [エディタ](/docs/editor/#the-editor-toolbar): エディタのツールバーのそのほかの機能
- [コンパイル](/docs/compiling/): ビルド中にパッケージを取得する仕組み
- [文書設定](/docs/document-settings/): パッケージのコードを書かずに、用紙サイズ、余白、フォントを設定する
