كيف يمكن رفع ملفات المشروع على غيتهب ومشاركتها مع العميل؟

في الحقيقة، غيتهب ليست استضافة وانما نظام git يمكن من عليها متابعة النسخ المختلفة أو تطورات مشروع ما، بشكل يجعل من الممكن التراجع عن تعديل أو نسخة ما. وبجانب هذا يوفر طريقة لاستضافة المواقع الثابتة تدعى github-pages. 

سؤالك يتضمن أو يقصد به أحد الطريقتين: 

• مشاركة ملفات المشروع وشيفرته لتفحصها من قبل العميل. 
• مشاركة النتيجة النهائية للموقع لكي يستعرضه العميل.

أظنك تقصدين الحالة الأولى، وفي ذلك نحتاج اتباع الخطوات التالية:

1. إنشاء مستودع git في github، ويمكن ذلك عن طريق التوجه الى نافذة المستودعات repositories والضغط على زر new.
2. ستظهر استمارة يمكن من عليها تخصيص اسم المستودع، وصفه وحالته: عام أو خاص. حيث ان المستودعات العامة تظهر لأي مستخدم يتصفح حسابك في github في حين أن المستودعات الخاصة لن تظهر. اغلب العملاء يشترطون أن تكون المستودعات التي يشاركها معهم المطورون خاصة.
3. بعد تأكيد انشاء المستودع سيتم التوجيه االى صفحة المستودع، أين تظهر فارغة وموضح عليها بعض الأوامر في كيفية التعامل مع هذا المستودع. 
4. بعد انشاء المستودع والتأكد من ذلك نحتاج الآن دفع ملفات المشروع التي على حاسوبك الى هذا المستودع الموجود في github لمشاركتها مع العميل. لدفع الملفات نحتاج تنفيذ هاته الاوامر:

   نحتاج الدخول الى مجلد ملفات المشروع لتنفيذ الأوامر عليه
   cd path/to/yourProjectFolder
   
   
   تهيئة مستودع غيت محلي على ملفات المشروع 
   git init
   
   
   اضافة كامل ملفات المشروع الى المستودع
   git add .
   
   
   تنفيذ أول ايداع للمشروع بتخصيص عنوان له
   git commit -m "my first commit"
   
   
   انشاء فرع للمشروع للدفع اليه
   git branch -M main
   
   
   اضافة رابط مستودع غيت ، يرجى التأكد من استبدال رابط مستودع غيت بالرابط المثال في هذا الامر
   git remote add origin https://github.com/example-user/example-repo.git

    

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

• التوجه الى الاعدادات عن طريق الضغط على settings من القائمة المنسدلة. 
• في صفحة الاعدادات التوجه الى اعدادات المطور Developer settings اسفل القائمة الجانبية.
• الضغط على generate new token من نافذة Personal access tokens لتوليد مفتاح توثيق جديد. 
• تأكدي من تحديد تاريخ انتهاء صلاحيته، ومن تحديد كامل مربعات التحقق التي تخص الصلاحيات أسفله. ثم سيمكن تقديم طلب الانشاء. 
• سيتم بعد هذا اعطاءك مفتاح التوثيق، يرجى التأكد من حفظه بمكان آمن لأنه لن يمكن استخراجه لاحقا عن طريق github. 

الآن وأخيرا سنعود الى تنفيذ أمر الدفع الأخير على مستودع المشروع في حاسوبك الشخصي:

git push -u origin main

سيطلب منك بعد تنفيذ هذا الأمر ادخال اسم مستخدم github ثم سيطلب منك ادخال كلمة المرور. 

كلمة المرور هاهنا هي هذا الرمز الذي قمنا للتو بإنشاءه. 

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

• التأكد من ان العميل يمتلك حساب غيتهب أيضا.
• عن طريق صفحة المستودع، التوجه الى نافذة اعدادات المستودع settings.
• من القائمة الجانبية، الضغط على مشاركين collaborators للتحكم فيمن يمكنهم الوصول الى هذا المستودع. 
• الضغط على زر اضافة اشخاص add people. 
• اضافة البريد الالكتروني الذي يستخدمه العميل في غيتهب أو اسم مستخدمه على غيتهب.
• تأكيد الاضافة.

