GitHub: رفع مشروعك ومشاركته

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

إنشاء حساب ومستودع

  1. أنشئ حسابًا على github.com، واختر اسم مستخدم مهنيًا؛ سيظهر في روابط مشاريعك.
  2. اضغط New repository، واكتب اسم المشروع، واختر Public أو Private.
  3. بما أن مشروعك موجود على جهازك، لا تُضِف README ولا .gitignore من GitHub؛ اترك المستودع فارغًا.

مشاريع العملاء اجعلها Private دائمًا، إلا إذا سمح لك العميل بنشرها.

تسجيل الدخول من جهازك

GitHub لا يقبل كلمة مرور الحساب في الطرفية. لديك طريقتان:

  • الأسهل على Windows: مدير بيانات الاعتماد (Git Credential Manager) يأتي مع Git. في أول push يفتح المتصفح لتسجّل الدخول، ثم يتذكرك.
  • مفتاح SSH، وهو الأشيع لدى المحترفين:
ssh-keygen -t ed25519 -C "you@example.com"

اضغط Enter لقبول المكان الافتراضي، ثم انسخ محتوى الملف ~/.ssh/id_ed25519.pub وأضفه في GitHub من Settings ثم SSH and GPG keys. لا تشارك الملف الآخر الذي ليس له امتداد .pub مع أي أحد.

push و pull و clone

اربط مستودعك المحلي بـ GitHub وارفعه:

git remote add origin https://github.com/username/my-site.git
git branch -M main
git push -u origin main

بعد هذه المرة الأولى يكفي:

git push    # ارفع لقطاتك الجديدة
git pull    # اجلب ما رفعه غيرك (أو ما رفعته أنت من جهاز آخر)

ولتنزيل مشروع موجود على GitHub إلى جهاز جديد:

git clone https://github.com/username/my-site.git

ملف README يعرّف بمشروعك

ملف README.md في جذر المستودع هو أول ما يراه الزائر على GitHub. اكتب فيه:

# متجر النور

متجر إلكتروني لبيع الملابس الرياضية مع الدفع عند الاستلام.

## التقنيات
HTML، CSS، JavaScript

## التشغيل
افتح index.html في المتصفح.

## الرابط
https://username.github.io/my-site

وأضف صورة للمشروع إن استطعت؛ الصورة تقنع أكثر من الكلام.

مهمتك

أنشئ حسابك على GitHub، وارفع مشروعك، واكتب له README فيه وصف وصورة ورابط. ثم احذف المجلد من جهازك (بعد التأكد من رفعه!) واستعمل git clone لتنزيله من جديد.