기존 작업을 Oleafly로 가져오기

새 프로젝트 → 프로젝트 가져오기를 선택하거나 라이브러리의 가져오기를 사용하세요. Oleafly는 새 로컬 프로젝트를 만들고 원본 파일이나 저장소는 그대로 둡니다. 가져온 항목에 자체 Git 저장소가 없다면, 가져온 파일이 프로젝트의 첫 Git 커밋 Create project가 됩니다.

새 프로젝트 대화상자에서 프로젝트 가져오기를 선택하면 기존 작업으로 시작합니다. 전체 스크린샷 열기

소스에 맞는 경로 고르기

가지고 있는 것	가져오기 경로	만들 수 있는 프로젝트
완성된 프로젝트 폴더	기존 프로젝트 (.zip)	아카이브에 담긴 소스, 그림, 참고문헌, 로컬 스타일 파일
Word 문서	Word 문서 (.docx)	LaTeX, Markdown, Typst
Markdown 문서	Markdown 문서 (.md, .markdown)	LaTeX 또는 Typst
HTML 문서	HTML 페이지 (.html, .htm)	LaTeX, Markdown, Typst
Typst 문서	Typst 문서 (.typ)	LaTeX 또는 Markdown
arXiv 논문	ID나 URL을 입력하는 arXiv 논문	논문의 LaTeX 소스 번들
GitHub 저장소	GitHub	저장소에 연결된 로컬 프로젝트
편집 가능한 소스가 없는 PDF	Oleafly 도구 → PDF 변환기	선택한 도구에 따라 재구성된 LaTeX, Markdown, Typst
이미 Oleafly에 있는 LaTeX 프로젝트	명령 팔레트의 Typst 프로젝트로 변환	새 Typst 프로젝트. LaTeX 프로젝트는 그대로 둡니다

Oleafly가 같은 작성 형식을 제공할 때만 그 형식을 고르세요. Markdown이나 Typst 파일을 원래 형식 그대로 유지하려면 그 형식의 빈 프로젝트를 시작하고 파일 트리로 소스 파일을 추가하세요.

완성된 프로젝트 아카이브 가져오기

이미 동작하는 소스 트리가 있다면 ZIP을 쓰세요.

1. 메인 문서, 그림, 참고문헌, 로컬 클래스와 스타일 파일을 한 폴더에 모읍니다. 소스에서 쓰는 상대 경로를 유지하세요.
2. 폴더를 .zip 파일로 압축합니다.
3. 가져오기 → 기존 프로젝트를 선택하고 ZIP을 고릅니다.
4. 가져온 파일 트리에서 별표가 붙은 주 문서를 확인합니다.
5. 컴파일합니다. 프로젝트에 다른 LaTeX 툴체인이 필요하면 컴파일러 메뉴에서 고르세요.

예를 들어 main.tex, references.bib, sections/method.tex, figures/plot.pdf를 함께 두세요. 소스 ZIP은 이런 관계를 보존합니다. PDF에는 같은 편집 가능한 프로젝트 구조가 들어 있지 않습니다.

아카이브에 메인 문서 후보가 둘 이상이면 컴파일하기 전에 파일 메뉴에서 올바른 것을 확인하세요.

가져온 프로젝트가 쓰는 LaTeX 컴파일러

가져오거나 변환한 LaTeX 프로젝트는 설정 → 엔진 → LaTeX의 기본 컴파일 엔진으로 시작하며, 바꾸지 않았다면 Tectonic입니다. 그 기본값이 latexmk이고 프로젝트가 pdfLaTeX, XeLaTeX, LuaLaTeX 중 하나를 지정하면 그 컴파일러를 유지합니다. 가져오는 중에 Tectonic이 처리하지 못하는 기능이 발견되면 엔진 대화상자가 열려 다른 엔진을 고를 수 있습니다. 새 프로젝트의 기본값 설정과 Tectonic으로 부족할 때를 참고하세요.

Word, Markdown, HTML, Typst 변환

1. 가져오기에서 해당하는 문서 유형을 고릅니다.
2. 파일을 선택합니다.
3. Oleafly가 변환 대상을 여러 개 제공하면, 다음에 편집할 형식을 고릅니다. LaTeX에 권장 경로 표시가 붙습니다.
4. 안내가 나오면 Pandoc 설정을 마칩니다. Oleafly는 호환되는 설치를 사용하거나 관리형 버전을 내려받을 수 있습니다.
5. 새 프로젝트를 열고, 컴파일하고, 원본과 비교합니다.

변환은 Pandoc을 통해 로컬에서 실행됩니다. Word나 HTML을 가져오면 포함된 미디어도 프로젝트로 추출하므로, 변환된 소스가 이를 참조할 수 있습니다. LaTeX 프로젝트로 가져온 Markdown 문서는 인용을 유지합니다. [@key]는 \citep 또는 \citet가 되고 참고문헌 파일도 함께 들어오므로, 참고문헌 패널에 처음부터 자료가 채워집니다.

