# Git과 소스 관리

일반 Git 저장소에서 diff를 검토하고, 파일을 스테이지하고, 이정표를 저장합니다.

이름을 붙이고 싶은 버전에 Git을 쓰세요. 완성한 장, 지도 교수에게 보낸 수정본, 투고 원고의 소스 등이 해당합니다. GitHub 계정 없이 로컬에서 동작합니다.

![LLaMA의 소스 관리. 변경된 파일을 열어 검토한 다음, 다음 커밋에 넣을 파일을 스테이지합니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,45,344,513)

![나란히 놓고 비교한 변경 사항을 검토하고 스테이지한 뒤 커밋하는 모습.](https://cdn.oleafly.com/images/gifs/desktop/git-commit.gif?v=2)

## 소스 관리 열기

프로젝트 레일에서 **소스 관리**를 엽니다. 패널에는 현재 브랜치, 스테이지된 파일, 작업 중인 변경 사항이 표시됩니다.

파일을 클릭하면 diff를 볼 수 있습니다. 분할 보기와 통합 보기를 전환하고, 변경 사이를 이동하고, 작업 사본을 직접 편집할 수 있습니다. 스테이지된 diff는 읽기 전용입니다.

탐색기는 소스 관리와 같은 글자로 변경된 파일을 표시합니다. 수정은 M, 추가는 A, 삭제는 D, 추적되지 않음은 U입니다. 파일 이름은 원래 색을 유지하고, 변경 사항이 들어 있는 폴더에는 점이 붙습니다. [파일과 폴더](/docs/files/)를 참고하세요.

## 첫 커밋

Oleafly가 프로젝트를 만들거나 가져오면 Git 저장소를 설정하고 프로젝트의 파일을 "Create project"라는 커밋 하나로 기록합니다. 그래서 소스 관리는 처음부터 실제 차이를 보여 줍니다. 이 커밋에는 Git 훅과 커밋 서명이 실행되지 않으므로, 전역 훅이나 서명 확인 창이 프로젝트 생성을 막을 수 없습니다.

다음 경우에는 Oleafly가 첫 커밋을 건너뜁니다.

- 프로젝트 파일의 합계가 100 MB를 넘는 경우.
- `.env`, `*.pem`, SSH 개인 키, `credentials.json`처럼 보통 비밀번호나 키가 들어 있는 파일이 있는 경우. 비밀 정보는 한 번 커밋되면 나중에 무시하도록 설정해도 기록에 남습니다. `.env.example` 같은 템플릿, 공개 키, Keynote `.key` 파일은 해당하지 않습니다.

커밋을 건너뛰어도 저장소는 만들어집니다. 모든 파일이 추적되지 않은 상태로 남아 직접 정리하게 되며, 앱 로그에 이유가 적힙니다.

저장소가 없는 프로젝트를 열면 `git init`만 실행하고 커밋은 하지 않습니다. 첫 커밋 이후에는 여러분이 요청할 때만 Oleafly가 커밋합니다. 제자리에서 연 폴더와 이미 다른 저장소 안에 있는 폴더는 건드리지 않습니다.

이 모든 것을 끄려면 **설정 → 연동 → GitHub**에서 **모든 프로젝트에 Git 초기화**를 끄세요. 그러면 소스 관리는 **저장소 초기화**를 누르거나 GitHub에 게시할 때만 시작됩니다.

## Git이 설치되어 있지 않을 때

Oleafly는 컴퓨터에 설치된 Git을 사용합니다. Git이 없어도 프로젝트를 열고 컴파일할 수 있습니다. 소스 관리는 실패할 버튼을 보여 주는 대신 **Git이 설치되어 있지 않습니다**를 표시하고 시스템에 맞는 Git 설치 방법을 안내합니다.

- **Windows**: **Git for Windows 다운로드**를 선택하고 Git을 설치한 다음 Oleafly를 다시 시작하세요.
- **macOS**: 터미널에서 `xcode-select --install`을 실행해 Git이 포함된 Apple 명령줄 도구를 설치하세요. **명령 복사**를 누르면 명령이 복사됩니다. 그런 다음 패널을 새로 고치세요.
- **Linux**: 패키지 관리자로 `git` 패키지를 설치한 다음 패널을 새로 고치세요.

## 이정표 저장

![커밋 제목, 선택 사항인 설명, 커밋, 푸시, 풀 컨트롤은 변경된 파일 목록 아래에 있습니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/source-control-dark-window-v2.png#view=0,815,344,260)

1. 변경된 파일을 검토합니다.
2. 커밋에 넣을 파일을 스테이지합니다.
3. `Revise methods and add calibration figure`처럼 결과를 설명하는 메시지를 씁니다.
4. 커밋합니다.

**커밋** 옆의 메뉴에는 **마지막 커밋 수정**, **커밋 및 푸시**, **커밋 및 동기화**도 있습니다. 모두 일반적인 Git 커밋입니다. 같은 저장소를 다른 Git 클라이언트나 명령줄로도 살펴볼 수 있습니다.

## 브랜치와 스태시

패널 맨 위의 브랜치 이름을 클릭하면 브랜치를 전환하거나 **브랜치 만들기…** 항목을 선택할 수 있습니다. **추가 소스 관리 작업** 메뉴에는 **가져오기**, **풀**, **푸시**, **동기화**, **변경 사항 스태시**, **최근 스태시 적용**이 있습니다.

풀이나 스태시에서 충돌이 생기면 패널에 충돌한 파일이 나열됩니다. 파일마다 **현재 것 사용**, **들어온 것 사용**을 선택하거나, 파일을 직접 편집하고 **해결됨으로 표시**를 선택하세요. 병합 중에는 모든 파일이 해결되면 **병합 완료**를 쓸 수 있고, **병합 중단**은 파일을 병합이 시작되기 전 상태로 되돌립니다.

## 커밋 복원

**버전 관리 → Git 이력**을 열고 커밋을 선택한 다음 복원 확인 창을 검토하세요. 복원하면 추적 중인 프로젝트 내용이 해당 버전으로 바뀌고 열려 있는 편집기 버퍼가 다시 로드됩니다. 브랜치는 현재 커밋에 그대로 머뭅니다.

컴파일에 성공할 때마다 자동으로 찍는 스냅샷이 필요하면 [저장된 체크포인트](/docs/checkpoints/)를 사용하세요. 그 스냅샷은 따로 저장되며 Git 커밋을 만들지 않습니다.

## 원격 추가

기기 밖에 사본을 두거나 컴퓨터 사이에서 작업을 옮기고 싶다면 GitHub를 연결하세요. **GitHub에 게시**, **푸시**, **풀**은 소스 관리 패널에 있습니다.

[GitHub 동기화 설정 →](/docs/github-sync/)
