> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub 동기화

> GitHub 계정을 연결하고, 프로젝트를 가져오거나 내보내고, 변경 사항을 양방향으로 동기화하고, 연결을 해제합니다.

프로젝트를 GitHub 저장소에 연결하세요. 변경 사항은 양방향으로 이동하며, **Sync**를 클릭할 때만 이동합니다. 자동으로 동기화되는 것은 없습니다.

> [!NOTE]
>
> **Account settings**나 편집기에 GitHub 옵션이 보이지 않으면 관리자에게 [GitHub 동기화](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md)를 켜 달라고 요청하세요.

## GitHub 계정 연결하기

이 작업은 한 번만 합니다.

**1. 계정 설정 열기**

**Account**를 클릭한 다음 **Account settings**를 클릭합니다. **GitHub**까지 스크롤하고 **Link**를 클릭합니다.

![Link 버튼이 있는 계정 설정의 GitHub 섹션](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8812ab1604914a8aa6c1f0937f0e1b2e)

계정 설정의 GitHub

**2. GitHub에서 승인**

GitHub가 열립니다. 요청을 받으면 로그인한 다음 애플리케이션을 승인합니다.

**3. 연결 확인**

계정 설정으로 돌아오며, 이제 버튼에 **Unlink**가 표시됩니다.

![Unlink 버튼이 있는 계정 설정의 GitHub 섹션](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=910b756aa0adea66bda5bb2e5776214e)

GitHub 계정이 연결됨

계정이 아직 연결되지 않았다면 **Import from GitHub**와 편집기의 **GitHub** 카드가 먼저 연결하라고 요청합니다. **Link to your GitHub account**를 클릭하세요. 이 경우에도 계정 설정으로 이동하며, 편집기에서 시작했다면 새 탭에서 열립니다. 그런 다음 돌아가서 다시 시작하세요.

![Link to your GitHub account 버튼이 있는 Import from GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=05546893169a57f837a8938f904db194)

계정이 연결되지 않았을 때의 안내

## 저장소 가져오기

GitHub 저장소에서 새 프로젝트를 만들며, 이 프로젝트는 이미 해당 저장소에 연결되어 있습니다.

**1. 가져오기 대화 상자 열기**

프로젝트 페이지에서 **New project**를 클릭한 다음 **Import from GitHub**를 클릭합니다.

![Import from GitHub가 있는 New project 메뉴](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=384e6663f982016a5c295f35c4709413)

New project 메뉴

> [!NOTE]
>
> **New project**는 프로젝트가 하나 이상 있을 때 나타납니다. 시작 페이지의 **Create a new project** 메뉴에는 가져오기가 없으므로, 먼저 빈 프로젝트를 만드세요.

**2. 저장소 선택**

저장소 옆의 **Import to Overleaf**를 클릭합니다. 목록에는 내 저장소와 내가 속한 조직의 저장소가 포함됩니다.

![저장소 네 개가 나열된 Import from GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=54a0bd11655ddbfad4ae16e5e7473b74)

내 GitHub 저장소

조직의 저장소가 보이지 않으면 \*\*Can't see what you're looking for?\*\*를 클릭해 해당 조직에서 애플리케이션을 승인하는 방법에 대한 GitHub 도움말을 확인하세요.

**3. 프로젝트 확인**

새 프로젝트가 저장소의 파일과 함께 열립니다.

![가져온 프로젝트의 파일과 컴파일된 PDF를 보여 주는 편집기](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=90dfe6947c2e0ed420abfc8c81992768)

가져온 프로젝트

## 프로젝트를 새 저장소로 내보내기

내가 소유한 프로젝트에서 저장소를 만들고 둘을 연결합니다. 프로젝트는 이 방법이나 가져오기로만 연결할 수 있으며, 이미 존재하는 저장소에는 연결할 수 없습니다.

**1. 편집기에서 GitHub 열기**

프로젝트를 엽니다. 왼쪽 막대에서 **Integrations**를 클릭한 다음 **GitHub**를 클릭합니다.

![GitHub 카드가 있는 Integrations 패널](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5c96ec0031a5940c337393254b06e0d3)

Integrations 패널

**2. 저장소 정보 입력**

**Owner**를 선택합니다. 본인 또는 내가 속한 조직 중 하나를 선택할 수 있습니다. **Repository Name**의 초기값은 프로젝트 이름입니다. 설명은 선택 사항이며, **Private**가 기본으로 선택되어 있습니다. **Create a GitHub repository**를 클릭합니다.

