# 라이브러리

홈 화면: 책으로 표시되는 프로젝트, 북마크, 마우스 오버 미리보기, 포크, 그리고 GitHub의 검색 문법을 쓰는 프로젝트 검색.

라이브러리는 Oleafly의 홈 화면입니다. 모든 프로젝트가 책장의 책으로 나타나며 최근에 작업한 순서로 정렬되고, 프로젝트를 관리하는 데 필요한 모든 일이 여기서 이루어집니다.

![프로젝트 표지에 마우스를 올리면 첫 페이지가 미리 보이고, 검색과 필터로 라이브러리를 좁혀 갑니다.](https://cdn.oleafly.com/images/gifs/desktop/library.gif?v=2)

## 책장

각 카드에는 프로젝트 이름과 표지 색상이 표시됩니다. 표지는 프로젝트의 종류도 알려 줍니다. 문서, 이미지, 다이어그램, 그리고 제자리에서 연 폴더를 뜻하는 외부입니다. 카드 아래에는 엔진(LaTeX, Typst, Markdown)과 마지막으로 변경한 시각이 있습니다. 프로젝트를 열면 소스와 미리보기로 돌아갑니다.

오른쪽 위의 버튼으로 표지를 보여 주는 격자 보기와 훑어보기 쉬운 목록 보기를 전환합니다.

라이브러리가 비어 있으면 환영 화면에 **새 프로젝트**와 **폴더 열기**가 나타납니다.

## 프로젝트 만들기

**새 프로젝트**를 클릭하고 시작 방법을 고르세요.

- **템플릿 사용**은 논문, 학위논문, 이력서, 프레젠테이션, 빈 문서에 알맞습니다. [템플릿 갤러리](/docs/templates/)를 둘러보고 템플릿을 고른 다음 프로젝트 이름을 정하세요.
- **프로젝트 가져오기**는 기존 파일을 가져옵니다. 형식별 방법은 [가져오기 가이드](/docs/import-project/)를 참고하세요.
- **연구 프로젝트**는 문서, 자료, 작업이 있는 [연구 작업 공간](/docs/research-workspace/)을 정리합니다.

표지 색상을 고르지 않으면 새 프로젝트는 팔레트에서 무작위로 하나를 받습니다. Oleafly는 프로젝트의 파일을 "Create project"라는 첫 Git 커밋으로도 기록합니다. [Git과 소스 관리](/docs/git-history/#the-first-commit)를 참고하세요.

검색 옴니바로 어디서든 갤러리를 열 수도 있습니다. ⌘⇧F(Ctrl+Shift+F)를 누르고 `/create`를 입력하세요.

## 제자리에서 연 폴더

**폴더 열기**(⌘⇧O / Ctrl+Shift+O)를 쓰면 폴더를 라이브러리로 복사하지 않고 있는 자리에서 작업할 수 있습니다. 그 폴더의 빌드, 설정, 체크포인트, 채팅은 Oleafly 자체 데이터 폴더에 저장되므로 내 폴더에는 아무것도 추가되지 않습니다. 이 폴더는 책장에 외부로 표시되며, 폴더가 없어졌거나 드라이브가 연결되어 있지 않으면 카드가 알려 줍니다.

이렇게 연 폴더에서는 Git, 외부 에이전트, `latexmk`를 통한 시스템 LaTeX 같은 일부 기능을 Oleafly가 제한합니다. 편집기 위쪽 배너의 **이 폴더 신뢰**로 이를 켤 수 있습니다. 내용을 아는 폴더만 신뢰하세요. 그 전까지 폴더는 내장 Tectonic 엔진으로 컴파일됩니다. 신뢰하고 나면 자체 엔진이 없는 폴더는 [기본 컴파일 엔진](/docs/engines/#set-a-default-for-new-projects)을 따릅니다. 그 뒤에도 외부 명령에는 별도의 [권한](/docs/latex-engines/#allow-external-commands)이 필요합니다.

[클라우드 동기화](/docs/cloud-sync/)는 라이브러리에 있는 프로젝트만 백업하므로, 제자리에서 연 폴더는 동기화되지 않습니다.

외부 카드를 오른쪽 클릭하면 파일 관리자에서 폴더를 표시하거나, **라이브러리로 복사**로 내가 소유하는 프로젝트를 만들거나, 파일을 그대로 두는 **Oleafly에서 제거**를 선택할 수 있습니다. Finder, 파일 탐색기, 터미널에서 폴더를 열 수도 있습니다. [시스템 연동](/docs/settings/general/#system-integration)을 참고하세요.

## 마우스 오버 미리보기

책 위에 마우스를 올리면 마지막으로 컴파일한 PDF의 첫 페이지가 표지 위로 미끄러져 나타나서, 한눈에 논문을 구별할 수 있습니다. 미리보기는 실제로 컴파일된 출력에서 만들어 캐시하므로 책장이 빠르게 유지됩니다.

보고 싶지 않다면 **설정 → 모양 → PDF 미리보기**에서 **마우스를 올리면 PDF 미리보기**를 끄세요.

## 북마크

책 위에 마우스를 올리고 북마크 아이콘을 클릭하면 프로젝트를 북마크합니다. 북마크한 프로젝트만 보려면 검색 상자에 `is:bookmarked`를 입력하거나 고급 필터에서 **북마크**를 **북마크됨**으로 설정하세요.

![재투고를 위해 포크한 논문과, 고유한 표지 색상이 붙은 사본.](https://cdn.oleafly.com/images/gifs/desktop/fork-color.gif?v=2)

## 오른쪽 클릭 메뉴

아무 책이나 오른쪽 클릭하세요.

- **프로젝트 열기**
- **프로젝트 정보**: 이름, ID, 엔진, 종류, 주 문서, 날짜, 그리고 검색이 사용하는 기타 메타데이터.
- **내보내기 기록**: 이 프로젝트에서 내보낸 파일.
- **프로젝트 색상**: 표지 견본 열한 가지(파랑, 크림, 살구, 장미, 분홍, 라일락, 하늘, 아쿠아, 청록, 민트, 연두). 색상은 프로젝트 자체에 저장되므로 다른 컴퓨터로 동기화하면 함께 따라갑니다.
- **프로젝트 포크**: 프로젝트와 전체 Git 기록을 새 프로젝트로 복사합니다. 대화상자는 `<name> (copy)`를 제안하며, 원하는 이름을 붙여도 됩니다. 이력서나 논문의 다른 버전을 시험해 볼 때 사본을 쓰세요. 사본에는 체크포인트가 없는 상태로 시작합니다.
- **프로젝트 삭제**: 프로젝트를 휴지통으로 옮기며, 복원할 수 있습니다.

## 프로젝트 이름 바꾸기

프로젝트를 열고 위쪽 도구 모음의 제목을 클릭하세요. 그 자리에서 편집할 수 있게 되며, 새 이름을 입력하고 Enter를 누릅니다. 이름 변경은 프로젝트 자체의 메타데이터에 저장됩니다.

## 프로젝트 검색

홈 화면 위쪽의 검색 상자는 입력하는 대로 책장을 걸러 줍니다. GitHub의 이슈와 풀 리퀘스트 검색과 같은 문법을 씁니다. 일반 단어는 프로젝트 이름, ID, 주 파일, 폴더 경로, 내보낸 파일, 엔진, 종류, 표지 색상과 일치합니다. 한정자는 목록을 좁혀 줍니다.

| 한정자 | 예 | 일치 대상 |
| --- | --- | --- |
| `is:` | `is:bookmarked`, `is:folder`, `is:library`, `is:forked` | 북마크한 프로젝트, 제자리에서 연 폴더, Oleafly에 저장된 프로젝트, 포크 |
| `has:`와 `no:` | `has:preview`, `no:exports` | 컴파일된 PDF 미리보기나 내보낸 파일이 있거나 없는 프로젝트 |
| `engine:` | `engine:typst`, `engine:latex` | LaTeX, Typst, Markdown |
| `kind:` | `kind:image` | 문서, 이미지, 다이어그램 프로젝트 |
| `color:` | `color:mint` | 표지 색상 (견본 이름으로) |
| `created:`, `updated:`, `opened:` | `created:>2026-01-01`, `updated:>@today-1w` | 만든 날짜, 마지막으로 변경한 날짜, 마지막으로 연 날짜 |
| `in:` | `draft in:name` | 단어를 `name`, `id`, `file`, `path`, `export` 중 하나로 한정 |
| `sort:` | `sort:name-asc`, `sort:created` | 책장의 정렬 순서 |

`engine:latex`는 어떤 LaTeX 엔진을 쓰든 모든 LaTeX 프로젝트를 찾습니다. 이전의 `engine:tectonic`도 여전히 동작하며 같은 프로젝트를 찾습니다.

### 조건 결합

규칙은 GitHub의 규칙을 따릅니다.

- 공백은 AND를 뜻합니다. 대문자 `AND`와 `OR`, 그리고 괄호로 조건을 묶을 수 있으며 최대 다섯 단계까지 중첩됩니다. AND가 OR보다 먼저 결합합니다.
- 쉼표는 대안을 나열합니다. `engine:typst,markdown`은 두 엔진 중 하나와 일치합니다. 한정자를 반복하면 둘 다를 뜻하므로 `engine:typst engine:markdown`은 아무것도 찾지 못합니다.
- 앞에 `-`를 붙이면 제외합니다. `-kind:image`, `-is:bookmarked`가 그 예입니다. `NOT`도 되며, `-word`는 그 단어를 포함하는 프로젝트를 뺍니다.
- 따옴표는 공백을 묶어 둡니다. `"lab notes"`, `in:path "My Papers"`가 그 예입니다.

```text
(engine:typst OR engine:markdown) is:bookmarked -kind:image sort:updated-desc
```

### 날짜와 정렬

날짜에는 `>`, `>=`, `<`, `<=`, `2026-01-01..2026-03-31` 같은 범위(열린 끝은 `*`), 그리고 상대 날짜를 쓸 수 있습니다. 상대 날짜는 `@today`, `@today-7d`, `@today-2w`, `@today-1m`, `@today-1y`입니다. `created:>@today-1w`는 지난 7일을 뜻합니다.

`sort:`는 `activity`, `updated`, `created`, `opened`, `name`을 받으며 각각 `-asc` 또는 `-desc`를 붙일 수 있습니다. 방향이 없으면 내림차순으로 정렬합니다. 기본값은 최근 활동입니다.

### 제안과 경고

검색 상자가 비어 있을 때 클릭하면 드롭다운에 한정자가 나열됩니다. 입력하는 동안에는 한정자, 값, AND, OR, 제외를 제안합니다. 화살표 키로 이동하고 Enter를 누르면 제안을 받아들입니다. Tab이나 Escape는 아무것도 선택하지 않고 닫습니다.

한정자와 값은 입력하면서 색으로 표시됩니다. 실수가 있으면 호박색 음영과 무엇이 잘못됐는지 알려 주는 짧은 메모가 나타납니다. 닫히지 않은 괄호나 한정자가 받지 않는 값이 그 예입니다. 알 수 없는 한정자는 일반 텍스트로 검색되고, 잘못된 값은 무시됩니다.

### 고급 필터

검색 상자 옆의 슬라이더 버튼은 **고급 필터**를 엽니다. 엔진, 프로젝트 종류, 북마크, PDF 미리보기, 만든 날짜, 수정한 날짜, 정렬 기준 메뉴가 있습니다. 제자리에서 폴더를 한 번 열고 나면 위치 메뉴가 더해집니다. 모든 메뉴는 검색 텍스트를 편집하므로 검색 상자와 패널은 항상 일치합니다. 패널이 질의를 하나의 선택지로 보여 줄 수 없으면 메뉴에 **사용자 지정**이라고 표시됩니다. **초기화**는 한정자를 지우고 일반 단어는 남겨 둡니다.

## 모든 것 검색

검색 옴니바(⌘⇧F / Ctrl+Shift+F, 또는 독의 **문서 검색**)는 프로젝트 메타데이터와 모든 프로젝트의 모든 문서 전체 텍스트를 검색합니다. 일치하는 프로젝트, 파일, 줄로 바로 이동합니다. `/projects`, `/docs`, `/create` 같은 범위 지정 명령은 `/`를 입력하세요.

옴니바에는 `name:resume`이나 `bookmark:yes` 같은 더 단순한 자체 필터가 있습니다. 위의 GitHub 방식 문법은 홈 화면의 검색 상자에 속합니다.

## 홈 독

홈 화면의 작은 독에는 프로젝트가 아닌 모든 것이 모여 있습니다.

- **새 프로젝트**: 템플릿으로 시작하거나, 파일을 가져오거나, 연구 작업 공간을 만듭니다.
- **문서 검색**: 검색 옴니바(⌘⇧F / Ctrl+Shift+F).
- **다이어그램 작성기**: 프로젝트를 먼저 열지 않고 쓰는 [다이어그램 작성기](/docs/figures-diagrams/). 다이어그램을 어디에 쓸지 묻습니다. **TikZ 다이어그램**, **Typst 다이어그램**, **Mermaid 다이어그램**입니다.
- **노트**: [노트](/docs/notes/)를 엽니다. **설정 → 실험 기능**에서 **노트**를 켜 둔 동안 표시됩니다.
- **Oleafly 도구**: 문서 유틸리티를 검색할 수 있는 갤러리(아래 참고).
- **모양**: 밝게, 어둡게, 시스템 중에서 전환합니다.
- **설정**: 톱니바퀴 또는 ⌘,(Ctrl+,)로 전체 [설정](/docs/settings/) 창을 엽니다.

## Oleafly 도구

**설정 → 실험 기능**에서 **LaTeX 도구**를 켜면 **Oleafly 도구** 갤러리가 나타납니다. LaTeX, Typst, Markdown, Word, HTML, 이미지 사이의 변환기와 함께 참고문헌 작성기, 검증기, 연구 조회, 통계 계산기, 글쓰기 도우미가 있습니다. 각각은 [Oleafly 도구 가이드](/docs/tools/)에서 다룹니다.

## 책장이 디스크에 있는 위치

모든 책은 `~/.oleafly/projects/` 아래의 일반 폴더이며, `flying-pink-pikachu`처럼 사람이 읽을 수 있는 무작위 이름이 붙습니다. 라이브러리에 독점적인 것은 없습니다. [데이터가 저장되는 위치](/docs/where-your-data-lives/)를 참고하세요.

## 휴지통

삭제한 프로젝트는 복원하거나 영구 삭제할 때까지 휴지통에 남습니다. 두 동작 모두 **설정 → 데이터 저장**에 있습니다. [저장소와 휴지통](/docs/settings/storage/#recycle-bin)을 참고하세요.
