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

# Tích hợp Git

> Tạo token truy cập, sao chép dự án bằng Git, sau đó pull và push.

Làm việc với dự án trên máy tính của bạn bằng Git. Thay đổi chỉ được chuyển khi bạn chạy `git pull` hoặc `git push`.

> [!NOTE]
>
> Quản trị viên phải bật [tích hợp Git](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md) trước.

## Tạo token

Git đăng nhập bằng token xác thực Git, không phải bằng mật khẩu tài khoản của bạn.

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

Nhấp vào **Account**, sau đó **Account settings**. Trong **Git integration**, nhấp vào **Generate token**. Khi bạn đã có token, nút này có tên **Add another token**.

![Mục Git integration trong cài đặt tài khoản với nút Generate token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-settings.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f4ff1f16eb46266f7bf31956bf3b9d89)

Tích hợp Git trong cài đặt tài khoản

**2. Sao chép token**

Nhấp vào **Copy** và cất token ở nơi an toàn. Bạn chỉ thấy token một lần. Sau đó nhấp vào **Close**.

![Hộp thoại token xác thực Git với nút Copy](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8358a37df6799da34fd12c6503f619f5)

Token mới của bạn

**3. Kiểm tra token**

Danh sách giờ hiển thị phần đầu của token, thời điểm tạo và lần sử dụng gần nhất. Token hết hạn sau một năm. Bạn có thể có tối đa 10 token.

![Danh sách token với một token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-tokens.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e96fcc8b665f3005f950b7706fdf451c)

Các token của bạn

## Sao chép dự án

**1. Mở tích hợp Git trong trình soạn thảo**

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

![Bảng Integrations với thẻ Git integration](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-panel.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=3fb82c63ba8d205191eadb5015bdefb5)

Bảng Integrations

**2. Sao chép lệnh**

Hộp thoại **Clone with Git** hiển thị lệnh, kèm địa chỉ trang của bạn và ID của dự án. Nhấp vào **Copy**. Nếu bạn chưa có token, **Go to settings** mở cài đặt tài khoản trong một tab mới.

![Hộp thoại Clone with Git với lệnh git clone](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-clone.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f6d69046df7caf4cbee07f49e8dd6540)

Lệnh sao chép

**3. Chạy lệnh**

Dán lệnh vào terminal. Khi Git hỏi mật khẩu, hãy dán token của bạn.

```text theme={null}
$ git clone https://git@<your-site>/git/<project-id>
Cloning into '<project-id>'...
Password for 'https://git@<your-site>': <your-token>
```

Một thư mục mang tên ID dự án giờ chứa các tệp của dự án, trên nhánh `main`. Để chọn tên thư mục, hãy thêm tên vào cuối lệnh.

Git hỏi token mỗi lần kết nối với trang. Để token được ghi nhớ, hãy bật credential helper: Git hỏi thêm một lần, sau đó giữ token. Helper `store` lưu token ở dạng không mã hóa trong `~/.git-credentials`.

```bash theme={null}
git config --global credential.helper store
```

## Kéo thay đổi từ trình soạn thảo

Bên trong thư mục, chạy:

```bash theme={null}
git pull
```

Git liệt kê các tệp đã thay đổi. Thay đổi thực hiện trong trình soạn thảo đến dưới dạng các commit có tên `Update on Overleaf.`.

```text theme={null}
Updating db007e3..c3e6332
Fast-forward
 main.tex | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
```

## Đẩy thay đổi của bạn

Commit các thay đổi, sau đó push:

```bash theme={null}
git add main.tex
git commit -m "Add a line from Git"
git push
```

Dòng cuối của đầu ra cho biết nhánh đã di chuyển:

```text theme={null}
   53aca61..db007e3  main -> main
```

Thay đổi xuất hiện trong trình soạn thảo, và trình soạn thảo đang mở tự cập nhật. Tệp, thư mục mới và việc đổi tên xuất hiện trong cây tệp. Trong **History**, thay đổi của bạn được đánh dấu **You (via Git)**. Thông điệp commit của bạn không hiển thị ở đó.

![Lịch sử dự án hiển thị dòng đã push, được đánh dấu You (via Git)](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-history.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e2f4d5575612ebd75db3656cac1ea495)

Một lần push trong lịch sử dự án

### Nếu Git từ chối push của bạn

Nếu dự án đã thay đổi trong lúc đó, Git từ chối push:

```text theme={null}
 ! [rejected]        main -> main (fetch first)
```

Hãy lấy những thay đổi đó trước, sau đó push lại:

```bash theme={null}
git pull --no-rebase --no-edit
git push
```

Một lệnh `git pull` đơn thuần có thể dừng với `fatal: Need to specify how to reconcile divergent branches.` Tùy chọn `--no-rebase` ở trên giải quyết điều đó: nó hợp nhất hai phía.

Nếu cùng các dòng đã thay đổi ở cả hai phía, pull dừng với `CONFLICT (content): Merge conflict in main.tex`. Sửa tệp, sau đó chạy:

```bash theme={null}
git add main.tex
git commit -m "Merge the changes from the editor"
git push
```

Có hai điều trang không chấp nhận:

* Nhánh khác: `! [remote rejected] feature -> feature (wrong branch)`. Chỉ có `main`, vì vậy hãy push công việc của bạn lên đó.
* Force push: `! [remote rejected] main -> main (forced push prohibited)`. Thay vào đó, hãy đặt thay đổi của bạn lên trên `main` hiện tại.

### Nếu Git báo Authentication failed

```text theme={null}
remote: Enter your Git authentication token when prompted for a password.
fatal: Authentication failed for 'https://<your-site>/git/<project-id>/'
```

Token sai hoặc đã bị xóa, hoặc bạn đã nhập mật khẩu tài khoản. Hãy tạo token mới nếu bạn không còn token, vì bạn không thể xem lại token hiện có.

## Xóa token

Trong **Account settings**, ở mục **Git integration**, nhấp vào biểu tượng xóa bên cạnh token, sau đó nhấp **Delete** trong hộp thoại. Từ đó trở đi, Git trả lời `Authentication failed` cho token đó.

![Hộp thoại Delete Authentication token](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/git-integration-delete-token.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=1708062228778239c6465b0369614a18)

Xóa token

> [!NOTE]
>
> Để biết cộng tác viên chỉ có quyền đọc có thể làm gì, hãy xem phần Q\&A của [tích hợp Git](https://ayakaleaf-pro.mintlify.site/vi/on-premises/configuration/overleaf-toolkit/integrations/git-integration.md).


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