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

# المزامنة مع GitLab

> اربط حسابك على GitLab، واستورد مشروعًا أو صدّره، وزامن التغييرات في الاتجاهين، وألغِ الربط.

اربط مشروعًا بمستودع على GitLab. تنتقل التغييرات في الاتجاهين، ولا يحدث ذلك إلا عند النقر على **Sync**: لا شيء يُزامَن من تلقاء نفسه.

> [!NOTE]
>
> يجب على المسؤول تفعيل [المزامنة مع GitLab](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md) أولًا.

## ربط حسابك على GitLab

تفعل ذلك مرة واحدة.

**1. افتح إعدادات حسابك**

انقر على **Account**، ثم **Account settings**. ضمن **Project synchronisation**، ابحث عن **GitLab** وانقر على **Link**.

![قسم GitLab في إعدادات الحساب مع زر Link](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cd34b300ea3566a7083df441f465a163)

GitLab في إعدادات الحساب

**2. امنح التفويض على GitLab**

يُفتح GitLab. سجّل الدخول إذا طُلب منك ذلك، ثم امنح التطبيق التفويض.

**3. تحقّق من الربط**

تعود إلى إعدادات الحساب. تخبرك رسالة خضراء بأن حسابك على GitLab مرتبط، ويظهر على الزر الآن **Unlink**.

![قسم GitLab في إعدادات الحساب مع زر Unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=f187b1d6ba770789495f03ecac75c7f7)

حسابك على GitLab مرتبط

إذا لم يكن حسابك مرتبطًا بعد، يطلب منك **Import from GitLab** وبطاقة **GitLab** في المحرر ربطه أولًا. انقر على **Link to your GitLab account**. ستصل أيضًا إلى إعدادات الحساب، في علامة تبويب جديدة إذا بدأت من المحرر. ثم ارجع وابدأ من جديد.

![مربع الحوار Import from GitLab مع زر Link to your GitLab account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=50ded943f918001121d5a00ef345d008)

الرسالة عندما لا يكون حسابك مرتبطًا

## استيراد مستودع

ينشئ هذا مشروعًا جديدًا من مستودع على GitLab، مرتبطًا به مسبقًا.

**1. افتح مربع حوار الاستيراد**

في صفحة المشاريع، انقر على **New project**، ثم **Import from GitLab**.

![قائمة New project مع Import from GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=4065d1b3b3e2fc5542272e38e2d01f61)

قائمة New project

**2. اختر المستودع**

انقر على **Import to Overleaf** بجوار المستودع. تتضمن القائمة مستودعاتك ومستودعات مجموعاتك.

![مربع الحوار Import from GitLab يعرض أربعة مستودعات](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=cb0ba36bfa954e101ec1ccd8dac0bca3)

مستودعاتك على GitLab

**3. تحقّق من المشروع**

يُفتح المشروع الجديد مع ملفات المستودع.

![المحرر يعرض المشروع المستورد مع ملفاته وملف PDF المُجمَّع](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=a467df37fd623dffe523b5a92ebc47c1)

المشروع المستورد

## تصدير مشروع إلى مستودع جديد

ينشئ هذا مستودعًا من مشروع ويربطهما معًا. لا يمكن ربط المشروع إلا بهذه الطريقة أو بالاستيراد: لا يمكنك ربطه بمستودع موجود بالفعل.

**1. افتح GitLab في المحرر**

افتح المشروع. في الشريط الأيسر، انقر على **Integrations**، ثم **GitLab**.

![لوحة Integrations مع بطاقة GitLab](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=df24d11afeb5bbec55a8a745fd58f47a)

لوحة Integrations

**2. املأ بيانات المستودع**

اختر **Owner**، ويمكن أن يكون أنت أو إحدى مجموعاتك. عند اختيار مجموعة، يصبح اسم هذا الحقل **Organization**. يبدأ **Repository Name** باسم المشروع. الوصف اختياري، و**Private** محدد افتراضيًا. انقر على **Create a GitLab repository**.

![نموذج Export Project to GitLab بعد ملئه](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=ba5191a105be584e994ad663565ee511)

Export Project to GitLab

إذا كان الاسم مستخدمًا بالفعل، يعرض مربع الحوار **Please check that the repository name is valid, and that you have permission to create the repository.** غيّر الاسم وانقر على الزر مرة أخرى.

**3. تحقّق من الربط**

يعرض مربع الحوار الآن **This project is linked to** واسم المستودع.

![مربع الحوار Sync with GitLab بعد التصدير](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=6e18dc3c00fb9a29b3bb2f1a76cec08e)

المشروع مرتبط

## المزامنة

**1. افتح مربع حوار المزامنة**

