# 문서 설정

LaTeX 프리앰블, Typst set 규칙, Markdown 프런트매터를 편집하는 대화 상자에서 용지 크기, 여백, 글꼴, 언어, 줄 간격, 번호 매기기를 바꿉니다.

언어마다 페이지 설정이 있는 곳이 다릅니다. LaTeX에서는 클래스 옵션과 프리앰블 명령, Typst에서는 `#set` 규칙, Markdown에서는 프런트매터입니다. **문서 설정**은 이 모두를 하나의 양식으로 제공합니다. 적용하면 Oleafly가 변경 내용을 메인 파일에 나중에 읽고 편집할 수 있는 평범한 소스로 씁니다.

편집기 툴바 오른쪽 끝의 **문서 설정** 버튼으로 열거나, ⌘K(Ctrl+K) 팔레트에서 **문서 설정**을 실행하세요. 어떤 파일을 열어 두었든 이 대화 상자는 항상 프로젝트의 메인 문서를 편집합니다.

## 필드

양식은 네 개의 섹션으로 이루어져 있고, 필드는 엔진에 따라 다릅니다.

| 섹션 | LaTeX | Typst | Markdown |
| --- | --- | --- | --- |
| 페이지 | 용지 크기, 단 수, 여백 | 용지 크기, 여백, 단 수 | 문서 유형, 문서 클래스, 용지 크기, 단 수, 여백 |
| 텍스트 | 본문 글꼴, 글꼴 크기, 언어 | 본문 글꼴, 글꼴 크기, 언어, 지역 | 본문 글꼴, 글꼴 크기, 언어 |
| 문단 | 줄 간격 | 정렬, 줄 간격 | 줄 간격 |
| 번호 매기기 | 번호를 매길 수준, 수식 번호 | 제목 번호, 수식 번호 | 절 번호 |

목록은 **기본값**으로 시작하며, 이를 고르면 설정이 제거되어 클래스, 템플릿, 엔진의 기본값이 다시 적용됩니다. 텍스트 필드를 비워 두어도 같은 효과가 있습니다. 길이에는 `2.5cm`, `1in`, `11pt` 같은 단위를 쓰고, Typst 여백은 `auto`도 받습니다. Oleafly가 쓸 수 없는 값은 필드 아래에 짧은 안내가 표시되며, 고칠 때까지 **적용**이 기다립니다.

**본문 글꼴**은 입력하는 동안 글꼴을 제안합니다. Typst 프로젝트에서는 Typst가 찾을 수 있는 모든 글꼴이 목록에 나오고, 각 글꼴의 출처(프로젝트의 `fonts` 폴더, 컴퓨터, Typst 내장 세트)도 표시됩니다. LaTeX와 Markdown 프로젝트에서는 컴퓨터에 설치된 글꼴이 나열됩니다.

**적용**을 누르면 변경 내용이 기록되고, **취소**를 누르면 파일을 그대로 둡니다. 메인 파일이 편집기에 열려 있으면 ⌘Z(Ctrl+Z) 한 번으로 변경 전체가 취소됩니다.

## 값이 기록되는 곳

### LaTeX

- **용지 크기**, **단 수**, **글꼴 크기**는 `\documentclass`의 옵션이 됩니다.
- **여백**은 geometry 패키지로 들어갑니다. Oleafly는 기존 `\geometry{…}`나 geometry 옵션을 편집하거나 `\usepackage[margin=…]{geometry}`를 추가합니다.
- **본문 글꼴**은 `\setmainfont{…}`를 쓰고 fontspec을 불러옵니다. latexmk 프로젝트에서는 XeLaTeX나 LuaLaTeX 컴파일러가 필요하며, 컴파일 메뉴에서 하나를 고르거나 문서가 `% !TeX program = xelatex` 줄처럼 하나를 요청하기 전까지 필드에 그렇게 안내됩니다.
- **언어**는 babel에 언어를 추가하고, 문서가 polyglossia를 불러오면 `\setdefaultlanguage`를 쓰며, 그렇지 않으면 `\usepackage[language]{babel}`를 추가합니다. `english` 같은 babel 이름을 쓰세요.
- **줄 간격**은 **1줄**, **1.5줄**, **2줄**, 또는 `1.5` 같은 숫자입니다. setspace 패키지를 쓰며, 문서에 이미 `\linespread`가 있으면 그것을 씁니다.
- **번호를 매길 수준**은 `secnumdepth`를 설정합니다. **없음**, **장만**, 또는 **절까지**부터 **소단락까지**까지 번호를 매길 깊이를 고릅니다.
- **수식 번호**는 **절별**, **장별**, **소절별**에 대해 `\numberwithin{equation}{…}`를 씁니다.

### Typst

값은 메인 파일의 `#set` 규칙에 들어갑니다. 규칙이 없으면 Oleafly가 맨 위 근처에 추가합니다.