앞으로의 작업에 맞게 대상을 고르세요.

• LaTeX은 학술지 템플릿, 세밀한 조판, 태그된 PDF 작업 흐름에 알맞습니다.
• Markdown은 더 가벼운 소스 형식과 폭넓은 문서 변환에 알맞습니다.
• Typst는 빠른 컴파일과 Typst 전용 템플릿에 알맞습니다.

변환은 원본 형식이 드러내는 한 문서 구조를 보존합니다. Word 전용 페이지 레이아웃, 사용자 지정 HTML 스타일, 손으로 다듬은 표, 인용, 복잡한 수식은 여전히 정리 작업이 필요할 수 있습니다. 원본을 지우기 전에 제목, 목록, 표, 수식, 링크, 인용, 이미지 위치를 비교하세요.

arXiv 소스 번들 가져오기

arXiv 논문을 선택한 다음 2401.01234 같은 식별자나 arxiv.org/abs/... URL을 붙여 넣으세요. Oleafly가 제출된 소스 번들을 내려받아 LaTeX 프로젝트로 엽니다.

저자의 편집 가능한 소스가 필요할 때 이 경로를 쓰세요. 가져오기 대화상자에서 시작하지 않고 소스 아카이브를 살펴보거나 저장하려면 arXiv를 LaTeX로를, 논문을 Typst로 변환하려면 arXiv를 Typst로를 쓰세요. arXiv 식별자에는 네트워크 연결이 필요하지만, 이미 디스크에 있는 소스 아카이브는 필요하지 않습니다.

소스나 그림을 재사용하기 전에 항상 라이선스와 저자의 이용 조건을 확인하세요.

GitHub에서 가져오기

가져오기 대화상자에서 GitHub를 선택하세요. 필요하면 설정 → 연동 → GitHub에서 계정을 연결한 다음, 접근할 수 있는 저장소를 고르세요.

Oleafly가 라이브러리에 로컬 사본을 만듭니다. 편집하기 전에 주 문서를 확인하고 컴파일해 보세요. 가져온 뒤에 변경 사항을 풀하고, 커밋하고, 게시하는 방법은 GitHub 동기화에서 설명합니다.

LaTeX 프로젝트를 Typst로 변환

Oleafly는 이미 가진 LaTeX 프로젝트의 Typst 사본을 만들 수 있습니다. LaTeX 프로젝트는 바뀌지 않습니다.

1. LaTeX 프로젝트를 엽니다.
2. ⌘K(Ctrl+K) 명령 팔레트를 열고 Typst 프로젝트로 변환을 실행합니다.
3. 새 프로젝트 이름을 확인합니다. 기본값은 프로젝트 이름 뒤에 (Typst)를 붙인 것입니다.
4. 변환을 선택합니다. Oleafly가 Pandoc으로 프로젝트를 변환하고, Typst 프로젝트를 만들고, 확인용으로 한 번 컴파일합니다.
5. 보고서를 읽은 다음 Typst 프로젝트 열기를 선택합니다.

보고서는 새 프로젝트가 컴파일되는지 알려 주고, 변환된 항목의 수를 집계하고, 직접 고쳐야 할 항목을 각 컴파일 오류로 가는 링크와 함께 나열합니다. 변환과 보고서는 Typst 프로젝트에서 자세히 설명합니다.

PDF 재구성

설정 → 실험 기능에서 LaTeX 도구를 켠 다음, 필요한 출력에 맞는 도구를 고르세요.

• LaTeX 프로젝트나 소스 아카이브는 PDF를 LaTeX로
• 편집 가능한 Markdown은 PDF를 Markdown으로
• 편집 가능한 Typst는 PDF를 Typst로

로컬 PDF 파이프라인은 텍스트 레이어를 읽고, 읽는 순서를 복원하고, 그림을 추출합니다. PDF를 LaTeX로에서는 PDF가 페이지 이미지로 이루어져 있다면 스캔 문서 모드로 전환하세요. 이 경로는 도구에 쓸 모델을 사용하고, 다른 모델을 고르지 않으면 로컬 Ollama 모델을 쓰며, 최대 50쪽 문서를 지원합니다.

결과를 PDF와 페이지별로 비교하세요. 단, 열, 수식, 표, 각주, 읽는 순서는 재구성에서 생기는 문제이므로 어떤 PDF 변환도 원본 소스로 취급해서는 안 됩니다.

원고를 가져오지 않고 참고문헌 추가

참고문헌과 인용에서 BibTeX, RIS, EndNote XML, Zotero RDF를 가져올 수 있습니다. 프로젝트 밖에 두어야 하는 논문이나 데이터 폴더는 읽기 전용 연구 컨텍스트로 연결하세요.