# 외부 편집과 버전

다른 편집기, 스크립트, Git의 변경 사항이 공유 프로젝트에 반영되는 방식, Oleafly가 전송 전에 묻는 경우, 복원할 때 공유 기록, 체크포인트, Git이 어떻게 맞물리는지 설명합니다.

공유 프로젝트는 내 컴퓨터에 있는 일반 폴더입니다. 다른 프로그램이 그 파일을 바꿀 수 있으며, Oleafly는 그런 변경 사항을 공유 프로젝트로 가져옵니다.

## 다른 편집기와 스크립트

다른 편집기, 포매터, 스크립트, 명령줄 도구가 프로젝트 폴더의 파일을 저장하면 Oleafly가 이를 알아차리고 모두에게 변경 사항을 보냅니다. 다른 사람이 그 파일에 입력하는 중이어도 동작합니다.

Oleafly는 저장된 파일을 자신이 마지막으로 그 파일에 쓴 버전과 비교합니다. 다른 프로그램이 바꾼 부분만 적용됩니다. 그사이 공동 저자들이 입력한 텍스트는 그대로 남습니다. 다른 사람이 입력하는 동안 매초 저장하는 편집기도 문제없습니다.

## 큰 변경은 먼저 묻습니다

어떤 작업은 한 번에 많은 파일을 바꿉니다. Git 브랜치 전환, 풀, 프로젝트 위에 압축 파일 풀기, 이전 버전 복원 등이 그렇습니다. Oleafly는 이런 변경을 보류하고 모두에게 전달하기 전에 묻습니다. 한 번에 10개 이상의 파일이 바뀌거나, 3개 이상의 파일이 바뀌고 그 파일이 프로젝트 파일의 30퍼센트 이상일 때 묻습니다.

편집기 위의 배너가 Oleafly 밖에서 몇 개의 파일이 바뀌었는지 알려 주고, 변경 사항을 모두에게 보낼지 로컬에만 둘지 묻습니다.

- **보내기**는 변경 사항을 보냅니다. 다른 사람들이 입력하는 내용과 병합됩니다.
- **로컬에 유지**는 그 파일들을 이 컴퓨터에서만 지금 상태로 둡니다. 다른 사람들은 공유 버전을 그대로 유지합니다. 나중에 그 파일 중 하나를 편집하면 새로 편집한 부분만 전송됩니다.

### 프로젝트 폴더가 사라질 때

연결을 뺀 드라이브에 있는 경우처럼 프로젝트 폴더를 쓸 수 없게 되면, Oleafly는 모든 파일이 삭제된 것으로 처리하지 않고 그 프로젝트의 동기화를 일시 중지합니다. 이를 알려 주며, 폴더가 돌아오면 동기화가 다시 시작됩니다.

## 공유 프로젝트의 Git

Git 이력은 공유되지 않습니다. 각자 프로젝트 안에 자기 저장소를 두고 자기 원격 저장소로 커밋하고 푸시할 수 있습니다. [Git과 소스 관리](/docs/git-history/)를 참고하세요.

Git은 디스크의 파일을 바꾸고, Oleafly가 공유하는 것은 바로 그 파일입니다. 다른 브랜치를 체크아웃하거나 풀하면 그 파일이 모두에게 전송되며, 많은 파일이 바뀔 때는 위의 질문을 먼저 거칩니다. 다른 브랜치를 보기만 하려면 **로컬에 유지**를 선택하거나 공유 프로젝트 밖의 별도 클론을 쓰세요.

### 변경 비교 보기는 읽기 전용입니다

공유 프로젝트에서는 소스 관리의 변경 비교가 읽기 전용입니다. 변경 비교에 "공유 프로젝트에서는 이 변경 비교가 읽기 전용입니다. 편집기에서 파일을 편집하세요."라고 표시됩니다. 변경은 편집기에서 하세요. 그러면 다른 사람들의 입력과 병합됩니다.

## 버전 이력

공유 프로젝트에는 참여한 모든 사람이 보는 [공유 기록](/docs/collaboration/history/)이 있습니다. 모든 변경 사항과 누가 언제 바꿨는지가 남고, 버전을 열고, 비교하고, 이름을 붙이고, 복원할 수 있습니다.

각자 프로젝트의 자기 이력도 따로 보관합니다.

- [저장된 체크포인트](/docs/checkpoints/)는 다른 프로젝트와 마찬가지로 컴파일에 성공한 뒤 내 컴퓨터에서 만들어집니다.
- [Git 커밋](/docs/git-history/)은 내 저장소에서 내가 만든 커밋입니다.
- **활동**의 **검토**는 내가 없는 동안 다른 사람들이 바꾼 내용을 보여 줍니다. [다시 연결될 때](/docs/collaboration/offline/#when-you-reconnect)를 읽어 보세요.

## 버전 복원하기

공유 기록의 한 시점으로 돌아가려면 **기록**에서 해당 버전을 열고 **이 파일 복원** 또는 **전체 프로젝트 복원**을 선택하세요. [파일 또는 전체 프로젝트 복원하기](/docs/collaboration/history/#restore-a-file-or-the-whole-project)를 읽어 보세요.

내 체크포인트와 커밋은 다른 프로젝트와 똑같이 복원합니다. **버전 관리 → 저장된 체크포인트** 또는 **버전 관리 → Git 이력**을 열고, 원하는 버전에서 **복원**을 선택하세요. 소유자와 편집자가 복원할 수 있습니다.

공유 프로젝트에서 복원하면 모두의 공유 파일이 바뀝니다. Oleafly는 복원된 텍스트를 편집으로 보내므로, 그 순간 다른 사람들이 입력하는 내용은 함께 병합되고 사라지지 않습니다. 복원으로 많은 파일이 바뀌면 먼저 **보내기** 또는 **로컬에 유지** 질문이 나옵니다.

결과가 모두에게 전달되므로 복원하기 전에 공동 저자들에게 알리세요.

## 삭제한 파일 복원하기

삭제한 파일은 **실시간 공동 작업** 패널의 **최근 삭제한 항목**에서 기다립니다. **복원**을 선택하면 모두에게 파일이 돌아옵니다. [최근 삭제한 항목](/docs/collaboration/files/#recently-deleted)을 읽어 보세요.