- `#set page(paper: …, margin: …, columns: …)`
- `#set text(font: …, size: …, lang: …, region: …)`
- `#set par(justify: …, leading: …)`, 여기서 **정렬**은 **양쪽 정렬** 또는 **왼쪽 정렬**입니다
- `#set heading(numbering: …)`, `1.`, `1.1`, `1.a`, `I.`, `A.` 같은 패턴을 씁니다
- `#set math.equation(numbering: …)`, `(1)`, `(1.1)`, `1`을 씁니다

**언어**는 `en` 같은 두세 글자 코드를, **지역**은 `GB` 같은 두 글자 코드를 받습니다.

Typst 프로젝트에는 **빌드 변형** 섹션도 있습니다. 각 변형은 초안 빌드와 최종본 빌드처럼 문서가 `sys.inputs`로 읽는 이름 붙은 값의 묶음입니다. **변형 추가**를 누르고 이름을 붙인 다음, **값 추가**로 값을 하나씩 더하세요. 빌드할 변형은 컴파일 메뉴의 **변형(이 프로젝트)** 항목에서 고릅니다.

### Markdown

값은 Pandoc이 PDF를 빌드할 때 읽는 YAML 프런트매터에 들어갑니다. `type`, `documentclass`, `papersize`, 단 수를 위한 `classoption`, 여백을 위한 `geometry`, `mainfont`, `fontsize`, `lang`, `linestretch`, `numbersections`입니다. **문서 유형**에는 **논문**, **보고서 또는 학위논문**, **책**, **슬라이드**, **포스터**, **편지**, **이력서**가 있으며, 문서가 무엇으로 빌드되는지를 정합니다. [문서 유형](/docs/writing/markdown/#document-types)을 참고하세요. **문서 클래스**에는 `article`, `report`, `book`, `scrartcl`, `scrreprt`, `memoir`가 있습니다. **언어**는 `en-US` 같은 태그를 받습니다.

글꼴을 지정하지 않은 곳에서는 Oleafly가 문서에 있는 한국어, 아랍어, 데바나가리 같은 문자 체계마다 글꼴을 하나씩 고릅니다. **언어**는 중국어 문자에 어떤 글꼴을 쓸지도 정합니다. `ja`는 일본어 글꼴, `zh`는 간체 중국어, `zh-TW`는 번체 중국어를 씁니다. [다른 언어의 텍스트](/docs/writing/markdown/#text-in-other-languages)를 참고하세요.

파일에 프런트매터가 아직 없으면 대화 상자가 그렇게 알려 주고, **적용**을 누르면 맨 위에 블록이 추가됩니다. 닫는 `---` 줄이 없는 프런트매터는 먼저 직접 고쳐야 합니다.

## 읽기 전용 필드

일부 값은 다른 곳에서 정해지므로, 대화 상자는 그 값을 회색으로 표시하고 아래에 이유를 적습니다.

- **… 클래스에서 설정됨**: `acmart`, `IEEEtran`, `llncs`, `beamer` 같은 클래스는 자체 여백을 정하며, 일부는 용지 크기, 글꼴 크기, 단 수, 줄 간격, 언어도 정합니다. 대화 상자 맨 위의 안내에 해당 클래스의 이름이 나옵니다.
- **… 스타일에서 설정됨**: NeurIPS, ICML, ICLR, CVPR, ACL 등의 학회 스타일 패키지는 용지 크기와 여백을 정합니다. 대화 상자 맨 위의 안내에 어떤 스타일이 관리하는지 나옵니다.
- **소스에서 여백을 면마다 따로 설정합니다**: 문서가 하나의 `margin` 값 대신 왼쪽, 오른쪽, 위, 아래 여백을 각각 지정합니다.
- **조건 블록 안에서 설정됨**: 값이 `\if…` 코드 안에 있어서, 여기서 바꾸면 논리가 깨질 수 있습니다.
- **템플릿에서 설정됨**: Typst에서 값이 들어 있는 `#set` 규칙에 `if` 조건이 있거나 템플릿 코드에서 흔히 쓰는 `..` 인수를 넘기므로 대화 상자가 손대지 않습니다.
- **소스의 식으로 설정됨**: 값이 직접 적힌 것이 아니라 계산되므로, 소스를 직접 편집하세요.

Typst 문서가 템플릿을 적용하면, 템플릿 안에서 설정한 값은 표시되지 않으며 여기서 설정한 값이 템플릿보다 우선한다는 안내가 맨 위에 나옵니다. LaTeX에서는 프리앰블의 일부가 다른 파일에 있을 때 비슷한 안내가 나타납니다.

## 관련 페이지

- [패키지](/docs/packages/): 다른 LaTeX 또는 Typst 패키지를 추가합니다
- [컴파일](/docs/compiling/): XeLaTeX나 LuaLaTeX를 고르고 Typst 빌드 변형을 선택합니다
- [문서 분석](/docs/document-insights/): 문서에 무엇이 들어 있는지 확인합니다