يمكنك الاستفاذة من سلسلة المقالات المنشورة حول git هنا.

اولاً قومي بإنشاء حساب github من هنا 

ثم قومي بإنشاء repo من هنا اكتبي اسم المشروع تحت Repository name ثم اضغطي على Create repository

ثم تظهر  لكي نافذة فيها مجموعة تعليمات 

نفذي التعليمات الموجودة تحت 

…or push an existing repository from the command line

نفذيها على التوالي تباعاً داخل مجلد المشروع خاصتك بواسطة موجه الأوامر

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

بتاريخ 1 ساعة قال Adnane Kadri:

في الحقيقة، غيتهب ليست استضافة وانما نظام git يمكن من عليها متابعة النسخ المختلفة أو تطورات مشروع ما، بشكل يجعل من الممكن التراجع عن تعديل أو نسخة ما. وبجانب هذا يوفر طريقة لاستضافة المواقع الثابتة تدعى github-pages. 

سؤالك يتضمن أو يقصد به أحد الطريقتين: 

• مشاركة ملفات المشروع وشيفرته لتفحصها من قبل العميل. 
• مشاركة النتيجة النهائية للموقع لكي يستعرضه العميل.

أظنك تقصدين الحالة الأولى، وفي ذلك نحتاج اتباع الخطوات التالية:

1. إنشاء مستودع git في github، ويمكن ذلك عن طريق التوجه الى نافذة المستودعات repositories والضغط على زر new.
2. ستظهر استمارة يمكن من عليها تخصيص اسم المستودع، وصفه وحالته: عام أو خاص. حيث ان المستودعات العامة تظهر لأي مستخدم يتصفح حسابك في github في حين أن المستودعات الخاصة لن تظهر. اغلب العملاء يشترطون أن تكون المستودعات التي يشاركها معهم المطورون خاصة.
3. بعد تأكيد انشاء المستودع سيتم التوجيه االى صفحة المستودع، أين تظهر فارغة وموضح عليها بعض الأوامر في كيفية التعامل مع هذا المستودع. 
4. بعد انشاء المستودع والتأكد من ذلك نحتاج الآن دفع ملفات المشروع التي على حاسوبك الى هذا المستودع الموجود في github لمشاركتها مع العميل. لدفع الملفات نحتاج تنفيذ هاته الاوامر:

   
   نحتاج الدخول الى مجلد ملفات المشروع لتنفيذ الأوامر عليه
   cd path/to/yourProjectFolder
   
   
   تهيئة مستودع غيت محلي على ملفات المشروع 
   git init
   
   
   اضافة كامل ملفات المشروع الى المستودع
   git add .
   
   
   تنفيذ أول ايداع للمشروع بتخصيص عنوان له
   git commit -m "my first commit"
   
   
   انشاء فرع للمشروع للدفع اليه
   git branch -M main
   
   
   اضافة رابط مستودع غيت ، يرجى التأكد من استبدال رابط مستودع غيت بالرابط المثال في هذا الامر
   git remote add origin https://github.com/example-user/example-repo.git

    

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

• التوجه الى الاعدادات عن طريق الضغط على settings من القائمة المنسدلة. 
• في صفحة الاعدادات التوجه الى اعدادات المطور Developer settings اسفل القائمة الجانبية.
• الضغط على generate new token من نافذة Personal access tokens لتوليد مفتاح توثيق جديد. 
• تأكدي من تحديد تاريخ انتهاء صلاحيته، ومن تحديد كامل مربعات التحقق التي تخص الصلاحيات أسفله. ثم سيمكن تقديم طلب الانشاء. 
• سيتم بعد هذا اعطاءك مفتاح التوثيق، يرجى التأكد من حفظه بمكان آمن لأنه لن يمكن استخراجه لاحقا عن طريق github. 

