الدروسكيف تنشر موقعك من GitHub

درس مصغّر 2 من 30 · الإنشاء والنشر

جهّز صفحة تستطيع تمييزها

لمن هذا الدرس؟

لمن يريدون نشر موقع وتحديثه بصورة موثوقة. ملفات الموقع جاهزة ومرفقة؛ ويمكنك استخدام GitHub Desktop ومساعد برمجة دون كتابة أوامر Git.

استخدم موقع P1 الجاهز بدل تجميع موقع أولًا.

هدف هذا الدرس

  • اربط مستودعًا تجريبيًا بالاستضافة.
  • انشر تعديلًا ظاهرًا وتحقق من النتيجة العامة.
  • حدّد المرحلة التي تعطلت عندما تعرض الصفحة العامة نسخة قديمة.
شرح ومثال محلول وتدريب

قبل أن تبدأ

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

تحقّق من مهارات البداية

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

  1. كيف تنشئ أول موقع شخصي لك

    أنشئ تعريفًا بنفسك وقسمًا للمشاريع وطريقة للتواصل انطلاقًا من ملفات البداية المرفقة.

الوقت المتوقع: 21–33 دقيقة

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

افهم الفكرة

افتح ملفات التطبيق واحفظ index.html وstyle.css وnetlify.toml و.gitignore في مجلد مشروع واحد. افتح index.html على جهازك لرؤية صفحة P1، ثم اطلب من مساعد البرمجة وضع هذه الملفات في جذر مستودع تجريبي مستقل.

ينبغي أن تظهر عبارة Portfolio version P1 على الصفحة. اختر مستودعًا ومشروع استضافة للتدريب، وتأكد من أن أيًا منهما ليس موقعًا فعليًا آخر لا علاقة له بالتجربة.

مثال عملي

استخدم مجلد تطبيق واحدًا يحتوي على index.html وstyle.css وnetlify.toml و.gitignore. تتيح لك علامة Portfolio version P1 على الصفحة التعرف إلى هذه النسخة الأولى لاحقًا.

استخدم موقع P1 وملفات النشر المرفقة. ساعدني في وضعها في المجلد الرئيسي لمستودع تجريبي منفصل باستخدام GitHub Desktop، وفحص التعديلات بحثًا عن ملفات خاصة، وربط المستودع بمشروع Netlify التجريبي الخاص بي. اطلب موافقتي قبل النشر. اشرح كيف أتحقق من P1 في الصفحة العامة، ثم ساعدني في نشر تعديل صغير يحمل P2 دون تغيير موقع منشور قائم.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

افتح صفحة P1 المحلية. أي مستودع ومشروع استضافة ستستخدم للتدريب؟

عرض حل نموذجي مشروح

مثال سجل إعداد: سأستخدم المستودع التدريبي portfolio-publish-lab ومشروعًا منفصلًا بالاسم نفسه في Netlify. تعرض الصفحة المحلية Portfolio version P1. ولا يمثل أي منهما موقعي الحالي المنشور.

ما تتضمنه الإجابة السليمة

  • يحدد مستودعًا ومشروع استضافة منفصلين للتدريب.
  • يتعرف إلى علامة P1 الظاهرة في الصفحة المفتوحة محليًا.
كيف يعمل؟ (اختياري)

انشر موقعك من GitHub

ينسخ النشر نسخة من ملفاتك إلى مضيف ليتمكن الآخرون من طلبها.

صفحتك المحلية ومستودع GitHub ونسخة النشر على الاستضافة ثلاثة أماكن منفصلة. حفظ ملف محليًا لا يحدّث الصفحة العامة تلقائيًا. يسجّل الالتزام (commit) نسخة؛ ويمكن للمضيف المتصل نشر تلك النسخة.

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

للتحقق المرئي من النسخة، أضف الفقرة «Portfolio version P1» قبل الالتزام الأول. وفي المهمة الختامية غيّرها إلى P2 إلى جانب تغيير المحتوى المفيد. تساعدك العلامة على مقارنة الملف المحلي والالتزام البعيد والصفحة المنشورة دون تخمين النسخة المفتوحة.

مثال محلول

يضيف Alex العبارة الظاهرة «Portfolio version P1» إلى صفحة. تسمح لنا العبارة ومعرّف التزامها بالتمييز بين نشر ناجح ومتصفح لا يزال يعرض نسخة أقدم.

تمرين تقني إضافي

حفظت P1 محليًا، لكن الصفحة المستضافة لا تزال تعرض P0. ما خطوتا النشر اللتان قد تكونان غير مكتملتين؟

عرض حل نموذجي مشروح

