مستودعاتك المحلية هي نسخة كاملة من المشاريع الموجودة على GitHub، ما يتيح لك حفظ التغييرات محليًا متى ما لزم الأمر. عند العمل محليًا، يمكنك إجراء تغييرات على مئات الملفات دفعةً واحدة، ثم حفظها جميعًا مرةً واحدة (commit).
ستلاحظ حدوث تغييرات عند ظهور رقم على أيقونة زر التحكم في المصدر.
انقر فوق التحكم بالمصدر.
في لوحة التحكم بالمصدر، سترى قائمة بالملفات المُعدَّلة. مرِّر مؤشر الماوس فوقها وانقر على زر “تغييرات المرحلة” الذي يظهر.
بعد أن تُعدّل تغييراتك، أدخل رسالة تأكيد وانقر على زر “تأكيد”. ستُضاف تغييراتك إلى مستودعك المحلي.
لنقل تغييراتك إلى مستودع GitHub البعيد، انقر على زر “مزامنة التغييرات” الذي يظهر عند وجود تغييرات جديدة. سيؤدي هذا إلى سحب ودفع أي تغييرات بين نسختي المشروع المحلية والبعيدة.
يمكنك التأكد من أن التزاماتك قد تم إرسالها بشكل صحيح عن طريق فتح صفحة Urantiapedia GitHub الخاصة بك.
مشروع يورانتيابيديا هو النسخة التطويرية والعملية للمحتوى. يحتوي مشروع يورانتيابيديا-باك أب على المحتوى فقط، وهو متزامن مع الموقع الإلكتروني، لذا فإن إدخال تغييرات عليه يعادل إجراء تغييرات جذرية عليه، شريطة أن يُدخلها المسؤولون أو أن يقبلوها من خلال طلب تغيير.
إذا كانت التغييرات التي أجريتها على مشروع Urantiapedia تتضمن تغييرات على المحتوى (مجلد /output/wikijs)، فيجب عليك مزامنة هذه التغييرات مع مشروع Urantiapedia-backup باستخدام أي أداة مساعدة للمزامنة أو ببساطة عن طريق النسخ واللصق بين المجلدات.
يمكن أن يكون تكرار كلا المشروعين أمرًا مرهقًا بعض الشيء، ولكن تم تصميمه بهذه الطريقة لأسباب أمنية.
بمجرد حصولك على عدد كافٍ من الالتزامات المرسلة إلى نسخك الخاصة من مشاريع يورانتيابيديا (النسخ المتفرعة)، يمكنك إرسال طلبات سحب إلى المشاريع الأصلية لمراجعة التغييرات ودمجها فيها. يُسمى هذا طلب سحب في مصطلحات GitHub.
افتح كل صفحات Urantiapedia على GitHub.
https://github.com/<username>/urantiapedia
https://github.com/<username>/urantiapedia-backup
تأكد من أنك تستخدم الفرع الرئيسي (master). يظهر الفرع في قائمة أعلى قائمة الملفات. عادةً ما يكون هذا الفرع هو الوحيد المتاح لك.
اختر قائمة “المساهمة” أدناه، ثم اختر “فتح طلب سحب”. إذا كانت القائمة تشير إلى “هذا الفرع ليس متقدمًا على الفرع الرئيسي”، فيجب عليك أولًا جلب المشروع الرئيسي. انظر أدناه.
أضف عنوانًا لمساهماتك. يمكنك أيضًا إضافة وصف.
انقر فوق “إنشاء طلب سحب”. أنشئ طلب سحب لكل مشروع تُجري عليه تغييرات.
سيؤدي هذا إلى إرسال إشعار إلى مسؤولي المشروع الذين سيدمجون تغييراتك إذا لم يجدوا أي مشكلات.
بما أن Urantiapedia عمل جماعي، فمن الشائع أن تكون الروابط الخاصة بك غير متزامنة مع المشاريع الأصلية في أي وقت. يُنصح بمزامنة الروابط الخاصة بك مع المشاريع الأصلية قبل أي طلب سحب.
افتح أيًا من مشاريع Urantiapedia الخاصة بك على GitHub.
انقر على خيار “مزامنة التفرع”. ستظهر لك قائمة توضح عدد الالتزامات التي أُجريت على المشروع الأصلي والتي ليست موجودة في نسختك. في الصورة، يمكنك رؤية ٤ التزامات غير موجودة لدينا، وبالتالي فإن نسختنا قديمة (هذا الفرع قديم). ما عليك سوى النقر على “تحديث الفرع” لنقل التغييرات من المشروع الأصلي إلى نسختك.
انتظر بضع ثوانٍ بينما يُحدّث GitHub نسختك. عند الانتهاء، إذا نقرت على خيار Sync fork مرة أخرى، فسترى أن كل شيء مُحدّث الآن، مما يُشير إلى أن التغييرات ليست متأخرة عن النسخة الأصلية (هذا الفرع ليس متأخرًا عن النسخة الأصلية).
انتقل إلى VS Code.
افتح المشروع كما تم شرحه بالفعل.
في لوحة تحكم المصدر، انتقل إلى اللوحة الفرعية الالتزامات. انقر على زر جلب البيانات الصغير، ثم زر سحب البيانات المجاور له. يؤدي هذا الإجراء إلى جلب البيانات ودفعها في الوقت نفسه لمزامنة المستودع المحلي.
أحيانًا، تعني التغييرات في شيفرة أدوات أورانتيابيديا تغييرات في التبعيات. يجب تثبيت أو تحديث التبعيات الجديدة بتشغيل أمر npm install من نافذة طرفية في VS Code. سيؤدي هذا إلى تحديث تبعيات المشروع.
باختصار، العملية على GitHub هي كما يلي (انظر الرسم التخطيطي):
يُنشئ “رؤساء التحرير” نسخة (١) (fork) في حسابهم الخاص لمشروعي Urantiapedia على GitHub: Urantiapedia وUrantiapedia-backup. كما يُحافظون على مزامنة هذه النسخ عبر Sync fork أو Fetch upstream (١).
يُنشئ “رؤساء التحرير” نسخة محلية من المشاريع على حواسيبهم. يتم ذلك عبر عملية استنساخ (٢) في VS Code. كما يُحافظون على مزامنة هذه النسخ المحلية عبر عملي جلب وسحب في VS Code (٢)، اللذين يُنزّلان أي تغييرات على النسخة المحلية.
يقوم “رؤساء التحرير” بإجراء تغييرات على النسخة المحلية من المشاريع وإجراء التزامات (3) على نسختهم المحلية لحفظ التغييرات.
يرسل “رؤساء التحرير” تغييراتهم إلى مشاريعهم على GitHub عبر إجراءات الدفع (4).
بعد ذلك، يقوم “المحررون الرئيسيون” بإنشاء طلبات سحب (5) من موقع GitHub لكلا المشروعين: Urantiapedia وUrantiapedia-backup.
تتم مراجعة طلبات السحب هذه من “رؤساء التحرير” بواسطة “مسؤول” مسؤول عن دمج (٦) جميع التغييرات الصحيحة. سيتم رفض أي تغييرات غير صحيحة (٦) وإخطار “رؤساء التحرير” لتصحيحها.
عندما تكون التغييرات صحيحة، يؤدي الدمج في مشروع urantiapedia-backup الأصلي إلى مزامنة التغييرات تلقائيًا مع موقع الويب، والذي سيظهر محدثًا في غضون بضع دقائق. (7)