Chuyển đến nội dung chính
Kết nối dự án với một kho GitLab. 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ộ.
Quản trị viên phải bật Đồng bộ hóa GitLab trước.
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. Trong Project synchronisation, tìm GitLab và nhấp vào Link.
Mục GitLab trong cài đặt tài khoản với nút Link

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

2

Ủy quyền trên GitLab

GitLab 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. Một thông báo màu xanh lá cho biết tài khoản GitLab của bạn đã được liên kết, và nút giờ hiển thị Unlink.
Mục GitLab trong cài đặt tài khoản với nút Unlink

Tài khoản GitLab 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 GitLab và thẻ GitLab 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 GitLab 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 GitLab với nút Link to your GitLab account

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 GitLab, đã đượ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 GitLab.
Menu New project với Import from GitLab

Menu New project

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 nhóm của bạn.
Hộp thoại Import from GitLab liệt kê bốn kho

Các kho GitLab của bạn

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

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 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ở GitLab trong trình soạn thảo

Mở dự án. Ở thanh bên trái, nhấp vào Integrations, sau đó GitLab.
Bảng Integrations với thẻ GitLab

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 nhóm của bạn. Khi bạn chọn một nhóm, trường này có tên Organization. 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 GitLab repository.
Biểu mẫu Export Project to GitLab đã điền

Export Project to GitLab

Nếu tên đã được dùng, hộp thoại hiển thị Please check that the repository name is valid, and that you have permission to create the repository. Đổi tên và nhấp lại vào nút.
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 GitLab sau khi xuất

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 đó GitLab.Recent commits in GitLab liệt kê những gì sẽ vào dự án.
Hộp thoại Sync with GitLab liệt kê một commit mới

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

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 GitLab với thông điệp commit đã điền

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ừ GitLab 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 GitLab 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 GitLab đều đã cập nhật.
Hộp thoại Sync with GitLab sau khi đồng bộ, không có commit mới

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. Overleaf cũng mở một merge request từ nhánh đó trên GitLab.
Hộp thoại Sync with GitLab với cảnh báo xung đột hợp nhất

Xung đột

  1. Hợp nhất nhánh đó vào nhánh mặc định trên GitLab 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. Nếu bạn nhấp trước khi nhánh được hợp nhất, hộp thoại vẫn giữ nguyên.
  3. Nhánh vẫn ở trên GitLab, trừ khi bạn đã xóa nó khi hợp nhất. Hãy xóa nó khi bạn không còn cần.
Hộp thoại tương tự xuất hiện khi quy tắc hợp nhất của kho giữ merge request lại, chẳng hạn khi cần phê duyệt, ngay cả khi không có dòng nào xung đột. Khi quy tắc cho phép, hãy hợp nhất merge request trên GitLab và nhấp vào I have manually merged. Continue. Xem Cách đồng bộ hoạt động với GitLab. Làm việc này khi bạn không còn muốn dự án đồng bộ.
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. Thao tác này chỉ gỡ liên kết: việc kết nối với một kho bạn sở hữu, được đề cập trong cảnh báo, là một tùy chọn bạn có sau đó, không phải điều xảy ra ngay bây giờ.
Hộp thoại Sync with GitLab yêu cầu xác nhận hủy liên kết

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 GitLab. 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.
Trong Account settings, ở mục GitLab, nhấp vào Unlink, sau đó nhấp Unlink lần nữa trong hộp thoại.
Hộp thoại Unlink GitLab Account

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.
Để 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ộ.
Lần sửa đổi cuối 20 tháng 11, 2026