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

دليل شامل للمطورين المبتدئين والمحترفين

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

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

لماذا يجب عليك رفع مشروعك على GitHub؟

التحكم في الإصدارات والتعاون

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

بالإضافة إلى ذلك، يُسهل GitHub التعاون بين فريق المطورين. يمكن لعدة أشخاص العمل على نفس المشروع في وقت واحد دون تداخل، وذلك بفضل ميزات الفروع (Branches) وعمليات الدمج (Merges). يمكن للمطورين مراجعة كود بعضهم البعض، وتقديم اقتراحات، وتصحيح الأخطاء بكفاءة عالية، مما يعزز جودة المنتج النهائي ويسرع عملية التطوير.

النسخ الاحتياطي والمحفظة الشخصية

يعمل GitHub كخدمة نسخ احتياطي ممتازة لمشاريعك. حتى إذا حدث خطأ ما لجهاز الكمبيوتر الخاص بك، فإن الكود الخاص بك سيكون آمنًا ومتاحًا على السحابة. هذه الميزة توفر راحة بال كبيرة للمطورين. كما أن GitHub يُعد بمثابة محفظة شخصية (Portfolio) لمشاريعك. يمكن لأصحاب العمل المحتملين مراجعة الكود الخاص بك، والاطلاع على جودة عملك، وفهم مهاراتك بشكل أفضل.

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

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

إنشاء حساب GitHub

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

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

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

للتفاعل مع GitHub من جهاز الكمبيوتر الخاص بك، ستحتاج إلى تثبيت Git. Git هو نظام تحكم في الإصدارات الموزع الذي يتيح لك تتبع التغييرات في ملفات مشروعك. لـ Windows، يمكنك تنزيل مثبت Git من (git-scm.com/downloads) واتباع التعليمات. لـ macOS، يمكنك تثبيت Git عبر Homebrew أو Xcode Command Line Tools.

بالنسبة لأنظمة Linux، يمكن تثبيت Git عادةً من خلال مدير الحزم الخاص بتوزيعتك (مثل `sudo apt install git` لأوبونتو). بعد التثبيت، افتح الطرفية أو موجه الأوامر وتحقق من التثبيت بكتابة `git –version`. يجب أن يعرض هذا الأمر إصدار Git المثبت على جهازك، مما يؤكد نجاح العملية.

الطريقة الأولى: رفع مشروع باستخدام واجهة المستخدم الرسومية (GitHub Desktop)

تثبيت GitHub Desktop

GitHub Desktop هو تطبيق مجاني يتيح لك التفاعل مع مستودعات GitHub باستخدام واجهة رسومية سهلة الاستخدام، بدلاً من سطر الأوامر. يمكنك تنزيله من (desktop.github.com). بعد التنزيل، قم بتثبيت التطبيق باتباع الإرشادات على الشاشة. عند الفتح لأول مرة، سيُطلب منك تسجيل الدخول باستخدام حساب GitHub الخاص بك.

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

إنشاء مستودع جديد

افتح GitHub Desktop، ثم انقر على “File” في القائمة العلوية، ثم “New Repository…”. سيُطلب منك إدخال اسم للمستودع (Repository Name)، وهو عادةً اسم مشروعك. يمكنك أيضًا إضافة وصف اختياري (Description)، وتحديد مسار محلي حيث سيتم تخزين المشروع على جهازك (Local Path).

تأكد من اختيار المسار الصحيح حيث توجد ملفات مشروعك أو حيث تريد إنشاء مشروع جديد. يمكنك أيضًا اختيار تهيئة المستودع بملف README وملف .gitignore. بعد إدخال التفاصيل، انقر على زر “Create Repository” لإنشاء المستودع المحلي على جهازك.

إضافة مشروع موجود

