رفع و تعديل المشاريع على GitHub للمبتدئين

دليل لإنشاء ورفع المشاريع على GitHub للمبتدئين 

منصة Github

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

لكن قد يواجه المبتدئون صعوبة في فهم كيفية إستخدام Git و GitHub بشكل صحيح.

في هذا الموضوع و من خلال مدونة العرائش التقنية سوف نتعرف معًا على:

• كيفية إنشاء مستودع (Repository) جديد على GitHub.
• رفع مشروع موجود إلى GitHub بإستخدام سطر الأوامر (Command Line) و GitHub Desktop.
• إدارة التحديثات والمشاركة مع الآخرين عبر Pull Requests.
• نصائح إحترافية لتحسين تجربتك مع GitHub.

ما هو GitHub؟ ولماذا يجب أن تستخدمه؟

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

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

المتطلبات الأساسية قبل البدء في Github

قبل رفع مشروعك إلى GitHub، تحتاج إلى:

أ. إنشاء حساب على GitHub

1. إنتقل إلى GitHub.com.
2. إختر Sign Up وأدخل بياناتك.
3. إختر الخطة المناسبة (يمكنك البدء بالمجانية Free Plan).

ب. تثبيت Git على جهازك

• لينكس/ماك: غالبًا مثبّت مسبقًا (تحقق عبر git --version).
• ويندوز: نزّله من git-scm.com.

ج. تهيئة Git لأول مرة

افتح Terminal أو CMD، ثم نفّذ:

git config --global user.name "اسمك"
git config --global user.email "بريدك@example.com"

(هذه البيانات تظهر في سجل التعديلات).

كيفية إنشاء مستودع (Repository) جديد على GitHub

1. سجّل الدخول إلى GitHub.
2. إنقر على + → New Repository.
3. إملأ البيانات:
   • Repository name: إسم المشروع (مثل my-first-project).
   • Description: وصف مختصر.
   • Public/Private: إختر "Public" للمشاريع المفتوحة.
   • Initialize this repository with a README: ✓ (مهم للمبتدئين).
4. انقر Create Repository.

💡 ملاحظة: ملف README.md هو وصف مشروعك بإستخدام Markdown. كما يمكنك إضافة تعليمات التشغيل، الصور، وغيرها.

كيفية رفع مشروع موجود إلى GitHub

هناك طريقتان رئيسيتان:

الطريقة الأولى: عبر سطر الأوامر (Command Line)

1. افتح Terminal في مجلد مشروعك.
2. نفّذ الأوامر التالية بالترتيب:

git init
git add .
git commit -m "أول رفع للمشروع"
git branch -M main
git remote add origin https://github.com/اسمك/اسم-المستودع.git
git push -u origin main

شرح الأوامر:

الأمر	الوظيفة
git init	ينشئ مستودع Git محليًا في مجلد المشروع.
git add .	يُضيف جميع الملفات للتتبع (استبدل . باسم ملف معين إذا أردت).
git commit -m "..."	يحفظ التغييرات مع رسالة توضيحية.
git branch -M main	يغير إسم الفرع الرئيسي من master إلى main.
git remote add ...	يربط المشروع المحلي بالمستودع على GitHub.
git push -u ...	يرفع الملفات إلى GitHub (الـ -u تخزن الإعدادات للمرّة القادمة).

الطريقة الثانية: بإستخدام GitHub Desktop

1. نزّل التطبيق من desktop.github.com.
2. إختر File → Add Local Repository وحدد مجلد المشروع.
3. قم بكتابة رسالة Commit، ثم أنقر Publish Repository.

⚠️ تحذير: إذا كان المشروع يحتوي على ملفات حساسة (مثل كلمات سر)، إستخدم .gitignore لتجاهلها.

خطوات إدارة المشروع بعد الرفع إلى Github

أ. تحديث المشروع بعد التعديلات

عدّل الملفات، ثم نفّذ:

git add .
git commit -m "تحديث جديد"
git push

ب. التعامل مع الفروع (Branches)

• إنشاء فرع جديد:

  git checkout -b new-feature

• دمج الفرع مع main:

  git checkout main
  git merge new-feature

ج. فتح Pull Request للتعاون

1. أنقر على Pull Requests في مستودع GitHub.
2. إختر New Pull Request وقارن التغييرات.
3. أكتب وصفًا واضحًا، ثم أنقر Create Pull Request.

نصائح إحترافية لإستخدام GitHub مثل المحترفين

إستخدام .gitignore لتجاهل ملفات غير ضرورية

أنشئ ملفًا باسم .gitignore في مجلد المشروع، ثم أضف أسماء الملفات/المجلدات التي تريد تجاهلها، مثل:

node_modules/
.env
*.log

نشر موقعك مجانًا عبر GitHub Pages

1. إذهب إلى Settings → Pages.
2. إختر main كفرع للنشر.
3. إنتظر دقائق، ثم إفتح الرابط الذي يظهر.

أتمتة المهام بإستخدام GitHub Actions

مثال: أتمتة إختبارات المشروع عند كل git push:

1. أنشئ ملفًا في: .github/workflows/test.yml.
2. الصق الكود التالي (مثال لـ Node.js):

name: CI
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - run: npm install
      - run: npm test

كيف تبدأ رحلتك مع GitHub اليوم

الآن وقد تعلمت كيفية رفع مشروعك إلى GitHub، حان الوقت لتطبيق هذه الخطوات! نعم هذا سواءً كنت تعمل على:

• مشروع تعليمي (كود بسيط).
• بورتفوليو (عرض أعمالك).
• مشروع مفتوح المصدر (للمساهمة في المجتمع).

GitHub ليس فقط أداة، بل بوابة لفرص لا حصر لها في عالم البرمجة. 

كل Commit تقوم به هو خطوة نحو إحترافيتك. 🚀

💬 تحدّى نفسك: جرب رفع مشروعك الأول اليوم، وشاركنا الرابط في التعليقات!

🎯 كلمة أخيرة:

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

للأسئلة أو الإستفسارات، أترك تعليقًا وسنرد عليك قريبًا!

⇦ تابع مدونة العرائش التقنية للمزيد من الشروحات الحصرية!

🔹 هل لديك أي استفسارات؟ اكتبها في التعليقات!