コンテンツにスキップ
Oleaflyv0.4.12

文書ツール

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

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

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

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

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

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

  • エディタ: エディタのツールバーのそのほかの機能
  • コンパイル: ビルド中にパッケージを取得する仕組み
  • 文書設定: パッケージのコードを書かずに、用紙サイズ、余白、フォントを設定する
画像のプレビュー

AI の回答を読み込めませんでした

もう一度試すか、ドキュメントを検索してください。