> ## 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.

# Đồng bộ hóa GitHub

> Liên kết tài khoản GitHub, nhập hoặc xuất dự án, đồng bộ thay đổi hai chiều và hủy liên kết.

Kết nối dự án với một kho GitHub. Thay đổi đi theo cả hai chiều, và chỉ khi bạn nhấp vào **Sync**: không có gì tự đồng bộ.

> [!NOTE]
>
> Nếu bạn không thấy tùy chọn GitHub trong **Account settings** hoặc trong trình soạn thảo, hãy yêu cầu quản trị viên bật [Đồng bộ hóa GitHub](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md).

## Liên kết tài khoản GitHub

Bạn chỉ làm việc này một lần.

**1. Mở cài đặt tài khoản**

Nhấp vào **Account**, sau đó **Account settings**. Cuộn đến **GitHub** và nhấp vào **Link**.

![Mục GitHub trong cài đặt tài khoản với nút Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8812ab1604914a8aa6c1f0937f0e1b2e)

GitHub trong cài đặt tài khoản

**2. Ủy quyền trên GitHub**

GitHub mở ra. Đăng nhập nếu được yêu cầu, sau đó ủy quyền cho ứng dụng.

**3. Kiểm tra liên kết**

Bạn quay lại cài đặt tài khoản, và nút giờ hiển thị **Unlink**.

![Mục GitHub trong cài đặt tài khoản với nút Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=910b756aa0adea66bda5bb2e5776214e)

Tài khoản GitHub của bạn đã được liên kết

Nếu tài khoản của bạn chưa được liên kết, **Import from GitHub** và thẻ **GitHub** trong trình soạn thảo sẽ yêu cầu bạn liên kết trước. Nhấp vào **Link to your GitHub account**. Bạn cũng sẽ đến cài đặt tài khoản, trong một tab mới nếu bạn bắt đầu từ trình soạn thảo. Sau đó quay lại và bắt đầu lại.

![Hộp thoại Import from GitHub với nút Link to your GitHub account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=05546893169a57f837a8938f904db194)

Lời nhắc khi tài khoản chưa được liên kết

## Nhập kho

Thao tác này tạo một dự án mới từ kho GitHub, đã được liên kết sẵn với kho đó.

**1. Mở hộp thoại nhập**

Trên trang dự án, nhấp vào **New project**, sau đó **Import from GitHub**.

![Menu New project với Import from GitHub](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)

Menu New project

> [!NOTE]
>
> **New project** xuất hiện khi bạn đã có dự án. Menu **Create a new project** trên trang chào mừng không có chức năng nhập, vì vậy hãy tạo một dự án trống trước.

**2. Chọn kho**

Nhấp vào **Import to Overleaf** bên cạnh kho. Danh sách gồm các kho của bạn và của các tổ chức của bạn.

![Hộp thoại Import from GitHub liệt kê bốn kho](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=54a0bd11655ddbfad4ae16e5e7473b74)

Các kho GitHub của bạn

Nếu thiếu kho của một tổ chức, hãy nhấp vào **Can't see what you're looking for?** để xem hướng dẫn của GitHub về việc phê duyệt ứng dụng cho tổ chức đó.

**3. Kiểm tra dự án**

Dự án mới mở ra với các tệp của kho.

![Trình soạn thảo hiển thị dự án đã nhập cùng các tệp và PDF đã biên dịch](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=90dfe6947c2e0ed420abfc8c81992768)

Dự án đã nhập

## Xuất dự án sang kho mới

Thao tác này tạo một kho từ dự án mà bạn sở hữu và liên kết chúng. Dự án chỉ có thể được liên kết theo cách này hoặc bằng cách nhập: bạn không thể liên kết nó với một kho đã tồn tại.

**1. Mở GitHub trong trình soạn thảo**

Mở dự án. Ở thanh bên trái, nhấp vào **Integrations**, sau đó **GitHub**.

![Bảng Integrations với thẻ GitHub](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5c96ec0031a5940c337393254b06e0d3)

Bảng Integrations

**2. Điền thông tin kho**

Chọn **Owner**, có thể là bạn hoặc một trong các tổ chức của bạn. **Repository Name** ban đầu là tên dự án. Mô tả là tùy chọn, và **Private** được chọn theo mặc định. Nhấp vào **Create a GitHub repository**.

