# 자동 완성과 슬래시 명령

패키지를 인식하는 LaTeX 명령, Typst 함수와 패키지, 인용 정보, 파일 경로, 수식 단축키, 재사용할 수 있는 스니펫.

LaTeX에서 편집기는 입력하는 동안 명령, 상호 참조, 인용의 세 가지를 자동으로 완성합니다. 구조는 `/` 슬래시 메뉴로 더하면 대부분의 문서를 보일러플레이트를 직접 입력하지 않고도 쓸 수 있습니다. 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`에 없다면 [인용 조회](/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`이 들어 있는 완전한 그림 float |
| `/table` | 시작용 `tabular`가 들어 있는 표 float |
| `/bold`, `/italic` | `\textbf{}`, `\textit{}` |
| `/label` | `\label{}` |
| `/usepackage` | `\usepackage{}` |

모든 항목은 탭 정지 지점이 있는 스니펫으로 삽입되므로 Tab을 누르면 빈칸을 차례로 따라갈 수 있습니다(캡션, 레이블, 그다음 순서로).

## Typst 자동 완성

Typst 파일에는 자체 자동 완성이 제공되며, 대부분 프로젝트의 Typst 버전에 맞는 Typst 언어 서버인 Tinymist에서 옵니다.

| 입력하는 위치 | 메뉴에 나오는 항목 |
|---|---|
| `#` 뒤에 이름 | 함수와 변수 |
| `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{}` 같은 지원되는 명령 안에서는 프로젝트 파일 경로가 자동 완성됩니다.
