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

افتح إعدادات حسابك

انقر على Account، ثم Account settings. ضمن Project synchronisation، ابحث عن GitLab وانقر على Link.
قسم GitLab في إعدادات الحساب مع زر Link

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

2

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

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

تحقّق من الربط

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

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

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

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

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

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

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

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

قائمة New project

2

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

انقر على Import to Overleaf بجوار المستودع. تتضمن القائمة مستودعاتك ومستودعات مجموعاتك.
مربع الحوار Import from GitLab يعرض أربعة مستودعات

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

3

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

يُفتح المشروع الجديد مع ملفات المستودع.
المحرر يعرض المشروع المستورد مع ملفاته وملف PDF المُجمَّع

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

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

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

افتح GitLab في المحرر

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

لوحة Integrations

2

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

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

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 بعد التصدير

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

المزامنة

1

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

افتح مشروعًا مرتبطًا. في الشريط الأيسر، انقر على Integrations، ثم GitLab.يسرد Recent commits in GitLab ما سيدخل إلى المشروع.
مربع الحوار Sync with GitLab يعرض commit جديدًا واحدًا

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

2

صِف تغييراتك

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

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

3

انقر على Sync

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

تحقّق من النتيجة

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

كل شيء متزامن

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

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

تعارض

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

انقر على Unlink

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

أكّد

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

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

3

تحقّق من النتيجة

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

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

تبقى مشاريعك مرتبطة بمستودعاتها. لا يمكنك مزامنتها حتى تربط حسابك مرة أخرى.
لمعرفة من يمكنه فعل ماذا في مشروع مشترك، راجع من يمكنه الربط والمزامنة.
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