![입력이 완료된 Export Project to GitHub 양식](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=24bd26a171943d43efaa3c4aed69d1e8)

Export Project to GitHub

**3. 연결 확인**

이제 대화 상자에 **This project is linked to**와 저장소 이름이 표시됩니다.

![내보내기 후의 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=93ebf2c62d4a34c7d2c41ffbca9d0740)

프로젝트가 연결됨

## 동기화하기

**1. 동기화 대화 상자 열기**

연결된 프로젝트를 엽니다. 왼쪽 막대에서 **Integrations**를 클릭한 다음 **GitHub**를 클릭합니다.

**Recent commits in GitHub**에 프로젝트로 들어올 내용이 나열됩니다.

![새 커밋 하나가 나열된 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6a3c23a6993f04d0fa818bceb565ce3e)

GitHub에서 대기 중인 새 커밋

**2. 변경 사항 설명**

프로젝트에서 무언가를 변경했다면 커밋 메시지 입력란이 나타납니다. 입력은 선택 사항이며, 비워 두면 커밋 이름은 `Updates from Overleaf`가 됩니다.

![커밋 메시지가 입력된 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3fe2cbcae8335c7363fcd220d2b993c)

변경 사항의 커밋 메시지

**3. Sync 클릭**

**Sync**를 클릭합니다. GitHub의 새 커밋이 프로젝트로 들어오고, 내 변경 사항은 저장소의 기본 브랜치로 갑니다. 양쪽에서 서로 다른 부분을 변경했다면 자동으로 병합됩니다.

**4. 결과 확인**

대화 상자에 \*\*No new commits in GitHub since last merge.\*\*가 표시되고 커밋 메시지 입력란이 사라집니다. 편집기의 파일과 GitHub의 커밋이 최신 상태입니다.

![동기화 후 새 커밋이 없는 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=851a620d8601a3ebaf9260f0f1c1685a)

모두 동기화됨

### 양쪽에서 같은 줄이 변경된 경우

대화 상자에 변경 사항을 병합할 수 없다는 메시지와 함께, 내 변경 사항을 담은 새 브랜치 `overleaf-YYYY-MM-DD-HHMMSS`의 이름이 표시됩니다.

![병합 충돌 경고가 있는 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b67dd69bb98605672da34b3a372be582)

충돌

1. GitHub에서 또는 Git으로 해당 브랜치를 기본 브랜치에 병합합니다. 그동안 대화 상자를 닫아도 됩니다. 다시 열면 같은 메시지가 표시됩니다.
2. **I have manually merged. Continue**를 클릭합니다. 병합된 결과가 프로젝트로 들어옵니다.
3. 브랜치는 GitHub에 남습니다. 더 이상 필요하지 않으면 삭제하세요.

## 프로젝트 연결 해제하기

프로젝트를 더 이상 동기화하지 않으려면 이 작업을 합니다. 프로젝트 소유자만 할 수 있습니다.

**1. Unlink 클릭**

동기화 대화 상자에서 **Unlink**를 클릭합니다.

**2. 확인**

**Confirm**을 클릭합니다. 구독에 관한 안내가 있어도 프로젝트를 다시 연결할 수 있습니다.

![연결 해제 확인을 요청하는 Sync with GitHub 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f2e541c2e9e8d000baa0dacd28a328)

연결 해제 확인

**3. 결과 확인**

이제 대화 상자에 **Export Project to GitHub**가 표시됩니다. 프로젝트와 저장소는 모두 내용을 유지합니다. 다시 동기화하려면 프로젝트를 새 저장소로 내보내거나, 저장소를 새 프로젝트로 가져오세요.

## GitHub 계정 연결 해제하기

**Account settings**의 **GitHub**에서 **Unlink**를 클릭한 다음, 대화 상자에서 다시 **Unlink**를 클릭합니다.

![Unlink GitHub Account 대화 상자](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=94ce090cb4d8b98231886319d6e6d903)

계정 연결 해제

프로젝트는 각자의 저장소에 연결된 상태로 남습니다. 계정을 다시 연결할 때까지 동기화할 수 없습니다.

> [!NOTE]
>
> 공유 프로젝트에서 누가 무엇을 할 수 있는지는 [연결 및 동기화할 수 있는 사람](https://ayakaleaf-pro.mintlify.site/ko/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md#who-can-link-and-sync)을 참조하세요. 동기화하는 공동 작업자는 각자 자신의 GitHub 계정을 연결합니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.