افحص المستودع أولًا، ثم سجل النشر لدى المضيف. لا يستطيع تحديث المتصفح نشر تغيير لم يصل إلى المضيف أصلًا.

  • تتحقق مما إذا كان التغيير قد سُجّل بالتزام ودُفع إلى المستودع البعيد.
  • تتحقق مما إذا كان نشر ناجح قد استخدم ذلك الالتزام.

الخطوة 1 · كيف تنشر موقعك من GitHub

راجع التعديل وأرسله إلى GitHub

افحص قائمة الملفات قبل نشرها.

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

افهم الفكرة

راجع الملفات المعدلة مع المساعد في GitHub Desktop. سجّل ملفات الموقع المقصودة في commit، ثم ادفع فرع التدريب عندما تصبح جاهزًا. أبقِ ملفات البيئة وأسرار الحسابات خارج المستودع.

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

مثال عملي

راجع قائمة الملفات المعدلة قبل إرسالها. ينتمي index.html وstyle.css إلى الصفحة العامة، أما ملف .env الخاص فلا ينتمي إليها. بعد الرفع، افحص قائمة الملفات البعيدة بدل افتراض أن الحفظ المحلي وصل إلى GitHub.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ما الملفات التي أرسلتها؟ وهل تستطيع العثور على الصفحة الرئيسية المقصودة في المستودع التجريبي البعيد؟

عرض حل نموذجي مشروح

مثال سجل تحقق: عرض GitHub Desktop الملفات index.html وstyle.css وnetlify.toml و.gitignore. حفظت التغيير في commit ورفعته. ظهر index.html في جذر المستودع على GitHub، ولم تتضمن القائمة .env أو أي ملف حساب خاص.

ما تتضمنه الإجابة السليمة

  • يسرد ملفات الموقع العامة المطلوبة ويتحقق من استبعاد الملفات الخاصة.
  • يتأكد من وجود الصفحة الرئيسية في جذر النشر بالمستودع البعيد.
كيف يعمل؟ (اختياري)

ضع الملفات الصحيحة في المستودع

سجّل مجموعة صغيرة من ملفات الموقع العامة بالتزام، ثم افحصها قبل الدفع.

المسار المشروح: أنشئ مستودع تدريب على GitHub، ثم استخدم File → Clone repository في GitHub Desktop لاستنساخه إلى مجلد محلي جديد. أضف .gitignore المرفق إلى المجلد المستنسخ أولًا. ثم انسخ إليه ملفات موقعك العامة فقط، مع إبقاء index.html في جذره، وافحص التغييرات قبل تجهيزها وتسجيلها بالتزام.

في GitHub Desktop، افحص قائمة Changes والفروق، واكتب ملخص التزام، وسجّله على الفرع المقصود، ثم اختر Push origin. إذا ظهرت Publish branch بدلًا منها، فانشر ذلك الفرع إلى المستودع البعيد. مثال سطر الأوامر أدناه بديل لنسخة مستنسخة مهيّأة مسبقًا. قاعدة تجاهل Git لا تزيل سرًا سُجّل بالتزام من قبل. إذا كشفت مفتاحًا حقيقيًا بالخطأ، فألغِه وأصلح المستودع؛ حذف الملف الحالي غير كافٍ.

مثال محلول

تجهّز قائمة الأوامر ملفات موقع مسماة بدل جميع ملفات الحاسوب. ثم تعرض التغيير المجهّز لتفحص ما سيتضمنه الالتزام.

git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"

تمرين تقني إضافي

تتضمن الفروق المجهّزة ملف .env به مفتاح خدمة. ماذا ينبغي أن تفعل قبل الدفع؟

عرض حل نموذجي مشروح

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

افحص الفروق المجهّزة مجددًا قبل الدفع. إذا كان المستودع يحتوي على التزامات سابقة، فافحص سجله والمستودع البعيد بحثًا عن بيانات الاعتماد دون نسخ قيمتها إلى تقرير. استبدل أي مفتاح حقيقي مكشوف؛ إضافة .gitignore لا تمحو الانكشاف السابق.

  • تزيل الملف السري من التغييرات المجهّزة.
  • تتحقق مما إذا كانت بيانات الاعتماد قد كُشفت وتستبدلها عند الحاجة.

الخطوة 2 · كيف تنشر موقعك من GitHub

اربط المستودع بالاستضافة

اجعل الاستضافة تنشر المجلد الذي يحتوي على الصفحة الرئيسية.

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

افهم الفكرة

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

انتظر حتى تبلغ الاستضافة عن نجاح النشر. افتح الرابط العام في نافذة خاصة وابحث عن P1؛ رسالة النجاح في لوحة التحكم وحدها لا تثبت أن الصفحة الصحيحة منشورة.

مثال عملي

