الانتقال إلى المحتوى الرئيسي
اعمل على مشروع من جهاز الكمبيوتر الخاص بك باستخدام Git. لا تنتقل التغييرات إلا عند تشغيل git pull أو git push.
يجب على المسؤول تفعيل تكامل Git أولًا.

إنشاء رمز

يسجّل Git الدخول باستخدام رمز مصادقة Git، وليس بكلمة مرور حسابك.
1

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

انقر على Account، ثم Account settings. ضمن Git integration، انقر على Generate token. بعد أن يصبح لديك رمز، يصبح اسم هذا الزر Add another token.
قسم Git integration في إعدادات الحساب مع زر Generate token

تكامل Git في إعدادات الحساب

2

انسخ الرمز

انقر على Copy واحفظ الرمز في مكان آمن. لن تراه إلا مرة واحدة. ثم انقر على Close.
مربع حوار رمز مصادقة Git مع زر Copy

رمزك الجديد

3

تحقّق من الرمز

تعرض القائمة الآن بداية الرمز، ووقت إنشائه، وآخر وقت استُخدم فيه. تنتهي صلاحيته بعد سنة واحدة. يمكنك امتلاك ما يصل إلى 10 رموز.
قائمة الرموز وفيها رمز واحد

رموزك

استنساخ مشروع

1

افتح تكامل Git في المحرر

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

لوحة Integrations

2

انسخ الأمر

يعرض مربع الحوار Clone with Git الأمر، مع عنوان موقعك ومعرّف المشروع. انقر على Copy. إذا لم يكن لديك رمز بعد، يفتح Go to settings إعدادات حسابك في علامة تبويب جديدة.
مربع الحوار Clone with Git مع الأمر git clone

أمر الاستنساخ

3

شغّله

الصق الأمر في الطرفية. عندما يطلب Git كلمة مرور، الصق رمزك.
يحتوي الآن مجلد يحمل اسم معرّف المشروع على ملفات المشروع، على الفرع main. لاختيار اسم المجلد، أضفه في نهاية الأمر.
يطلب Git الرمز في كل مرة يتصل فيها بالموقع. لكي يتذكّره، فعّل credential helper: يطلبه Git مرة أخرى، ثم يحتفظ بالرمز. يحفظ الـ helper ‏store الرمز دون تشفير في ~/.git-credentials.

سحب التغييرات من المحرر

داخل المجلد، شغّل:
يسرد Git الملفات التي تغيّرت. تصل التغييرات التي أُجريت في المحرر على شكل commits باسم Update on Overleaf..

دفع تغييراتك

نفّذ commit لتغييراتك، ثم ادفعها:
يعرض السطر الأخير من المخرجات الفرع الذي تقدّم:
تظهر التغييرات في المحرر، ويتحدّث المحرر المفتوح من تلقاء نفسه. تظهر الملفات والمجلدات الجديدة وعمليات إعادة التسمية في شجرة الملفات. في History، يُوسَم تغييرك بـ You (via Git). لا تظهر رسالة الـ commit هناك.
سجل المشروع يعرض السطر المدفوع، موسومًا بـ You (via Git)

عملية push في سجل المشروع

إذا رفض Git عملية الدفع

إذا تغيّر المشروع في هذه الأثناء، يرفض Git عملية الدفع:
اجلب تلك التغييرات أولًا، ثم ادفع مرة أخرى:
قد يتوقف git pull العادي بالرسالة fatal: Need to specify how to reconcile divergent branches. يعالج الخيار --no-rebase أعلاه ذلك: فهو يدمج الجانبين. إذا تغيّرت الأسطر نفسها في الجانبين، يتوقف pull بالرسالة CONFLICT (content): Merge conflict in main.tex. أصلح الملف، ثم شغّل:
هناك أمران لا يقبلهما الموقع:
  • الفروع الأخرى: ! [remote rejected] feature -> feature (wrong branch). لا يوجد سوى main، لذا ادفع عملك إليه.
  • الدفع القسري: ! [remote rejected] main -> main (forced push prohibited). بدلًا من ذلك، ضع تغييراتك فوق main الحالي.

إذا أظهر Git الرسالة Authentication failed

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

حذف رمز

في Account settings، ضمن Git integration، انقر على أيقونة الحذف بجوار الرمز، ثم Delete في مربع الحوار. منذ ذلك الحين، يرد Git على هذا الرمز بـ Authentication failed.
مربع الحوار Delete Authentication token

حذف رمز

لمعرفة ما يمكن للمتعاونين ذوي صلاحية القراءة فقط فعله، راجع قسم Q&A في تكامل Git.
آخر تعديل في ٢٠ نوفمبر ٢٠٢٦