افتح مشروعًا مرتبطًا. في الشريط الأيسر، انقر على **Integrations**، ثم **GitLab**.

يسرد **Recent commits in GitLab** ما سيدخل إلى المشروع.

![مربع الحوار Sync with GitLab يعرض commit جديدًا واحدًا](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=e67529c0cad7a0cb7eafaa5f8d134b0a)

commit جديد ينتظر على GitLab

**2. صِف تغييراتك**

إذا غيّرت شيئًا في المشروع، يظهر مربع لرسالة الـ commit. وهو اختياري: إذا تركته فارغًا، يكون اسم الـ commit هو `Updates from Overleaf`.

![مربع الحوار Sync with GitLab مع رسالة commit مكتوبة](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=45677a6ea3a96235bcde72e1cdaa436a)

رسالة الـ commit لتغييراتك

**3. انقر على Sync**

انقر على **Sync**. تدخل الـ commits الجديدة من GitLab إلى المشروع، وتذهب تغييراتك إلى الفرع الافتراضي في المستودع. إذا غيّر الجانبان أشياء مختلفة، تُدمج لك تلقائيًا.

**4. تحقّق من النتيجة**

يعرض مربع الحوار **No new commits in GitLab since last merge.** ويختفي مربع رسالة الـ commit. الملفات في المحرر والـ commits على GitLab محدّثة.

![مربع الحوار Sync with GitLab بعد المزامنة، بلا commits جديدة](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=74dd7ceacb36ac0289d76504e95e7ba7)

كل شيء متزامن

### إذا تغيّرت الأسطر نفسها في الجانبين

يخبرك مربع الحوار بأنه تعذّر دمج التغييرات، ويذكر فرعًا جديدًا، `overleaf-YYYY-MM-DD-HHMMSS`، يحتوي على تغييراتك. يفتح Overleaf أيضًا طلب دمج (merge request) من ذلك الفرع على GitLab.

![مربع الحوار Sync with GitLab مع تحذير من تعارض في الدمج](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=da33555666132affd667ce24b61221c9)

تعارض

1. ادمج ذلك الفرع في الفرع الافتراضي على GitLab أو باستخدام Git. يمكنك إغلاق مربع الحوار في هذه الأثناء: فهو يعرض الرسالة نفسها عند فتحه مرة أخرى.
2. انقر على **I have manually merged. Continue**. تدخل النتيجة المدموجة إلى المشروع. إذا نقرت عليه قبل دمج الفرع، يبقى مربع الحوار كما هو.
3. يبقى الفرع على GitLab، ما لم تحذفه أثناء الدمج. احذفه عندما لا تعود بحاجة إليه.

يظهر مربع الحوار نفسه عندما تحجز قواعد الدمج في المستودع طلب الدمج، مثلًا عندما يحتاج إلى موافقة، حتى إن لم تكن هناك أسطر متعارضة. عندما تسمح القاعدة بذلك، ادمج طلب الدمج على GitLab وانقر على **I have manually merged. Continue**. راجع [كيف تعمل المزامنة مع GitLab](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#how-syncing-works-with-gitlab).

## إلغاء ربط مشروع

افعل ذلك عندما لا تعود تريد مزامنة المشروع.

**1. انقر على Unlink**

في مربع حوار المزامنة، انقر على **Unlink**.

**2. أكّد**

انقر على **Confirm**. يزيل هذا الربط فقط: الاتصال بمستودع تملكه، الذي يذكره التحذير، هو خيار متاح لك لاحقًا، وليس شيئًا يحدث الآن.

![مربع الحوار Sync with GitLab يطلب تأكيد إلغاء الربط](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=8d7469fda58abd012ed1364f9f54005d)

تأكيد إلغاء الربط

**3. تحقّق من النتيجة**

يعرض مربع الحوار الآن **Export Project to GitLab**. يحتفظ كل من المشروع والمستودع بمحتواه. للمزامنة مرة أخرى، صدّر المشروع إلى مستودع جديد، أو استورد المستودع إلى مشروع جديد.

## إلغاء ربط حسابك على GitLab

في **Account settings**، ضمن **GitLab**، انقر على **Unlink**، ثم انقر على **Unlink** مرة أخرى في مربع الحوار.

![مربع الحوار Unlink GitLab Account](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitlab-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=478ab26a1f13d3a9cb08ffc15ad64bc1)

إلغاء ربط حسابك

تبقى مشاريعك مرتبطة بمستودعاتها. لا يمكنك مزامنتها حتى تربط حسابك مرة أخرى.

> [!NOTE]
>
> لمعرفة من يمكنه فعل ماذا في مشروع مشترك، راجع [من يمكنه الربط والمزامنة](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/gitlab-synchronisation.md#who-can-link-and-sync).


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