الصفحة المحلية P1، وGitHub يعرض P1، والاستضافة تقول إن النشر اكتمل، لكن الرابط العام يعرض 404. الخطوة التالية هي التأكد من أن الاستضافة تنشر المجلد الذي يحتوي فعلًا على index.html.

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

هل يعرض الرابط العام صفحة P1 دون تسجيل الدخول؟ إن لم يفعل، فما الذي تراه بالفعل؟

عرض حل نموذجي مشروح

مثال سجل تحقق: فتحت الرابط العام للاستضافة التدريبية في نافذة خاصة وظهرت Portfolio version P1. وفي حالة فشل، فإن «404 في الرابط العام، بينما تفتح P1 محليًا» توجهني لمراجعة مجلد النشر والصفحة الرئيسية في جذره، لا ألوان الصفحة.

ما تتضمنه الإجابة السليمة

  • يذكر الصفحة أو الخطأ الذي ظهر فعلًا عند فتح الرابط العام دون تسجيل دخول.
  • يستخدم علامة P1 لتمييز الصفحة المقصودة عن نشر آخر.
كيف يعمل؟ (اختياري)

اربط المضيف واختر مجلد النشر

يحتاج المضيف إلى معرفة المستودع الذي سيستخدمه والمجلد الذي يحتوي على الملفات العامة.

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

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

افحص شجرة المجلدات قبل إعداد المضيف: جذر المستودع → index.html وstyle.css. في مسار HTML العادي هذا، يقترن publish='.' بعدم وجود أمر بناء. مجلد الشيفرة المصدرية لإطار عمل ليس تلقائيًا مجلد ناتج النشر؛ تعليمات البناء الخاصة به تحدد ذلك الناتج.

مثال محلول

إذا احتوى الجذر على index.html، فإن نشر «.» يقدّم هذا الملف بوصفه الصفحة الرئيسية. قد يؤدي نشر مجلد لا يحتوي على الصفحة الرئيسية المبنية إلى نسخة نشر يظهر عند جذرها الخطأ 404.

[build]
  publish = "."

Netlify: إنشاء عمليات نشر

تمرين تقني إضافي

ينجح النشر، لكن الصفحة الرئيسية تعرض 404. أي ملف وأي إعداد ينبغي أن تقارن؟

عرض حل نموذجي مشروح

تأكد من أن مجلد النشر المحدد يحتوي على index.html. نجاح الرفع لا يثبت أن المجلد الصحيح قد رُفع.

  • تعثر على index.html في المستودع أو في ناتج البناء الفعلي.
  • تقارن ذلك الموقع بمجلد النشر.

الخطوة 3 · كيف تنشر موقعك من GitHub

تتبّع سبب ظهور نسخة عامة قديمة

قارن المستودع وسجل الاستضافة وما يظهر في المتصفح.

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

افهم الفكرة

نفّذ تعديلًا صغيرًا في المحتوى وغيّر علامة الصفحة إلى P2 بمساعدة المساعد. احفظ التعديل، وسجّله في commit، وادفعه، ثم افحص عملية النشر المطابقة لدى الاستضافة. احتفظ بسجل P1 السابق للمقارنة.

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

مثال عملي

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

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

ما النسخة التي يعرضها المستودع والاستضافة والصفحة العامة الآن؟ وأين يبدأ الاختلاف؟

عرض حل نموذجي مشروح

تشخيص نموذجي: يحتوي GitHub على P2، لكن أحدث نشر ناجح لدى الاستضافة ما زال يشير إلى commit النسخة P1، والصفحة العامة تعرض P1. يبدأ الاختلاف بين GitHub والاستضافة. سأفحص الفرع المختار وسجل النشر قبل اعتبار المشكلة من ذاكرة المتصفح المؤقتة.

ما تتضمنه الإجابة السليمة

  • يسجل النسخة الظاهرة في GitHub ونشر الاستضافة والصفحة العامة كلًا على حدة.
  • يحدّد أول اختلاف ويختار فحصًا في تلك المرحلة.
كيف يعمل؟ (اختياري)

طابق الصفحة المنشورة مع التزامها

افحص النسخة المنشورة وتجربة الزائر، إلى جانب مؤشر النشر الأخضر.

افتح الرابط العام الذي يوفره المضيف في نافذة تصفح خاص. تأكد من تحميل الصفحة الرئيسية وورقة الأنماط دون جلسة حساب المالك الخاصة بك. انقر الروابط الداخلية وافحص علامة P1.

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

مثال محلول

يتضمن السجل المفيد الالتزام ورابط النشر والعلامة الظاهرة. إذا ذكر النشر التزام P1 لكن الصفحة تعرض P0، فافحص الرابط المطلوب والاستجابة قبل تغيير إعدادات البناء عشوائيًا.

