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

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

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

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

> [!NOTE]
>
> إذا لم تجد خيار GitHub في **Account settings** أو في المحرر، فاطلب من المسؤول تفعيل [المزامنة مع GitHub](https://ayakaleaf-pro.mintlify.site/ar/on-premises/configuration/overleaf-toolkit/integrations/github-synchronisation.md).

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

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

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

انقر على **Account**، ثم **Account settings**. مرّر إلى **GitHub** وانقر على **Link**.

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

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

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

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

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

تعود إلى إعدادات الحساب، ويظهر على الزر الآن **Unlink**.

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

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

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

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

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

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

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

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

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

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

قائمة New project

> [!NOTE]
>
> يظهر **New project** بعد أن يصبح لديك مشروع. لا تحتوي قائمة **Create a new project** في صفحة الترحيب على خيار الاستيراد، لذا أنشئ مشروعًا فارغًا أولًا.

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

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

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

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

إذا كان مستودع إحدى المؤسسات مفقودًا، فانقر على **Can't see what you're looking for?** للاطلاع على مساعدة GitHub حول الموافقة على التطبيق لتلك المؤسسة.

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

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

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

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

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

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

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

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

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

لوحة Integrations

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

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

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

Export Project to GitHub

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

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

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

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

## المزامنة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

كل شيء متزامن

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

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

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

تعارض

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

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

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

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

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

**2. أكّد**

انقر على **Confirm**. الملاحظة المتعلقة بالاشتراك لا تمنعك من ربط المشروع مرة أخرى.

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

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

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

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

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

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

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

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

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

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


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