إذا كان لديك مشروع موجود على جهازك وترغب في رفعه إلى GitHub، فبعد إنشاء المستودع المحلي في الخطوة السابقة، قم بنسخ جميع ملفات مشروعك ولصقها داخل مجلد المستودع الذي أنشأته GitHub Desktop. سيقوم التطبيق تلقائيًا باكتشاف هذه الملفات كـ “تغييرات” (Changes) تحتاج إلى الالتزام بها.

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

الالتزام بالدفع (Commit and Push)

بعد إضافة ملفات مشروعك أو إجراء تغييرات، ستظهر هذه التغييرات في نافذة GitHub Desktop. في الجانب الأيسر السفلي، اكتب رسالة التزام (Commit Message) قصيرة ومفيدة تصف التغييرات التي قمت بها (مثال: “Initial commit” أو “Add project files”). يمكنك أيضًا إضافة وصف أطول إذا لزم الأمر.

انقر على زر “Commit to main” (أو اسم الفرع الحالي). بعد الالتزام، انقر على زر “Publish Repository” (أو “Push origin” إذا كان المستودع موجودًا بالفعل على GitHub). سيقوم هذا الإجراء برفع مشروعك من جهازك المحلي إلى GitHub، وجعله متاحًا على الإنترنت.

الطريقة الثانية: رفع مشروع باستخدام سطر الأوامر (CLI)

إنشاء مستودع جديد على GitHub (عبر الويب)

قبل استخدام سطر الأوامر، يُفضل غالبًا إنشاء المستودع الفارغ على GitHub أولاً. قم بتسجيل الدخول إلى حسابك على GitHub، ثم انقر على زر “+” في الزاوية العلوية اليمنى، واختر “New repository”. أدخل اسمًا للمستودع (Repository Name)، وأضف وصفًا اختياريًا. يمكنك اختيار “Public” ليكون متاحًا للجميع، أو “Private” للوصول الخاص.

من الأفضل عدم تهيئة المستودع بملف README أو .gitignore أو ترخيص في هذه المرحلة، حيث سنقوم بإضافتها محليًا. انقر على “Create repository”. بعد الإنشاء، سيعرض GitHub لك بعض الأوامر التي يمكنك استخدامها لربط مشروعك المحلي بالمستودع الجديد. ستحتاج إلى نسخ رابط المستودع البعيد (URL)، والذي سيكون شيئًا مثل `https://github.com/your-username/your-repo-name.git`.

تهيئة Git في المشروع المحلي

افتح الطرفية (Terminal) أو موجه الأوامر (Command Prompt) وانتقل إلى دليل مشروعك المحلي باستخدام الأمر `cd`. على سبيل المثال: `cd /path/to/your/project`. بمجرد دخولك إلى مجلد المشروع، قم بتهيئة Git فيه باستخدام الأمر: `git init`. هذا الأمر سينشئ مجلد `.git` مخفيًا في مشروعك، والذي يحتوي على جميع معلومات التحكم في الإصدار.

بعد تهيئة Git، قم بتكوين اسم المستخدم والبريد الإلكتروني الخاصين بك لـ Git، وهما ضروريان لتحديد من قام بالالتزامات:
`git config user.name “Your Name”`
`git config user.email “your.email@example.com”`
تأكد من استخدام نفس الاسم والبريد الإلكتروني المرتبطين بحساب GitHub الخاص بك.

إضافة الملفات والتزام التغييرات

الآن، تحتاج إلى إضافة ملفات مشروعك إلى منطقة التدريج (Staging Area) في Git. يمكنك إضافة جميع الملفات في المجلد الحالي باستخدام الأمر: `git add .` (النقطة تعني جميع الملفات والتغييرات). إذا كنت ترغب في إضافة ملفات محددة فقط، يمكنك استخدام `git add filename.ext`.

بعد إضافة الملفات، حان وقت الالتزام بهذه التغييرات (Commit). الالتزام هو لقطة للمشروع في نقطة زمنية معينة. استخدم الأمر: `git commit -m “Initial project setup”` (استبدل الرسالة بوصف مفيد لالتزامك). هذه الرسالة مهمة لتتبع التغييرات في المستقبل.

