> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ar/qaadh-almarfh/044-github-synchronization.md).

# مزامنة GitHub

**مزامنة GitHub** هي [ميزة مدفوعة](/latex/ar/qaadh-almarfh/120-overleaf-premium-features.md). تتوفر ميزات Overleaf المميزة للمشاركين في [Overleaf Commons](https://www.overleaf.com/for/universities)، وأعضاء مجموعة [الاشتراكات](https://www.overleaf.com/for/groups)، ومالكو اشتراكات فردية [الاشتراكات](https://www.overleaf.com/user/subscription/plans).

ملخص

تتيح لك ميزة مزامنة GitHub ربط مشاريع Overleaf الخاصة بك مباشرةً بمستودع GitHub يعمل كمستودع بعيد لمشروع Overleaf الخاص بك، وتوفر طريقة لدفع التغييرات وسحبها بينهما. لا يمكن استخدام مزامنة GitHub إلا على [Github.com](https://www.github.com) ولا يمكن استخدامها للاتصال بتثبيتات GitHub Enterprise الأخرى.

يمكنك مزامنة مشروع Overleaf مع مستودع GitHub إما بإنشاء مشروع Overleaf جديد من مستودع GitHub موجود، أو بإنشاء مستودع GitHub جديد من مشروع Overleaf موجود. لا يمكن مزامنة مشروع Overleaf موجود مع مستودع Github موجود.

* يتم تمكين مزامنة GitHub من خلال ربط حساب GitHub الخاص بك بحساب Overleaf الخاص بك
* يمكن إنشاء مشاريع جديدة من مستودعات GitHub الموجودة
* يمكن إنشاء مستودعات في GitHub استنادًا إلى مشاريع Overleaf الموجودة
* تُحافَظ على تزامن المشاريع والمستودعات المرتبطة باستخدام **GitHub** الخيار في **القائمة**

### ربط حساب Overleaf الخاص بك بحساب GitHub الخاص بك

من أجل استخدام ميزة مزامنة GitHub، يجب عليك ربط حساب Overleaf الخاص بك بحساب Github الخاص بك. يمكنك القيام بذلك في [إعدادات الحساب](https://www.overleaf.com/user/settings)حساب Overleaf الخاص بك. يرجى ملاحظة أن قدرة Overleaf على الاتصال ببعض المستودعات أو المؤسسات المرتبطة بحسابك قد تعتمد على إعدادات الأذونات التي تم تكوينها في GitHub.

### إنشاء مشروع Overleaf جديد من مستودع GitHub

من قائمة مشروع جديد، يمكنك اختيار خيار GitHub. سيعرض لك هذا قائمة بالمستودعات المرئية لـ Overleaf عبر حساب GitHub الخاص بك، استنادًا إلى إعدادات الأذونات الخاصة بك في GitHub.

![إنشاء جديد github.png](/files/b2d5a137e9cbc82dad150d72a57e4728f6626775)

بعض الأمور التي يجب ملاحظتها عند إنشاء مشروع Overleaf جديد من مستودع GitHub موجود.

* توجد قيود على الحجم تُطبَّق على مشاريع Overleaf وقد تمنع استخدام مستودعات GitHub الأكبر لإنشاء مشروع. يرجى الاطلاع على [هذه الصفحة](/latex/ar/qaadh-almarfh/119-overleaf-plan-limits.md) للحصول على نظرة عامة على القيود المفروضة على حجم وعدد الملفات في مشروع Overleaf.
* لا تدعم مشاريع Overleaf الوحدات الفرعية لـ Git أو Git LFS.

### إنشاء مستودع GitHub جديد من مشروع Overleaf

من قائمة مشروع Overleaf، يمكنك اختيار GitHub كأحد خيارات المزامنة. سيمنحك هذا مربع حوار يمكنك فيه إدخال اسم مستودع GitHub جديد لمزامنته مع مشروع Overleaf الخاص بك.

![قائمة المشروع github.png](/files/a18d76050d68208b8b7432aef7b4019aabdf6645)

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

لا تتم المزامنة بين GitHub وOverleaf تلقائيًا، وتُعرض خيارات المزامنة بالنقر على **GitHub** الخيار في **القائمة**. في ذلك الوقت ستوضح نافذة GitHub المنبثقة ما إذا كانت هناك تغييرات جديدة يمكن سحبها من GitHub. ستُعرض عليك دائمًا إمكانية دفع التغييرات إلى GitHub (ملاحظة: سيظهر هذا الخيار حتى إذا كان Overleaf وGitHub محدثين).

![صورة نافذة GitHub المنبثقة](/files/5fa4df58e9a8e875392ebd7b08a2a2e8bb324440)

تُنشأ عمليات الالتزام إلى GitHub عند النقر على زر دفع تغييرات Overleaf إلى GitHub. وفي هذا الوقت يمكن إدخال رسالة التزام اختيارية.

* ستظهر التغييرات في سجل Overleaf القادمة من GitHub على أنها من تأليف مجهول.
* ستظهر التغييرات في سجل GitHub القادمة من Overleaf على أنها من تأليف مالك حساب GitHub المتصل.

### حل تعارضات الدمج

قد يحدث أنه عند إجراء تغييرات في كل من Overleaf وGithub، لا يستطيع Git تحديد كيفية دمجها تلقائيًا. على سبيل المثال، إذا غيّر أحد المتعاونين سطرًا في Overleaf وقمتَ أنت بتغيير السطر نفسه في مستودع Github، فقد لا يتمكن Overleaf من اختيار الإصدار الذي يجب الاحتفاظ به.

عندما يحدث ذلك، وبدلًا من الدمج في الفرع الرئيسي الخاص بك، فإننا ندفع فرعًا جديدًا إلى مستودعك. سيكون لهذا الفرع اسم وصفي (بما في ذلك تاريخ ووقت إنشاء الفرع)، ويحتوي على نسخة المستند في Overleaf. عندما تحاول المزامنة مع GitHub ستظهر رسالة تفيد بوجوب حل تعارض دمج.

![مربع حوار تعارض الدمج في GitHub](/files/c13f6c57fa74cbaae82a4b3b296be7f1c3398c2f)

للعودة إلى حالة التزامن، تحتاج إلى دمج فرع Overleaf في فرعك الرئيسي (الافتراضي). يمكنك القيام بذلك على جهاز الكمبيوتر الخاص بك عن طريق سحب الفرعين ودمجهما باستخدام git أو أي أداة أخرى، ثم دفع النتيجة مرة أخرى إلى Github. أو يمكنك إجراء الدمج مباشرةً على Github عن طريق إنشاء طلب سحب من فرع Overleaf واستخدام ميزة حل التعارض لديهم. يتم شرح كلا النهجين في [وثائق Github](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts).

### الوصول إلى المستودعات في مؤسسات GitHub الخاصة بك

يمكنك مزامنة مشاريع Overleaf مع المستودعات المرتبطة بحساب GitHub المتصل لديك، ويمكنك أيضًا المزامنة مع المشاريع في مؤسسات GitHub التي أنت عضو فيها. ولكي تتم المزامنة مع المستودعات في مؤسسات GitHub المرتبطة بك، يجب أن تمنح تلك المؤسسات الإذن ليتم الوصول إليها بواسطة تطبيق Overleaf OAuth.

* إذا كنت عضوًا في مؤسسة، يمكنك اتباع الخطوات الموضحة [هنا](https://help.github.com/articles/requesting-organization-approval-for-oauth-apps/) لطلب وصول تطبيق Overleaf إلى مؤسستك.
* إذا كنت مالك المؤسسة، يمكنك اتباع الخطوات الموضحة [هنا](https://help.github.com/articles/approving-oauth-apps-for-your-organization/) للموافقة على تطبيق Overleaf للمؤسسة.

### حدود ملفات مزامنة GitHub

تخضع مشاريع Overleaf لقيود على الحجم الفردي، وكذلك لقيود على العدد الإجمالي للملفات في المشروع كما هو مذكور [هنا](/latex/ar/qaadh-almarfh/119-overleaf-plan-limits.md). وبينما يمكن لـ Git نفسه التعامل مع التزام واحد يغيّر آلاف الملفات، فإن واجهة GitHub API المستخدمة بواسطة ميزة مزامنة GitHub في Overleaf تفرض أيضًا قيودًا على عدد الملفات التي يمكن دفعها أو سحبها. يُنصح بالحد من عدد الملفات في كل التزام فردي إلى أقل من 100 ملف، وإجمالي حجم المشروع إلى أقل من 100 ميغابايت عند استخدام مزامنة GitHub. قد تعمل المشاريع الأكبر من هذه الأحجام، لكننا نوصي بالبقاء ضمن هذه الحدود لتجنب مشكلات المزامنة المحتملة.

### فصل مشروع عن مستودع

على الرغم من أنه يمكن إنشاء عدة مشاريع من مستودع GitHub موجود واحد، **فإنه لا يمكن تغيير المستودع المرتبط بمشروع معين**. بمجرد ربط مشروع بمستودع، لا يمكن إلغاء الربط به واستخدامه لإنشاء مستودع جديد. إذا كنت بحاجة إلى إنشاء مستودع جديد من مشروع معين، فعليك إنشاء نسخة جديدة من المشروع أولًا، ثم إنشاء المستودع الجديد من تلك النسخة.

### القيود المعروفة

**الفروع**: لا يدعم نظام Git في Overleaf إنشاء الفروع.

**الروابط الرمزية**: نظام Overleaf Git لا يتعامل مع الروابط الرمزية. يمكن دفع رابط رمزي إلى مشروع Overleaf، لكنه سيُحوَّل إلى ملف عادي، وسيستبدل الرابط الرمزي المحلي في المرة التالية التي يُسحب فيها المشروع.

**أذونات الملفات**: نظام Overleaf Git لا يحافظ على أذونات التنفيذ. عند العمل مع مزامنة GitHub، إذا تمت مزامنة أي ملفات تحمل بت التنفيذ في GitHub إلى Overleaf، فسيتم تشغيل التزام تلقائي بواسطة Overleaf لإعادة تعيين أذونات الملفات.

**Git LFS**: لا تدعم مشاريع Overleaf التخزين الكبير للملفات في Git.

**الوحدات الفرعية لـ Git**: يمكن أن تعمل مشاريع Overleaf كوحدات فرعية لـ Git داخل مستودعات أخرى، لكنها لا يمكن أن تحتوي على وحدات فرعية أخرى لـ Git. وللإشارة إلى الملفات من مشاريع أخرى، يُقترح استخدام ميزة الإضافة من مشروع آخر.

**تتبّع التغييرات والتعليقات**: للأسف، قد تؤدي عمليات السحب من GitHub إلى Overleaf إلى فقدان أو إزاحة التغييرات المتعقبة والتعليقات؛ وبالتالي، لا نوصي بدمج العمل النشط في GitHub مع استخدام التغييرات المتعقبة و/أو التعليقات.

**المزامنة المباشرة مع GitHub Enterprise أو GitLab:** يمكن لواجهة GitHub API المستخدمة بواسطة Overleaf الاتصال فقط بالمستودعات المستضافة على github.com. يمكنك المزامنة بشكل غير مباشر مع المشاريع المستضافة لدى مزودين آخرين باستخدام [تكامل Overleaf مع Git](/latex/ar/qaadh-almarfh/040-git-integration.md) من Overleaf.

**ربط مشروع موجود بمستودع موجود**: لا يمكن مزامنة مشروع Overleaf موجود مع مستودع Github موجود.

**نِسبة الإسناد لعمليات الدفع إلى GitHub**: مستخدم Github الوحيد الذي يعرفه Overleaf هو المستخدم الذي تم ربط حساب GitHub الخاص به بحساب Overleaf ويملك ذلك المشروع. تُجرى جميع عمليات الالتزام باستخدام واجهة GitHub API التي تنفذ هذه الالتزامات صراحةً باستخدام هوية ذلك المستخدم. لذا ستظهر جميع عمليات الالتزام في سجل GitHub على أنها صادرة من المستخدم المرتبط. وفي سجل Overleaf، ستظهر التغييرات على أنها "مجهول (عبر GitHub)".

**سجل Git وسجل Overleaf:** التغييرات في جانب Overleaf لا تملك تطابقًا واحدًا لواحد مع عمليات الالتزام في GitHub. يمكن لعدة مستخدمين إجراء تغييرات في جانب Overleaf، لكن هذه التغييرات ستُجمَّع كالتزام واحد تحت المستخدم المتصل بـ GitHub عند تشغيل المزامنة.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ar/qaadh-almarfh/044-github-synchronization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.