تمرين تقني إضافي

يحتوي المستودع على P2، لكن سجل النشر يسمّي التزام P1. هل هذه أساسًا مشكلة تحديث متصفح؟

عرض حل نموذجي مشروح

لا. ابحث عن سبب عدم نشر المضيف لالتزام P2. لا تشخّص التخزين المؤقت للمتصفح إلا بعد التأكد من أن النسخة المقصودة منشورة بالفعل.

  • تحدد أن P2 لم تُنشر.
  • تفحص اختيار الفرع ونتيجة آخر بناء.

الخطوة 4 · كيف تنشر موقعك من GitHub

انشر P2 وتحقق منها

اختم بتحديث عام حقيقي تستطيع تمييزه.

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

افهم الفكرة

انشر تعديل P2 عبر مسار التدريب نفسه. افتح الرابط النهائي دون تسجيل الدخول وجرّب الرابط أو المحتوى الذي عدّلته. احتفظ بمعرّفات تعديلَي P1 وP2 وعمليتَي نشرهما من الأدوات.

تحقق من العلامة والتغيير الفعلي، ولا تكتفِ بأيقونة نشر خضراء. اذكر أي خطوة لم تستطع إكمالها.

مثال عملي

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

ملفات هذه الخطوة

ابدأ هناملفات ورشة العمل

افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.

جرّب بنفسك

قدّم نتيجة P2 والاختبارات التي تُظهر أن التعديل المقصود وصل إلى الصفحة العامة.

ما المطلوب إنجازه: رابط التدريب العام، وسجلات نسختَي P1 وP2، ونتائج فحص الصفحة الفعلية دون تسجيل الدخول.

عرض حل نموذجي مشروح

تسليم نموذجي: يعرض عنوان التدريب Portfolio version P2 دون تسجيل دخول. يشير تغيير المستودع والنشر الناجح إلى commit النسخة P2 نفسه. تظهر جملة المشروع المعدلة، وما زال Contact يصل إلى قسم التواصل. احتفظت بسجل P1 للتعرّف إلى النسخة السابقة العاملة.

ما تتضمنه الإجابة السليمة

  • يربط نتيجة P2 العامة بالتغيير الموافق في المستودع وسجل النشر.
  • يسجل اختبارًا في المتصفح للمحتوى أو الإجراء المعدل فعلًا.
كيف يعمل؟ (اختياري)

مهمتك: انشر نسخة ثانية

أظهر أن مسار النشر يعمل مجددًا بعد الإصدار الأول الناجح.

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

احتفظ بسجلي النسختين. ستستخدم العلاقة بين الالتزامات وعمليات النشر لاحقًا عند تعلّم المعاينات والتراجع عن النشر.

مثال محلول

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

يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.

تمرين تقني إضافي

انشر P2 وقدّم دليلًا على أن المضيف يقدّم الالتزام المقصود.

  1. غيّر عنصرًا ظاهرًا واحدًا، وحدّث العلامة من P1 إلى P2، وافحص الفروق.
  2. سجّل التغيير بالتزام وادفعه؛ واعثر على النشر المطابق.
  3. اختبر الرابط العام وسجّل العلامة الجديدة.
عرض حل نموذجي مشروح

قبل الالتزام الأول، ضع «Portfolio version P1» في فقرة ظاهرة. احفظ الصفحة، وافحص فروق Changes في GitHub Desktop، وسجّل فقط index.html/style.css/netlify.toml/.gitignore بالتزام، وادفع الفرع المقصود. تأكد في عرض ملفات GitHub من وجود الملفات الأربعة في جذر المستودع.

سجّل معرّف الالتزام بوصفه P1. اختر في Netlify المستودع والفرع نفسيهما، واترك أمر البناء فارغًا، واستخدم publish='.'. طابق التزام النشر الناجح مع P1، ثم افتح رابطه العام وأنت مسجّل الخروج واقرأ العلامة. غيّر العلامة إلى P2، وكرر الالتزام والدفع والنشر، واحتفظ بالسجلين.

تشخيص مفيد هو: repository=P2, deploy=P1, public marker=P1 → افحص حالة الفرع والبناء والنشر. وحالة أخرى هي deploy=P2, public marker=P1 → افحص أولًا اسم المضيف المطلوب والاستجابة والتخزين المؤقت. لا تنشر سرًا لاختبار ما إذا كان Git يستطيع إخفاءه؛ افحص الفروق المجهّزة وأي سجل قائم قبل الدفع.

  • يطابق المحتوى العام تغيير P2 والالتزام المسجل.
  • تعمل الصفحة الرئيسية وCSS والتنقل دون تسجيل دخول المالك.

هل أفادك هذا الدرس؟

اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.