# 템플릿

템플릿 갤러리: 이력서부터 IEEE 논문, 학위논문, Beamer 덱, 포스터까지 LaTeX, Typst, Markdown으로 바로 편집할 수 있는 28가지 시작점과 내려받을 수 있는 템플릿 팩.

모든 Oleafly 프로젝트는 템플릿에서 시작합니다. 갤러리는 템플릿마다 실제 첫 페이지 미리보기를 보여 주므로, 이름으로 짐작하지 않고 출력물을 보고 고를 수 있습니다. 템플릿은 템플릿에 따라 LaTeX, Typst, Markdown 중 하나의 평범하고 편집 가능한 소스로 제공됩니다. 만든 결과물은 내 것입니다.

![템플릿 갤러리에서 만든 연구비 신청서와 채워진 표지 표.](https://cdn.oleafly.com/images/gifs/desktop/new-grant.gif?v=2)

## 갤러리

라이브러리에서 **새 프로젝트 → 템플릿 사용**을 선택하세요. 갤러리는 두 단계로 되어 있습니다.

1. **템플릿 선택.** 왼쪽 레일에서 분류별로 둘러보거나, **템플릿 검색** 상자에 입력하거나, 필터로 그리드를 좁히세요. **ATS 호환**은 단순한 읽기 순서를 의도한 이력서 템플릿을 보여 주고, 엔진 필터는 LaTeX, Typst, Markdown 중에서 고르며, **오프라인**은 에셋이 이미 내 컴퓨터에 있는 템플릿을 보여 줍니다. 모든 카드에 컴파일된 첫 페이지의 미리보기가 표시됩니다.
2. **프로젝트 이름 지정.** 템플릿의 전체 정보가 나옵니다. 미리보기, 분류, 이력서의 경우 **ATS 호환** 또는 **디자인 중심** 배지, 컴파일 엔진, 라이선스와 작성자입니다. 프로젝트 이름(템플릿마다 알맞은 예시가 제안됩니다)과 표지 색상을 고른 다음 **프로젝트 만들기**를 누르세요. 표지 색상을 고르지 않으면 Oleafly가 팔레트에서 무작위로 고릅니다.

![분류 필터, 엔진 선택, 문서 미리보기가 있는 현재 Oleafly 앱의 템플릿 갤러리.](https://cdn.oleafly.com/images/screenshots/desktop/docs/template-gallery-dark-window-v2.png)

![템플릿으로 만든 Beamer 발표를 제목 슬라이드까지 컴파일한 모습.](https://cdn.oleafly.com/images/gifs/desktop/new-talk.gif?v=2)

## 카탈로그

| 템플릿 | 분류 | 제공되는 내용 |
|---|---|---|
| **Blank document** | 빈 문서 | 처음부터 시작하는 최소한의 LaTeX 문서. |
| **Blank Typst document** | 빈 문서 | 내장 Typst 엔진으로 컴파일하는 최소한의 Typst 문서. |
| **Blank Markdown document** | 빈 문서 | YAML 메타데이터가 있는 Pandoc Markdown 문서. |
| **Diagram / Figure** | 다이어그램 | 독립형 TikZ 그림 프로젝트. 이미지로 미리보며 [다이어그램 작성기](/docs/figures-diagrams/)와 함께 사용합니다. |
| **Typst Figure** | 다이어그램 | 이미지로 미리보는 독립형 Typst 그림. 도형과 텍스트로 그리고 컴파일해서 어디서든 재사용하세요. |
| **ATS Resume** | 이력서 | 단일 열, ATS 호환 이력서. 섹션 구분선이 깔끔합니다. |
| **Software Engineer Resume** | 이력서 | 다듬어진 한 페이지 SWE 이력서. 시니어 예시로 미리 채워져 있어 새로 쓰지 않고 고치기만 하면 됩니다. |
| **Sidebar Resume** | 이력서 | 디자인 중심의 2열 레이아웃. 색이 있는 사이드바에 사진 자리와 기술을 왼쪽에, 경력을 오른쪽에 둡니다. |
| **Modern Resume** | 이력서 | Lato 서체로 조판한 단일 열, ATS 호환 이력서. |
| **Typst Resume** | 이력서 | 깔끔한 단일 열 Typst 이력서. 편집이 빠르고 ATS 호환이며 내장 Typst 엔진으로 컴파일합니다. |
| **IEEE Research Paper** | 저널 | 그림, 표, 수식, 참고문헌이 있는 2단 IEEEtran 학회 논문. |
| **Academic Article** | 저널 | 초록과 `references.bib` 참고문헌이 있는 미니멀한 단일 열 연구 논문. |
| **ACM Article** | 저널 | 공식 acmart 클래스: 저자, 초록, CCS 개념, 참고문헌. |
| **Elsevier Article** | 저널 | elsarticle 클래스: 소속, 초록, 키워드, `references.bib` 참고문헌. |
| **Typst Conference-style Paper** | 저널 | 저자, 초록, 그림, 표, 수식, 참고문헌이 있는 Typst 2단 학회 스타일 논문. |
| **Homework Assignment** | 과제 | 제목 블록, 러닝 헤더, 풀이 공간이 있는 번호 매긴 문제. |
| **Bibliography (natbib)** | 참고문헌 | 샘플 `.bib`와 인용 예시가 있는 natbib + BibTeX 시작 템플릿. |
| **Thesis / Report** | 학위논문 및 보고서 | 표지, 목차, 장, `references.bib` 참고문헌. |
| **Typst Report** | 학위논문 및 보고서 | 번호 매긴 섹션, 초록, 상호 참조가 있는 구조화된 Typst 보고서. |
| **Typst Technical Report** | 학위논문 및 보고서 | 표지, 요약, 목차, 그림, 표, 참고문헌이 있는 전체 Typst 기술 보고서. |
| **Typst Thesis** | 학위논문 및 보고서 | 표지, 초록, 목차, 장, 그림, 참고문헌, 부록이 있는 Typst 학위논문. |
| **Book** | 도서 | 부, 장, 앞부분, 목차. |
| **Beamer Presentation** | 프레젠테이션 | beamer 덱: 제목, 개요, 내용 프레임, 마무리 슬라이드. PowerPoint로도 내보냅니다. |
| **Newsletter** | 뉴스레터 | 2단 레이아웃의 제호, 주요 기사, 짧은 칼럼. |
| **Research Poster** | 포스터 | tikzposter 과학 포스터: 제목 배너, 저자 블록, 열 블록. |
| **Monthly Calendar** | 달력 | 칸이 넉넉한 한 페이지 월간 격자. |
| **Formal Letter** | 편지 | 발신인과 수신인 블록, 날짜, 호칭, 본문, 서명. |
| **Typst Formal Letter** | 편지 | 발신인과 수신인 블록, 날짜, 제목 줄, 본문, 서명이 있는 Typst 공식 편지. |

내장 템플릿은 모두 28개이며 LaTeX가 19개, Typst가 8개, Markdown이 1개입니다. LaTeX 템플릿은 기본적으로 내장 Tectonic 엔진으로 컴파일하고, `latexmk`를 [기본 컴파일 엔진](/docs/engines/#set-a-default-for-new-projects)으로 지정했다면 그것으로 컴파일합니다. Typst 템플릿은 내장 Typst 엔진을 쓰고, Markdown 템플릿은 관리형 Pandoc 경로를 거칩니다. Typst 템플릿은 패키지를 쓰지 않으므로 0.13부터 0.15까지 어떤 Typst로든 오프라인에서 컴파일됩니다. 각 템플릿에는 라이선스 텍스트가 포함됩니다(모두 허용적 라이선스).

![템플릿으로 만든 A0 연구 포스터를 컴파일한 모습.](https://cdn.oleafly.com/images/gifs/desktop/new-poster.gif?v=2)

## 내려받을 수 있는 템플릿 팩

내장 세트는 일부러 간결하게 구성했습니다. 필요할 때 받는 팩은 학술 글쓰기, Beamer 테마, 업무 문서, 학회 프리프린트 스타일, 수업 과제, 창작 문서, CV와 이력서 스타일, 연구실 및 기술 보고서, 슬라이드와 포스터, 저널 또는 학회 클래스에 걸쳐 템플릿을 더합니다. 갤러리에서 **템플릿 더 받기**를 선택하거나 **설정, 다운로드**를 열어 팩을 설치하세요. 그 팩의 템플릿은 내장 템플릿처럼 갤러리에 나타나며, 나중에 팩을 제거해 공간을 확보할 수 있습니다. 팩은 온라인 상태에서 다운로드를 열 때 Oleafly가 새로 고치는 공개 카탈로그에서 오므로, 앱 릴리스 사이에도 목록이 늘어날 수 있습니다. 팩을 설치하려면 네트워크 연결이 필요합니다.

## AI 생성 템플릿

**템플릿 생성**을 선택하면 AI 모델에게 나만의 레이아웃을 설명할 수 있습니다. 모델을 고르고, 생성된 소스와 미리보기를 확인한 다음, 템플릿을 저장하거나 그것으로 프로젝트를 만드세요. **이 템플릿 사용**도 갤러리에 템플릿을 저장합니다.

[재사용 가능한 보고서 레이아웃을 단계별로 생성하기 →](/docs/templates/ai-templates/)

## 이력서 템플릿과 ATS

이력서 배지는 레이아웃을 고르는 데 도움이 됩니다.

- **ATS 호환**(녹색 배지): ATS Resume, Software Engineer Resume, Modern Resume. 단일 열, 선형 읽기 순서, 레이아웃용 표 없음, 실제 텍스트입니다. 추출 미리보기로 완성된 PDF에서 파서가 무엇을 읽을 수 있는지 확인하세요.
- **디자인 중심**(호박색 배지): Sidebar Resume. 눈에 띄는 디자인이며, 이 배지는 다단 레이아웃이 엄격한 파서를 혼란스럽게 할 수 있다는 미리 알림입니다.

무엇을 고르든 제출하기 전에 [프리플라이트](/docs/preflight/)를 실행하세요. 실제 PDF에 이력서 파서를 시뮬레이션해서 무엇이 추출되었는지 보여 줍니다.

## 필요할 때 받는 글꼴(설정 배지)

추가 오픈 소스 서체를 쓰는 템플릿(Lato 기반의 Modern Resume 등)에는 갤러리에 작은 **설정** 배지가 표시됩니다. 이런 템플릿을 만들면 진행 상황이 실시간으로 표시되는 한 번만의 글꼴 다운로드가 시작되고, 글꼴은 프로젝트의 `fonts/` 폴더로 복사되므로 소스 파일과 함께 이동합니다.

글꼴 팩은 설정, 다운로드에서 언제든 미리 내려받거나 제거할 수 있습니다. 자세한 내용은 [설정](/docs/settings/#downloads)에 있습니다.

![연구실 논문을 템플릿으로 저장한 뒤 그 템플릿으로 새 논문을 시작하는 모습.](https://cdn.oleafly.com/images/gifs/desktop/save-template.gif?v=2)

## 만든 후에

새 프로젝트는 템플릿의 구조를 갖춘 채 [파일 트리](/docs/files/)에 바로 열립니다. 메인 문서, `.bib`, 에셋이 있습니다. 한 번 컴파일(⌘↵ / Ctrl+Enter)한 다음 샘플 내용을 내 내용으로 바꿔 나가세요. 템플릿은 편집 가능한 LaTeX, Typst, Markdown 소스입니다. 내용을 바꾸고 구조도 작업에 맞게 고치세요.

시작 파일은 프로젝트의 첫 Git 커밋인 **프로젝트 만들기**로도 저장되므로, 소스 관리에서 첫 편집부터 내가 바꾼 내용을 볼 수 있습니다. 이 커밋을 건너뛰는 경우는 [새 프로젝트 시작하기](/docs/new-project/#the-first-git-commit)에서 설명합니다.
