كيفية رفع مشروع إلى Github كمبتدئ

أي مطور أو محترف مرتبط بالعالم التكنولوجي يعرف ما هو جيت هابومع ذلك، ليس كل شخص يتقن عملية رفع مشروع إلى Github والاستفادة الكاملة من إمكانات التحكم في الإصدارات والتعاون الجماعي والرؤية المهنية التي توفرها هذه المنصة.

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

ما هو المستودع ولماذا نستضيفه على GitHub؟

Un مستودع إنها المساحة الافتراضية التي تُخزَّن فيها ملفات ومجلدات مشروعك، بالإضافة إلى سجل التغييرات التي تطرأ عليها أثناء تقدمك في تطويرها. يسمح لك هذا السجل إدارة الإصدارات، والعودة إلى الحالات السابقة، والتعاون مع الآخرين، والاحتفاظ بسجل واضح لتقدم عملك..

استضافة مستودع على جيت هاب له مزايا متعددة:

• التحكم في الإصدار: سيتم تسجيل التغييرات التي أجريتها ويمكنك التراجع عنها أو مراجعتها أو مشاركتها مع أي جزء من التطوير.
• النسخ الاحتياطي السحابي: تتجنب فقدان المعلومات المهمة في حالة وقوع أي حادث محلي.
• الظهور المهني: نظرًا لكون أعمالك عامة، يمكن لأي شخص رؤية أعمالك، مما يعزز من قيمة محفظتك.
• تعاون بسيط: يجعل GitHub من السهل على الآخرين المساهمة في مشروعك من خلال طلبات السحب أو المشكلات أو الشوكات.

البدء: المتطلبات الأساسية وإعداد البيئة

قبل تحميل أي مشروع إلى Github، تأكد من تثبيت ما يلي على جهاز الكمبيوتر الخاص بك:

• حساب على GitHub. من الضروري إنشاء مستودعات على المنصة.
• تم تثبيت Git. إنها أداة التحكم الأساسية في الإصدارات التي تتيح لك إدارة التغييرات. يمكنك تنزيلها وتثبيتها من موقعها. الموقع الرسمي. في الأنظمة المستندة إلى Linux، يمكنك إجراء التثبيت عن طريق تشغيل الأمر sudo apt-get install git في المحطة.
• محرر الكود أو IDE. خيارات مثل Visual Studio Code (VSCode) لتسهيل العملية. للاستفادة من التكامل المباشر مع GitHub من المحرر، يُنصح بتنزيل إحدى هذه الأدوات.

بعد التثبيت جيت على نظامك، الخطوة الأولى هي تكوينه باستخدام الاسم والبريد الإلكتروني (سيتم استخدام هذه البيانات لتوقيع التزاماتك.) من المحطة الطرفية، قم بتشغيل الأمر التالي:

git config --global user.name "TuNombre"
git config --global user.email [email protected]

هذا التكوين هو عالمي وسوف يتعين عليك القيام بذلك مرة واحدة فقط مع فريقك.

إنشاء المستودع على GitHub

الآن حان وقت إنشاء المساحة التي ستستضيف مشروعك فيها. يمكنك القيام بذلك من خلال واجهة GitHub الإلكترونية باتباع الخطوات التالية:

1. يمكنك الوصول إلى ملفك الشخصي في GitHub.com واضغط على الزر "جديد" لإنشاء مستودع جديد.
2. ادخل اسم مطلوب للمستودع ويضيف وصف مختصرة ولكن محددة حول غرض المشروع.
3. اختر ما إذا كان المستودع سيكون عام أو خاصإذا كنت تريد أن يتمكن الآخرون من العرض والمشاركة، حدد "عام".
4. لديك خيار إنشاء ملف ملف README.md تلقائيًا. يوصى بهذا الملف، لأنه أول شيء يراه المطورون الآخرون عند وصولهم إلى المستودع.
5. انقر على "إنشاء مستودع" لإكمال العملية وسيكون مستودعك جاهزًا لاستقبال الملفات.

تحضير مشروعك المحلي للتحميل إلى GitHub

بعد إنشاء مستودعك، الخطوة التالية لرفع مشروعك إلى GitHub هي تجهيز مجلد المشروع على جهاز الكمبيوتر. للقيام بذلك، اتبع هذه التعليمات في الطرفية، مع تحديد المسار الصحيح أولًا. cd:

cd tu-carpeta-del-proyecto

الآن قم بتهيئة مستودع Git المحلي:

git init

سيؤدي هذا إلى إنشاء مجلد مخفي يسمى .git الذي يخزن سجل الإصدارات والملفات الداخلية الأخرى.

 

تحميل الكود إلى GitHub: العملية الكاملة في المحطة الطرفية

بمجرد تهيئة المستودع المحلي، سنقوم بتحميل كل المحتوى إلى GitHub عن طريق تشغيل هذه الأوامر:

1. إضافة جميع الملفات إلى منطقة التجهيز مع:

git add .

2. إجراء التزام لتسجيل نقطة التفتيش الأولى:

git commit -m "Primer commit"

3. ربط المستودع المحلي بالمستودع البعيد. يستبدل NOMBRE_USUARIO y NOMBRE_REPOSITORIO حسب البيانات الحقيقية:

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. تحميل التغييرات إلى GitHub (فرع main o master حسب الاقتضاء):

git push -u origin main

في بعض المستودعات أو التكوينات القديمة، الفرع الرئيسي هو master بدلاً من mainإذا حصلت على أخطاء، تحقق من اسم الفرع الرئيسي واستبدله في الأمر أعلاه.

كيفية تحميل المشاريع إلى Github من VSCode