ربط المستودع المحلي بالمستودع البعيد

الآن بعد أن أصبح لديك التزام محلي، تحتاج إلى ربط هذا المستودع المحلي بالمستودع الفارغ الذي أنشأته على GitHub. استخدم الأمر التالي، مع استبدال `your-repo-url` برابط المستودع البعيد الذي نسخته من GitHub:
`git remote add origin your-repo-url`
على سبيل المثال:
`git remote add origin https://github.com/your-username/your-repo-name.git`
`origin` هو الاسم الافتراضي الذي يُطلق على المستودع البعيد الرئيسي.

دفع التغييرات إلى GitHub

أخيرًا، حان وقت دفع (Push) التغييرات من المستودع المحلي إلى المستودع البعيد على GitHub. استخدم الأمر:
`git push -u origin main`
(إذا كان الفرع الرئيسي لمشروعك يسمى `master` بدلاً من `main`، فاستخدم `git push -u origin master`).
` -u` تعين فرع `main` المحلي لتتبع فرع `main` البعيد.

قد يطلب منك Git إدخال اسم المستخدم وكلمة المرور الخاصة بحساب GitHub الخاص بك (أو رمز الوصول الشخصي إذا كنت تستخدم المصادقة الثنائية). بعد إدخال البيانات الصحيحة، سيتم رفع جميع ملفات مشروعك إلى GitHub، وستصبح متاحة على الإنترنت. يمكنك الآن زيارة صفحة المستودع على GitHub للتأكد من رفع الملفات بنجاح.

نصائح إضافية لرفع مشروع احترافي

استخدام ملف .gitignore

ملف `.gitignore` هو ملف نصي بسيط يخبر Git أي الملفات أو المجلدات يجب تجاهلها وعدم تضمينها في نظام التحكم في الإصدار. هذا مهم جدًا لتجنب رفع ملفات غير ضرورية أو حساسة مثل مجلدات التبعيات (مثل `node_modules`)، ملفات التكوين المحلية، ملفات السجل، أو أي بيانات شخصية.

لإنشاء ملف `.gitignore`، قم بإنشاء ملف جديد في الجذر الرئيسي لمشروعك وسمّه `.gitignore`. ثم أضف أسماء الملفات أو أنماط المجلدات التي تريد تجاهلها، كل واحد في سطر جديد. على سبيل المثال:
`node_modules/`
`.log`
`.env`
`.DS_Store`
هذا يساعد في الحفاظ على مستودعك نظيفًا ومنظمًا.

كتابة ملف README.md فعال

ملف `README.md` هو أول ما يراه الأشخاص عند زيارة مستودعك على GitHub. إنه يقدم وصفًا لمشروعك، ويوضح كيفية تثبيته وتشغيله، ويوفر أي تعليمات ضرورية أخرى. يعتبر ملف README جيد أمرًا بالغ الأهمية لجذب المساهمين، ولتسهيل فهم مشروعك من قبل الآخرين، وكمرجع سريع لك شخصيًا.

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

التعاون وفروع Git

عند العمل ضمن فريق أو على ميزات جديدة، تُعد الفروع (Branches) في Git أداة قوية. يتيح لك الفرع تطوير ميزة جديدة أو إصلاح خطأ في بيئة معزولة دون التأثير على الكود الرئيسي للمشروع. بعد الانتهاء، يمكنك دمج (Merge) التغييرات مرة أخرى في الفرع الرئيسي.

لبدء العمل على فرع جديد، استخدم `git branch new-feature` ثم `git checkout new-feature`. بعد الانتهاء من العمل في الفرع، يمكنك دفعه إلى GitHub باستخدام `git push origin new-feature`، ثم فتح طلب سحب (Pull Request) لدمجه في الفرع الرئيسي. هذه الممارسة تعزز التعاون المنظم وتجنب المشاكل المحتملة في الكود.