# 自動補完とスラッシュコマンド

パッケージを認識する LaTeX コマンド、Typst の関数とパッケージ、引用の詳細、ファイルパス、数式のショートカット、再利用できるスニペット。

LaTeX では、入力に合わせてエディタが 3 つのものを補完します。コマンド、相互参照、引用です。構造を入れるための `/` スラッシュメニューを加えれば、たいていのドキュメントは定型文を打たずに書けます。Typst ファイルには独自の補完とスニペットがあり、[Typst の補完](#typst-completion)で説明しています。

入力中は候補が自動で表示されます。Ctrl+Space を押すと、どこでも候補を呼び出せます。Tab か Enter で確定します。

## コマンドの補完

バックスラッシュを入力して続けます。`\sec…` では `\section` が、`\fra…` では `\frac` が候補に出ます。補完は、幅広い LaTeX コマンドの一覧と、プロジェクトで使っているパッケージをもとにしています。ソース内で定義したコマンドや環境も含まれます。

補完は、タブストップ付きのスニペットとして挿入されます。`\frac` を確定すると `\frac{│}{}` が入り、カーソルは分子の位置に置かれます。Tab を押すと分母に移ります。`\itemize`、`\enumerate`、`\equation`、`\align` のような環境の補完では、`\begin…\end` のブロック全体が挿入され、カーソルはその内側に置かれます。

## 参照の補完

`\ref{`、`\eqref{`、`\pageref{`、`\autoref{`、`\cref{`、`\Cref{` の中では、ドキュメントで定義したすべての `\label{}` がメニューに並びます。ラベルを `fig:arch` と `fig:architecture` のどちらにしたか思い出すために、上へスクロールする必要はもうありません。

![refs.bib から引用キーが補完され、閉じていない波括弧は閉じるまで警告として示されます。](https://cdn.oleafly.com/images/gifs/desktop/latex-completion.gif?v=2)

## 引用の補完

`\cite{` とその仲間 (`\citep`、`\citet`、`\citeauthor`、`\citeyear`、`\parencite`、`\textcite`) の中では、プロジェクトの `.bib` ファイルにある引用キーがメニューに並びます。`.bib` ファイルは、プロジェクトを開くときに自動で解析されます。

論文がまだ `.bib` にない場合は、[引用の検索](/docs/citations/)を使います。DOI かタイトルを貼り付けると、Oleafly が項目と `\cite` を一度に追加します。

## 数式と構造

`$`、`\(`、`\[` を入力すると、対応する閉じの区切り文字が挿入されます。カーソルが挿入された閉じの `$` に達したら、もう一度 `$` を入力すると、それを越えて進めます。インライン数式の中では括弧が対になって入力され、空の `$$` の組は、区切り文字の間で Enter を押すとディスプレイ数式になります。

リスト環境を確定すると、最初の `\item` が挿入されます。項目の末尾で Enter を押すとリストが続き、description のラベルや、入れ子のリストのインデントも引き継がれます。通常の改行をしたいときは Shift+Enter を押します。新しい項目を空のままにしてもう一度 Enter を押すと、リストが終わります。

閉じていない `\begin{...}` を自分で入力した場合は、Enter で対応する `\end{...}` が追加されます。いちばん内側の開いている環境を閉じるには **⌘⌥.** (Ctrl+Alt+.) を、選択範囲を環境で囲むには ⌘⌥E (Ctrl+Alt+E) を使います。数式の中で `@` を入力すると、ギリシャ文字などの記号を一覧から選べます。

参照の候補には、ビルドに成功していれば、コンパイル後の番号も表示されます。引用の候補は、キーの元になっている論文を見分ける手がかりになります。

## 自動で閉じる動作を調整する

自動で入力される内容を減らしたい、または増やしたいときは、 **設定 → 外観 → エディタ**を開きます。

- **自動補完**は、入力中に候補を表示します。オフにしても、Ctrl+Space で候補を開けます。
- **括弧の自動補完**は、対応する括弧を挿入します。
- **数式の自動補完**は、`$`、`\(`、`\[` に対応する区切り文字を対にして入力します。
- **環境の自動補完**は、`\begin{...}` のあとで Enter を押すと、対応する `\end{...}` を挿入します。

自分の書き方と合わない補助機能だけをオフにしてください。手動の補完、環境を閉じる操作、囲むショートカットは引き続き使えます。

## スラッシュメニュー

どこでも `/` を入力すると挿入メニューが開き、入力に合わせて絞り込まれます。

| コマンド | 挿入される内容 |
|---|---|
| `/section`、`/subsection` | セクションを区切るコマンド |
| `/itemize` | 箇条書き |
| `/enumerate` | 番号付きリスト |
| `/item` | リストの項目 |
| `/equation` | ディスプレイ数式の環境 |
| `/align` | 揃えた複数行の数式 |
| `/frac` | 分数 |
| `/figure` | `\includegraphics` と `\caption` を含む、完全な figure フロート |
| `/table` | 最小限の `tabular` を含む table フロート |
| `/bold`、`/italic` | `\textbf{}`、`\textit{}` |
| `/label` | `\label{}` |
| `/usepackage` | `\usepackage{}` |

どれもタブストップ付きのスニペットとして挿入されるので、Tab を押すと空欄を順にたどれます (キャプション、ラベル、その先へと進みます)。

## Typst の補完

Typst ファイルには独自の補完があり、その多くは Tinymist から提供されます。Tinymist は、プロジェクトの Typst のバージョンに合わせた Typst の言語サーバーです。

| 入力する場所 | メニューに出るもの |
|---|---|
| `#` に続けて名前を入力 | 関数と変数 |
| `image(`、`read(`、`csv(`、`json(`、`yaml(`、`toml(`、`bibliography(` の中の文字列、または `#include` や `#import` のあと | プロジェクト内のファイルパス |
| `@`、または `ref(` や `cite(` の中の `<` | ラベルと引用キー (`.bib` と Hayagriva の `.yml` ファイルから) |
| `#import "@preview/` | Typst Universe のパッケージ |
| `#bibliography(...)` や `#cite(...)` の中の `style:` | 参考文献のスタイル名 (プロジェクト自身の `.csl` ファイルが先頭) |

行頭またはスペースのあとで `/` を入力すると、Typst のスニペットが出ます。`/heading`、`/figure`、`/tablefigure`、`/table`、`/equation`、`/numberedequation`、`/footnote`、`/quote`、`/code`、`/outline`、`/bibliography`、`/pagebreak`、`/columns`、`/grid`、`/link`、`/list`、`/enum`、`/terms` です。Typst 0.15 以降では、`/partbibliography` でドキュメントの一部分の参考文献を追加できます。

### Typst の数式とリスト

テキスト中で `$` を入力すると、閉じの `$` も挿入されます。空の組の中でスペースを入力するとディスプレイ数式 `$ | $` になり、空の組の中で Backspace を押すと両方の記号が消えます。テキストを選択した状態で `*`、`_`、バッククォート、`$` を入力すると、選択範囲を置き換えずに囲みます。これらは、前述の**括弧の自動補完**と**数式の自動補完**の設定に従います。

リストの中で Enter を押すと、次の `-`、`+`、`/`、または番号付きの項目が始まります。空の項目で Enter を押すとマーカーが消え、Shift+Enter を押すと、現在の項目が新しい行に続きます。Tab で項目を上の項目の下に入れ子にし、Shift+Tab で元に戻します。

## 知っておきたいこと

- **Tab には 2 つの役割があります**。開いている候補を確定し、候補がなければインデントします。
- 補完メニューは、ほかの場所をクリックすると閉じます。Esc で明示的に閉じることもできます。
- プロジェクト内のファイルパスは、`\input{}` や `\includegraphics{}` などの対応するコマンドの中で補完されます。