الآن وأخيرا سنعود الى تنفيذ أمر الدفع الأخير على مستودع المشروع في حاسوبك الشخصي:

git push -u origin main

سيطلب منك بعد تنفيذ هذا الأمر ادخال اسم مستخدم github ثم سيطلب منك ادخال كلمة المرور. 

كلمة المرور هاهنا هي هذا الرمز الذي قمنا للتو بإنشاءه. 

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

• التأكد من ان العميل يمتلك حساب غيتهب أيضا.
• عن طريق صفحة المستودع، التوجه الى نافذة اعدادات المستودع settings.
• من القائمة الجانبية، الضغط على مشاركين collaborators للتحكم فيمن يمكنهم الوصول الى هذا المستودع. 
• الضغط على زر اضافة اشخاص add people. 
• اضافة البريد الالكتروني الذي يستخدمه العميل في غيتهب أو اسم مستخدمه على غيتهب.
• تأكيد الاضافة.

يمكنك الاستفاذة من سلسلة المقالات المنشورة حول git هنا.

مرحبا

لقد انشأت مستودع لكن النتيجة كانت 

بتاريخ الآن قال Lubnaabbas Abbas:

مرحبا

لقد انشأت مستودع لكن النتيجة كانت 

يحاول الخطأ اخبارك أن الأمر git غير معروف في ويندوز، وهذا طبيعي لأن git غير مثبت افتراضا في ويندوز مثل لينكس مثلا ولكنه يحتاج تثبيتا بشكل منفصل قبل محاولة استعمال أي امر git. ولتثبيته نحتاج اتباع الخطوات:

• تحميل برنامج التثبيت الموافق لنظام التشغيل الذي لديك من الموقع الرسمي https://git-scm.com/download/win
• تشغيل برنامج التثبيت بعد تمام تنزيله. 
• أثناء تشغيل برنامج التثبيت سيظهر مربع حوار يتم من عليه تحديد المكونات التي سيتم تثبيتها.
•  بعد الانتهاء سيمكن استعمال أوامر git السابقة بشكل عادي، ان واجهت مشكلة بهذا يفضل اعادة تشغيل النظام قبل استعمال git.

بعد رفع المشروع على GitHup 

كيف اشاركها مع العميل 

بتاريخ الآن قال محمد الرزوق:

بعد رفع المشروع على GitHup 

كيف اشاركها مع العميل 

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

https://github.com/ اسم المستخدم/repoName.git

مثال حقيقي:

https://github.com/HsoubAcademy/odoo

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

أما في حال كان المستودع Private أي متاح لك أنت فقط، فعليك إضافة العميل إلى المستودع كمشارك أو مساهم collaborator من خلال التوجه للمستودع ثم الضغط على settings كالتالي:

ثم قم بالتالي:

1. اسأل العميل  عن اسم المستخدم الخاص به على GitHub وإذا لم يكن لديه اسم مستخدم بعد، فيمكنه التسجيل في GitHub (أي يجب أن يكون لديه حساب على GitHub).
2. انتقل إلى المستودع الذي تريد دعوته إليه.
3. انقر فوق "الإعدادات".
4. في قسم "الوصول Access " في الشريط الجانبي، انقر فوق "المتعاونون Collaborators".
5. انقر فوق "إضافة أشخاص".
6. في حقل البحث، ابدأ في كتابة اسم الشخص الذي تريد دعوته.
7. انقر على اسم المستخدم الذي تريده في قائمة البحث.
8. انقر فوق Add NAME to REPOSITORY.

سيتلقى العميل بريدًا إلكترونيًا يدعوه إلى المستودع وبمجرد قبول دعوتك، سيكون لديهم وصول متعاون إلى مستودعك.

وبإمكانك اختيار منحه أحد مستويات الأذونات التالية:

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

طريقة أخرى لمشاركة مستودع Private:

يمكنك استخدام خدمة طرف ثالث مثل https://gitfront.io من أجل مشاركة المستودع الخاص من خلال رابط فقط دون الحاجة للعميل إلى إنشاء حساب أو القيام بالخطوات السابقة.