![Biểu mẫu Export Project to GitHub đã điền](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. Kiểm tra liên kết**

Hộp thoại giờ hiển thị **This project is linked to** và tên kho.

![Hộp thoại Sync with GitHub sau khi xuất](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=93ebf2c62d4a34c7d2c41ffbca9d0740)

Dự án đã được liên kết

## Đồng bộ

**1. Mở hộp thoại đồng bộ**

Mở một dự án đã liên kết. Ở thanh bên trái, nhấp vào **Integrations**, sau đó **GitHub**.

**Recent commits in GitHub** liệt kê những gì sẽ vào dự án.

![Hộp thoại Sync with GitHub liệt kê một commit mới](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6a3c23a6993f04d0fa818bceb565ce3e)

Một commit mới đang chờ trên GitHub

**2. Mô tả thay đổi của bạn**

Nếu bạn đã thay đổi gì đó trong dự án, một ô nhập thông điệp commit sẽ xuất hiện. Ô này là tùy chọn: nếu bạn để trống, commit có tên `Updates from Overleaf`.

![Hộp thoại Sync with GitHub với thông điệp commit đã điền](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3fe2cbcae8335c7363fcd220d2b993c)

Thông điệp commit cho thay đổi của bạn

**3. Nhấp vào Sync**

Nhấp vào **Sync**. Các commit mới từ GitHub vào dự án, và thay đổi của bạn đi đến nhánh mặc định của kho. Nếu hai phía thay đổi những phần khác nhau, chúng được hợp nhất giúp bạn.

**4. Kiểm tra kết quả**

Hộp thoại hiển thị **No new commits in GitHub since last merge.** và ô thông điệp commit biến mất. Các tệp trong trình soạn thảo và các commit trên GitHub đều đã cập nhật.

![Hộp thoại Sync with GitHub sau khi đồng bộ, không có commit mới](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=851a620d8601a3ebaf9260f0f1c1685a)

Mọi thứ đã được đồng bộ

### Nếu cùng các dòng đã thay đổi ở cả hai phía

Hộp thoại cho biết không thể hợp nhất các thay đổi và nêu tên một nhánh mới, `overleaf-YYYY-MM-DD-HHMMSS`, chứa thay đổi của bạn.

![Hộp thoại Sync with GitHub với cảnh báo xung đột hợp nhất](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b67dd69bb98605672da34b3a372be582)

Xung đột

1. Hợp nhất nhánh đó vào nhánh mặc định trên GitHub hoặc bằng Git. Trong lúc đó, bạn có thể đóng hộp thoại: nó hiển thị cùng thông báo khi bạn mở lại.
2. Nhấp vào **I have manually merged. Continue**. Kết quả đã hợp nhất vào dự án.
3. Nhánh vẫn ở trên GitHub. Hãy xóa nó khi bạn không còn cần.

## Hủy liên kết dự án

Làm việc này khi bạn không còn muốn dự án đồng bộ. Chỉ chủ sở hữu dự án mới làm được.

**1. Nhấp vào Unlink**

Trong hộp thoại đồng bộ, nhấp vào **Unlink**.

**2. Xác nhận**

Nhấp vào **Confirm**. Ghi chú về gói đăng ký không ngăn bạn liên kết lại dự án.

![Hộp thoại Sync with GitHub yêu cầu xác nhận hủy liên kết](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/github-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f2e541c2e9e8d000baa0dacd28a328)

Xác nhận hủy liên kết

**3. Kiểm tra kết quả**

Hộp thoại giờ hiển thị **Export Project to GitHub**. Cả dự án và kho đều giữ nguyên nội dung. Để đồng bộ lại, hãy xuất dự án sang một kho mới, hoặc nhập kho vào một dự án mới.

## Hủy liên kết tài khoản GitHub

Trong **Account settings**, ở mục **GitHub**, nhấp vào **Unlink**, sau đó nhấp **Unlink** lần nữa trong hộp thoại.

![Hộp thoại 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)

Hủy liên kết tài khoản

Các dự án của bạn vẫn liên kết với kho của chúng. Bạn không thể đồng bộ chúng cho đến khi liên kết lại tài khoản.

> [!NOTE]
>
> Để biết ai có thể làm gì trong dự án chia sẻ, hãy xem [Ai có thể liên kết và đồng bộ](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md#who-can-link-and-sync). Mỗi cộng tác viên đồng bộ đều liên kết tài khoản GitHub của riêng mình.


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