파일과 데이터
프로젝트와 함께 이동하는 것이 무엇인지 알아 두고, 소스와 이력과 앱 데이터를 백업하는 방법을 확인하세요.
원고는 평범한 소스 파일이 든 폴더입니다. 그 파일을 다른 편집기로 열 수도 있고, 백업할 수도 있고, Oleafly 밖으로 가져갈 수도 있습니다.
프로젝트 파일
섹션 제목: “프로젝트 파일”라이브러리 프로젝트는 보통 ~/.oleafly/projects/ 아래에 있습니다. 프로젝트에는 LaTeX, Typst, Markdown 주 문서, 참고문헌, 그림, 연구 자료가 들어갈 수 있습니다.
project.json은 프로젝트의 식별 정보와 설정을 기록합니다. 주 문서, 엔진, 고정된 Typst 버전도 여기에 들어갑니다. .git 디렉터리에는 Git 이력이 들어 있습니다. Oleafly가 만들거나 가져온 프로젝트는 보통 파일 전체를 하나의 커밋으로 묶은 상태에서 시작하며, 그 커밋의 이름은 “Create project”입니다(Git과 소스 관리 참고). .oleafly/build/ 디렉터리에는 생성된 빌드 출력이 있으며, 컴파일하면 다시 만들 수 있습니다.
Typst 프로젝트는 가져오는 패키지의 사본을 typst-packages 폴더에 보관할 수 있어서, 오프라인에서도 다른 컴퓨터에서도 컴파일됩니다. Typst는 프로젝트의 fonts 폴더에 있는 글꼴도 사용합니다. 두 폴더는 프로젝트와 함께 이동합니다.
제자리에서 연 폴더는 있던 자리에 그대로 있습니다. Oleafly는 그 폴더의 빌드, 설정, 체크포인트, 채팅을 자체 데이터 폴더에 보관하므로 내 폴더에는 아무것도 추가되지 않습니다.
프로젝트 밖에 저장되는 데이터
섹션 제목: “프로젝트 밖에 저장되는 데이터”앱 환경설정, 암호화된 제공자 자격 증명, 채팅과 사용량 기록, 추가 Typst 버전 같은 내려받은 도구, 저장된 체크포인트는 로컬 앱 저장소에 속합니다. 어시스턴트나 에이전트의 매 차례가 시작되기 전에 Oleafly가 보관하는 프로젝트 사본도 마찬가지입니다. 이 사본으로 그 차례가 바꾼 파일을 되돌릴 수 있습니다. @ 검색이 읽는 Zotero 라이브러리 사본도 프로젝트가 아니라 거기에 있습니다. 원고 폴더를 복사해도 이 앱 데이터가 모두 복사되지는 않습니다.
연결된 폴더는 원래 위치에 그대로 있습니다. 연결했다는 이유만으로 소스 압축 파일에 그 내용이 들어가지는 않습니다.
노트가 있는 곳
섹션 제목: “노트가 있는 곳”노트는 내 컴퓨터의 Markdown 파일입니다. 개인 노트는 각각 프로젝트 폴더 안에, 라이브러리 프로젝트 옆에 폴더로 저장됩니다. 프로젝트 노트는 프로젝트의 notes 폴더에 있는 .md 파일이므로 프로젝트와 함께 이동합니다. Windows, macOS, Linux의 폴더와 노트 폴더에 들어 있는 것은 노트가 저장되는 위치를 참고하세요.
TinyTeX가 저장되는 곳
섹션 제목: “TinyTeX가 저장되는 곳”설정 → 엔진 → LaTeX에서 TinyTeX를 설치하면 Oleafly는 이를 ~/.oleafly/tinytex에 둡니다. Windows에서 사용자 폴더 이름에 한국어나 중국어 이름처럼 악센트 문자나 비라틴 문자가 있으면 예외입니다. TeX Live가 그런 폴더에서는 실행되지 못하기 때문입니다. 이때 TinyTeX는 보통 C:\ProgramData인 ProgramData 안에서 Oleafly- 뒤에 짧은 코드가 붙은 이름의 폴더에 들어갑니다. 관리자 권한은 필요하지 않습니다. Oleafly가 그 폴더도 만들 수 없으면 그렇다고 알려 줍니다. 그래도 Tectonic으로 계속 컴파일하거나, C:\texlive에 TeX Live를 직접 설치할 수 있습니다.
TeX 배포판 관리 아래의 TinyTeX 행에는 그 폴더가 표시되며, 흐리게 가려진 경로 위에 마우스를 올리면 읽을 수 있습니다. TinyTeX를 지울 때는 폴더를 직접 삭제하지 말고 그 행에서 제거하세요.
작업 백업하기
섹션 제목: “작업 백업하기”| 보관하려는 것 | 보관 방법 |
|---|---|
| 원고 소스와 프로젝트 자산 | 프로젝트 폴더를 복사하거나 소스 ZIP을 내보냅니다 |
| Git 커밋 | 저장소를 백업하거나 설정해 둔 원격 저장소로 푸시합니다 |
| 저장된 체크포인트 | 버전 관리에서 암호화된 이력 아카이브를 내보냅니다 |
| 앱 환경설정과 로컬 기록 | 평소 쓰는 컴퓨터 백업에 Oleafly 데이터 디렉터리를 포함합니다 |
| 연결된 데이터와 참고문헌 | 원래 폴더를 백업합니다 |
| 이 컴퓨터 밖에 두는 라이브러리 프로젝트와 설정 | 클라우드 동기화를 켜서 Dropbox에 사본을 보관합니다 |
소스 ZIP에는 빌드 캐시와 Git이 들어가지 않습니다. 원격 저장소에는 GitHub 동기화를, 체크포인트 이력에는 체크포인트 아카이브를 쓰세요.
다른 컴퓨터로 옮기기
섹션 제목: “다른 컴퓨터로 옮기기”Oleafly를 설치하고 원고 프로젝트를 복사하거나 클론하세요. 그 컴퓨터에서 연결된 폴더와 모델 제공자를 다시 연결하세요. 프로젝트에는 컴파일러 선택과 메타데이터가 함께 들어 있으며, 추가 도구나 패키지는 설치해야 할 수 있습니다. 이 컴퓨터에 없는 버전을 고정한 Typst 프로젝트는 컴파일하기 전에 그 버전을 내려받을지 묻습니다.
화면에 표시되는 경로
섹션 제목: “화면에 표시되는 경로”홈 폴더 안의 경로는 설정, 버전 이력, 엔진과 에이전트 상세 정보, 채팅에서 ~/…로 표시됩니다. 설정에서는 파일과 폴더 경로가 마우스를 올리거나 Tab 키로 이동하기 전까지 흐리게 처리되어, 스크린샷에 파일 위치가 드러나지 않습니다.
네트워크 접근
섹션 제목: “네트워크 접근”글쓰기와 로컬 교정은 이 컴퓨터에서 이루어집니다. 호스팅 AI는 선택한 제공자에게 전달된 맥락을 받습니다. 이미지와 스캔한 PDF를 읽는 도구는 호스팅 모델이나 Mathpix를 고르지 않는 한 로컬 Ollama 모델을 사용하며, 고르면 파일이 그 서비스로 전송됩니다. Zotero 인용은 이 컴퓨터의 Zotero 앱과 통신하며, 계정을 연결했다면 zotero.org와 통신합니다. 인용 검색, Zotero 가져오기, alphaXiv 도구, GitHub 동기화, Typst 패키지와 버전 다운로드, 그 밖의 다운로드, 업데이트 확인은 각각의 서비스에 접속합니다. 실시간 협업은 공유된 프로젝트마다 그 프로젝트가 공유된 협업 서버로 보냅니다. 클라우드 동기화는 라이브러리 프로젝트와 설정을 내 Dropbox로 보냅니다. 설정 → 도움말 및 정보를 열면 공개된 수치를 가져옵니다. 프로젝트의 GitHub 별 수와 포크 수, Discord 커뮤니티에 접속 중인 멤버 수입니다. 이 요청에는 계정, 프로젝트, 사용량 정보가 담기지 않으며, 오프라인 모드에서는 Discord 요청을 건너뜁니다. Tectonic과 Typst는 둘 다 오프라인 모드를 통한 캐시된 컴파일을 지원합니다.