انقر على Account، ثم Account settings. ضمن Project synchronisation، ابحث عن GitLab وانقر على Link.
GitLab في إعدادات الحساب
2
امنح التفويض على GitLab
يُفتح GitLab. سجّل الدخول إذا طُلب منك ذلك، ثم امنح التطبيق التفويض.
3
تحقّق من الربط
تعود إلى إعدادات الحساب. تخبرك رسالة خضراء بأن حسابك على GitLab مرتبط، ويظهر على الزر الآن Unlink.
حسابك على GitLab مرتبط
إذا لم يكن حسابك مرتبطًا بعد، يطلب منك Import from GitLab وبطاقة GitLab في المحرر ربطه أولًا. انقر على Link to your GitLab account. ستصل أيضًا إلى إعدادات الحساب، في علامة تبويب جديدة إذا بدأت من المحرر. ثم ارجع وابدأ من جديد.
الرسالة عندما لا يكون حسابك مرتبطًا
استيراد مستودع
ينشئ هذا مشروعًا جديدًا من مستودع على GitLab، مرتبطًا به مسبقًا.
1
افتح مربع حوار الاستيراد
في صفحة المشاريع، انقر على New project، ثم Import from GitLab.
قائمة New project
2
اختر المستودع
انقر على Import to Overleaf بجوار المستودع. تتضمن القائمة مستودعاتك ومستودعات مجموعاتك.
مستودعاتك على GitLab
3
تحقّق من المشروع
يُفتح المشروع الجديد مع ملفات المستودع.
المشروع المستورد
تصدير مشروع إلى مستودع جديد
ينشئ هذا مستودعًا من مشروع ويربطهما معًا. لا يمكن ربط المشروع إلا بهذه الطريقة أو بالاستيراد: لا يمكنك ربطه بمستودع موجود بالفعل.
1
افتح GitLab في المحرر
افتح المشروع. في الشريط الأيسر، انقر على Integrations، ثم GitLab.
لوحة Integrations
2
املأ بيانات المستودع
اختر Owner، ويمكن أن يكون أنت أو إحدى مجموعاتك. عند اختيار مجموعة، يصبح اسم هذا الحقل Organization. يبدأ Repository Name باسم المشروع. الوصف اختياري، وPrivate محدد افتراضيًا. انقر على Create a GitLab repository.
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 واسم المستودع.
المشروع مرتبط
المزامنة
1
افتح مربع حوار المزامنة
افتح مشروعًا مرتبطًا. في الشريط الأيسر، انقر على Integrations، ثم GitLab.يسرد Recent commits in GitLab ما سيدخل إلى المشروع.
commit جديد ينتظر على GitLab
2
صِف تغييراتك
إذا غيّرت شيئًا في المشروع، يظهر مربع لرسالة الـ commit. وهو اختياري: إذا تركته فارغًا، يكون اسم الـ commit هو Updates from Overleaf.
رسالة الـ commit لتغييراتك
3
انقر على Sync
انقر على Sync. تدخل الـ commits الجديدة من GitLab إلى المشروع، وتذهب تغييراتك إلى الفرع الافتراضي في المستودع. إذا غيّر الجانبان أشياء مختلفة، تُدمج لك تلقائيًا.
4
تحقّق من النتيجة
يعرض مربع الحوار No new commits in GitLab since last merge. ويختفي مربع رسالة الـ commit. الملفات في المحرر والـ commits على GitLab محدّثة.
كل شيء متزامن
إذا تغيّرت الأسطر نفسها في الجانبين
يخبرك مربع الحوار بأنه تعذّر دمج التغييرات، ويذكر فرعًا جديدًا، overleaf-YYYY-MM-DD-HHMMSS، يحتوي على تغييراتك. يفتح Overleaf أيضًا طلب دمج (merge request) من ذلك الفرع على GitLab.
تعارض
ادمج ذلك الفرع في الفرع الافتراضي على GitLab أو باستخدام Git. يمكنك إغلاق مربع الحوار في هذه الأثناء: فهو يعرض الرسالة نفسها عند فتحه مرة أخرى.
انقر على I have manually merged. Continue. تدخل النتيجة المدموجة إلى المشروع. إذا نقرت عليه قبل دمج الفرع، يبقى مربع الحوار كما هو.
يبقى الفرع على GitLab، ما لم تحذفه أثناء الدمج. احذفه عندما لا تعود بحاجة إليه.
يظهر مربع الحوار نفسه عندما تحجز قواعد الدمج في المستودع طلب الدمج، مثلًا عندما يحتاج إلى موافقة، حتى إن لم تكن هناك أسطر متعارضة. عندما تسمح القاعدة بذلك، ادمج طلب الدمج على GitLab وانقر على I have manually merged. Continue. راجع كيف تعمل المزامنة مع GitLab.
إلغاء ربط مشروع
افعل ذلك عندما لا تعود تريد مزامنة المشروع.
1
انقر على Unlink
في مربع حوار المزامنة، انقر على Unlink.
2
أكّد
انقر على Confirm. يزيل هذا الربط فقط: الاتصال بمستودع تملكه، الذي يذكره التحذير، هو خيار متاح لك لاحقًا، وليس شيئًا يحدث الآن.
تأكيد إلغاء الربط
3
تحقّق من النتيجة
يعرض مربع الحوار الآن Export Project to GitLab. يحتفظ كل من المشروع والمستودع بمحتواه. للمزامنة مرة أخرى، صدّر المشروع إلى مستودع جديد، أو استورد المستودع إلى مشروع جديد.
إلغاء ربط حسابك على GitLab
في Account settings، ضمن GitLab، انقر على Unlink، ثم انقر على Unlink مرة أخرى في مربع الحوار.
إلغاء ربط حسابك
تبقى مشاريعك مرتبطة بمستودعاتها. لا يمكنك مزامنتها حتى تربط حسابك مرة أخرى.