المحررين المعاصرين مثل VSCode تتميز هذه التطبيقات بالتكامل الأصلي مع Git وGitHub. إليك كيفية القيام بذلك بسهولة:

• افتح مجلد المشروع الخاص بك في المحرر ("ملف → فتح المجلد").
• الوصول إلى اللوحة التحكم في المصدر (التحكم في الكود المصدر) الموجود في الشريط الجانبي.
• انقر على "تهيئة المستودع" إذا لم تكن قد فعلت ذلك بالفعل. هذا يُعادل الأمر git init.
• بمجرد التهيئة، سوف ترى زرًا لـ "نشر على GitHub"إذا كانت هذه هي المرة الأولى لك، فسوف تحتاج إلى تفويض الاتصال بين VSCode وحساب GitHub الخاص بك.
• اختر نشر المستودع كعام أو خاص.
• قم بإعداد الملفات للالتزام الأول عن طريق تحديد التغييرات وإضافة رسالة وصفية.
• قم بنشر مشروعك ويمكنك مزامنة التغييرات من المحرر بسهولة.

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

تحميل الملفات يدويًا من موقع GitHub

هناك بديل آخر، خاصة للمشاريع الصغيرة، وهو تحميل الملفات يدويًا من واجهة الويب:

1. قم بالدخول إلى المستودع الذي تم إنشاؤه حديثًا على GitHub.
2. انقر على القائمة المنسدلة "إضافة ملف" ثم حدد تحميل الملفات.
3. اسحب وأفلِت الملفات أو المجلدات من جهاز الكمبيوتر الخاص بك إلى نافذة المتصفح.
4. في الأسفل، أضف رسالة تأكيد وانقر على الالتزام بالتغييرات لتحميل الملفات.

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

الإدارة المتقدمة وأفضل الممارسات عند العمل مع GitHub

تحميل مشروع ما هو إلا البداية. لتحقيق أقصى استفادة من GitHub والحفاظ على تنظيم احترافي، نوصي باتباع أفضل الممارسات الإضافية التالية:

• حافظ على تحديث ملف README.md. هذه هي رسالة الغلاف لمشروعك. تشرح غرضه، وكيفية تثبيته، وكيفية استخدامه، وأي تفاصيل ذات صلة. يمكنك تعديلها مباشرةً عبر الإنترنت أو من خلال محرر النصوص الخاص بك باستخدام صيغة Markdown.
• إنشاء فروع العمل. لا تُجرِ جميع تغييراتك في "الرئيسي" أو "الرئيسي". استخدم فروعًا منفصلة للميزات الجديدة أو الإصلاحات. يمكنك دمجها لاحقًا باستخدام طلبات السحب.
• تحميل ملفات .gitignore لتجنب مشاركة البيانات الحساسة أو التي يتم إنشاؤها تلقائيًا، مثل مجلدات node_modules أو الملفات المؤقتة أو ملفات التكوين المحلية.
• قم بمزامنة مستودعاتك المحلية والبعيدة بشكل دوري. يستخدم git pull للحفاظ على نسختك المحلية محدثة بأي تغييرات قد أجراها المساهمون.
• إدارة أجهزة التحكم عن بعد بعناية. إذا قمت بتغيير المصدر البعيد، استخدم git remote -v لمراجعة المستودعات المرتبطة و git remote remove origin لإزالتها إذا لزم الأمر.

الاستنساخ والتعاون في المشاريع: الخطوة التالية

بمجرد أن يكون المستودع الخاص بك في السحابة، يمكنك استنساخه إلى أي جهاز كمبيوتر آخر باستخدام:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

سيؤدي هذا إلى إنشاء نسخة محلية من مشروعك، بما في ذلك جميع محتوياته سجل التغييراتإذا أردتَ تغيير اسم المجلد، يمكنك إضافته إلى نهاية الأمر. لمنع الأمر من إنشاء مجلد جديد ووضع الملفات مباشرةً في الدليل الحالي، أضف نقطة:

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

يعتمد التعاون مع المستخدمين الآخرين على GitHub على تعلم آلية عمل الفروع وطلبات السحب ومراجعة الأكواد البرمجية. بهذه الطريقة، ستتمكن من قبول المساهمات الخارجية والعمل كفريق واحد بطريقة منظمة وفعالة.

الأخطاء الشائعة وكيفية إصلاحها

عند تحميل مشروع، قد تواجه بعض المشاكل الشائعة. إليك أكثرها شيوعًا وكيفية حلها:

• محاولة الدفع إلى مستودع فارغ بدون فرع رئيسي- إذا تم إنشاء المستودع البعيد بدون ملف README.md ولم يتم دفع أي فرع مطلقًا، فتأكد من دفع الفرع الأول بالاسم الصحيح، عادةً "main" أو "master".
• تعارضات المزامنة:عندما تكون هناك تغييرات متزامنة محليًا وعن بُعد، قم بحلها عن طريق القيام أولاً بـ git pull وحل النزاعات قبل القيام بها git push مرة أخرى.
• عدد التصاريح غير كافٍ:تأكد من أن لديك بيانات الاعتماد الصحيحة وتحقق من كتابة عنوان URL البعيد بشكل صحيح (https أو ssh حسب الاقتضاء).
• نسيان إضافة الملفات المهمة:مراجعة ملفك وتحديثه .gitignore حتى لا يتم فقدان الملفات الرئيسية أو تحميل معلومات خاصة عن طريق الخطأ.

إن تحميل مشروعك إلى GitHub يعد بمثابة تغيير جذري لسير عملك: حيث يمكنك دائمًا استرداد الإصدارات السابقة والتعاون وعرض عملك للعالم.