# 自動完成與斜線命令

感知套件的 LaTeX 命令、Typst 函式與套件、引用細節、檔案路徑、數學捷徑，以及可重複使用的程式碼片段。

在 LaTeX 中，編輯器會在你輸入時完成三件事：命令、交互參照與引用。再加上用於結構的 `/` 斜線選單，大多數文件都不必再手打固定格式的內容。Typst 檔案有自己的自動完成與程式碼片段，說明請見 [Typst 自動完成](#typst-completion)。

輸入時會自動出現建議；Ctrl+Space 可在任何地方叫出建議。按 Tab 或 Enter 接受。

## 命令自動完成

輸入反斜線後繼續打：`\sec…` 會提供 `\section`，`\fra…` 會提供 `\frac`。自動完成取材自廣泛的 LaTeX 命令目錄與專案所用的套件，也包含你原始碼中的自訂命令與環境。

自動完成會以帶有 Tab 停駐點的程式碼片段插入：接受 `\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` 裡，就該用[引用查詢](/docs/citations/)：貼上 DOI 或標題，Oleafly 會一步完成加入條目與 `\cite`。

## 數學與結構

輸入 `$`、`\(` 或 `\[` 時，會自動插入對應的結尾分隔符號。游標到達自動插入的結尾 `$` 時，再輸入一次 `$` 即可越過它。括號在行內公式中會成對出現，在分隔符號之間按 Enter，空的 `$$` 會變成行間公式。

接受清單環境時，會插入它的第一個 `\item`。在項目結尾按 Enter 可繼續清單，包括描述標籤或巢狀清單的縮排。按 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` 的完整圖片浮動體 |
| `/table` | 含起始 `tabular` 的表格浮動體 |
| `/bold`、`/italic` | `\textbf{}`、`\textit{}` |
| `/label` | `\label{}` |
| `/usepackage` | `\usepackage{}` |

所有項目都以帶有 Tab 停駐點的程式碼片段插入，因此按 Tab 就能依序填寫空白處（先是圖說，接著是標籤，然後繼續往下）。

## Typst 自動完成

Typst 檔案有自己的自動完成，主要來自 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 身兼兩職**：有開啟的建議時用來接受建議，否則用來縮排。
- 點選其他地方時，自動完成選單會關閉；也可以按 Esc 明確關閉。
- 在 `\input{}` 與 `\includegraphics{}` 這類支援的命令內，會自動完成專案檔案路徑。
