
درس مصغّر · العربية
كيف تعاين تغييرات موقعك قبل النشر
جهّز تعديلًا صغيرًا للموقع بمساعدة المساعد، وراجع عنوان معاينته المنفصل، وأبقِ النسخة الفعلية دون تغيير حتى الموافقة.
لمن هذا الدرس؟
لمن ينشرون من مستودع ويريدون فحص التعديلات قبل إطلاقها. يستطيع مساعد برمجة وأدوات المستودع والاستضافة تولّي آلية الفروع.
قبل أن تبدأ
تحتاج إلى مستودع GitHub منفصل تملكه مربوط بمشروع Netlify تجريبي، مع تفعيل معاينات طلبات السحب. تستهلك عمليات البناء السحابية رصيد الحساب. توفر الحزمة ملفات البداية والتعديل؛ استخدم موقعًا قابلًا للحذف بدل تعديل إنتاجي حقيقي.
الوقت المتوقع: 20–32 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. انتظار البناء السحابي وإعداد الحساب وقت إضافي. يجب ألا تحتوي المعاينات العامة على بيانات اختبار خاصة أو أسرار إنتاج.
ما الذي ستتعلمه؟
- أنشئ نسخة مراجعة منفصلة.
- قارن المعاينة والموقع الحالي بالمهمة نفسها.
- اربط الموافقة بالنسخة التي راجعتها فعلًا.
الخطوة 1
حدّد النسختين
تحتاج المراجعة إلى نقطة بداية وتعديل مقترح معًا.
استخدم صفحة البداية المرفقة لنشر P1 في مشروع استضافة تدريبي منفصل. قارنها بمساعدة المساعد بصفحة التعديل المرفقة: تقول P1 “Find contact information”، وتقول P2 “Contact me”. ينبغي أن يصلا إلى قسم Contact نفسه.
احتفظ بعنوان P1 المنشور حاليًا أساسًا للمقارنة. مكان P2 المقترحة فرع مراجعة لم يُدمج ومعاينة منفصلة له؛ وسجل علامات النسخ الظاهرة لتمييز الصفحة التي تختبرها.
مثال عملي
هذا تعديل صغير للصياغة، وليس نظام تواصل جديدًا. ينبغي أن تصبح التسمية المقترحة أوضح مع استمرار عمل وجهة التواصل الحالية.
استخدم تعديل موقع التدريب المرفق. ساعدني في إنشاء فرع مراجعة وطلب سحب منفصلين مع معاينة Netlify، مع إبقاء النسخة التجريبية المنشورة الحالية دون تغيير. اعرض الرابطين وحدّد النسخة قيد المراجعة. لا تدمج أو تنشر نسخة إنتاجية دون موافقتي. ساعدني في اختبار المهمة المعدلة وتسجيل المشكلات المتبقية.ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
عاين تغييرًا قبل نشره
امنح النسخة المقترحة رابط مراجعة خاصًا بينما يظل الإنتاج يعمل.
تتيح المعاينة اختبار ناتج بناء فرع فعلي قبل دمجه في مصدر الإنتاج. قد يبدو ملف محلي جيدًا وتظل فيه مسارات بناء أو إعدادات بيئة خاطئة.
تستخدم هذه الورشة تغييرًا صغيرًا عمدًا: تقول P1 «Find contact information» وتقول P2 «Contact me». ستحدد النسختين وتفحص مهمة التواصل نفسها قبل تقرير الدمج.
مثال محلول
بينما لا يزال طلب السحب غير مدمج، ينبغي أن تعرض المعاينة P2 والموقع العام العادي P1. إذا تغير الاثنان، فافحص أي فرع يُنشر إلى الإنتاج.
Extra implementation exercise
لماذا ينبغي أن يتضمن سجل مراجعتك نسختي المعاينة والإنتاج؟
عرض حل نموذجي مشروح
يثبت أن المعاينة تتضمن التغيير المقترح بينما يحتفظ الموقع العام بالنسخة المعتمدة. المعاينة التي تعمل وحدها لا تثبت ذلك الفصل.
- تثبت النسخة قيد المراجعة.
- تؤكد عدم تغيير الإنتاج بالخطأ.
خطأ شائع
مراجعة رابط الإنتاج مع افتراض أنه معاينة الفرع.
الخطوة 2
أنشئ معاينة للمراجعة
دع المساعد يرشدك إلى خطوات المستودع.
استخدم المستودع التدريبي المخصص وفعّل معاينات طلبات السحب في حساب الاستضافة. اطلب من المساعد إنشاء فرع مراجعة بتعديل P2 المرفق، ورفع الفرع، وفتح طلب سحب دون دمجه. قد تستهلك عمليات البناء المستضافة هذه رصيد الحساب.
افتح المعاينة الناتجة واقرأ علامة P2 الظاهرة. احفظ رابط المعاينة مع معرّف commit المحدد الذي راجعته من المستودع أو الاستضافة. أي commit لاحق على الفرع نفسه نسخة جديدة يجب فحصها.
مثال عملي
قد يحتوي فرع اسمه improve-contact-label على عدة commits مختلفة بمرور الوقت. لا تشمل الموافقة على معاينته الأولى الـcommit التالية تلقائيًا.
Netlify: معاينات النشر Deploy Previews
جرّب بنفسك
أي معاينة فتحت؟ وما النسخة التي تحتويها؟
عرض حل نموذجي مشروح
يحدد السجل التوضيحي رابط المعاينة الذي أنشأته الاستضافة وعلامة P2 ومعرّف commit المنسوخ من طلب السحب. سأتحقق من وجود “Contact me” هناك. إذا رأيت P1 أو لم أجد بناء معاينة، فلم تجتز تلك المعاينة هذا الفحص بعد.
- يربط رابط المعاينة الفعلي بعلامة P2 ومراجعة المصدر المحددة.
- لا يعتبر اسم الفرع وحده هوية النسخة التي روجعت.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
افتح مراجعة فرع بتغيير قابل للتكرار
اربط طلب سحب بإصدار محدد من المصدر.
اتبع commands.txt داخل مستودعك القابل للاستغناء عنه فقط. سجّل تغيير P2 بالتزام على فرع وافتح طلب سحب دون دمجه. ينبغي أن تربط Deploy Preview في Netlify رابطًا مبنيًا بطلب السحب ذاك وإصدار المصدر المرتبط به.
اقرأ تفاصيل النشر بدل استنتاج النجاح من المتصفح. سجّل الالتزام وافحص مجلد النشر. إذا لم توجد معاينة، فافحص إعدادات المعاينة للمشروع وسجلات البناء؛ ولا تعوّض ذلك بنشر الفرع إلى الإنتاج.
قبل أوامر الفرع، افتح رابط P1 العام القائم وانقر رابط التواصل وسجّل التزام P1 الذي يعمل في review-record.csv. إذا لم توجد نسخة نشر P1 تعمل، فأكمل خط الأساس أولًا. للواجب، املأ الصفين: الواجهة والرابط والالتزام والنسخة الظاهرة ونتيجة مهمة التواصل وأي أثر جانبي غير متوقع.
إذا تغير فرع الإنتاج أثناء العمل، فافحص حالة تحديث طلب السحب وتعارضاته قبل المتابعة. اجلب حالة الفرع الحالية وحل أي تعارض عن قصد في فرعك؛ واطلب المساعدة عند عدم اليقين بدل الكتابة فوق عمل غير مرتبط. بعد الحل، راجع إصدار المعاينة الجديد مجددًا.
إذا غاب رابط المعاينة، فافحص تمكين Deploy Previews لطلبات سحب المستودع وعدم استبعاد الفرع ونجاح سجل البناء وإشارة netlify.toml إلى المجلد العام المقصود. افتح نشر الإنتاج الحالي في سجل Deploys لدى المزوّد للعثور على التزام مصدره الفعلي.
مثال محلول
ينبغي أن يشير فحص الالتزام الأخضر ومعاينة يمكن فتحها وقراءتها إلى إصدار الشيفرة نفسه. تعديل الفرع بعد ذلك ينشئ إصدارًا جديدًا يحتاج إلى مراجعة مستقلة.
Netlify: معاينات النشر Deploy Previews
Extra implementation exercise
راجعت الالتزام A ثم دفعت الالتزام B إلى الفرع نفسه. هل تشمل الموافقة القديمة B؟
عرض حل نموذجي مشروح
لا. بقي اسم الفرع نفسه لكن المحتوى تغير. افحص المعاينة المبنية من B وراجع الفروق.
- تربط المراجعة بإصدار مصدر محدد.
- تعيد اختبار المعاينة المتغيرة قبل ترقيتها.
خطأ شائع
اعتبار رابط فرع معرّف نسخة لا يتغير.
الخطوة 3
كرّر مهمة الزائر بأمان
اسم مضيف مختلف لا يجعل الخدمات الحقيقية بلا أثر.
افتح P1 المنشورة ومعاينة P2 دون دخول وبعرض ضيق. فعّل إجراء التواصل في كل منهما وتحقق من بقاء قسم Contact قابلًا للوصول. في هذا المثال الثابت المرفق، توقف عند وجهة التواصل؛ ولا ترسل بريدًا إلى العنوان المؤقت.
إذا طبّقت التقنية لاحقًا على نماذج أو مدفوعات أو بيانات محفوظة، فافحص إعدادات خدمات المعاينة أولًا. قد يستدعي اسم مضيف جديد للمعاينة خدمة حقيقية؛ فاستخدم حسابات وبيانات اختبار منفصلة لهذه الآثار.
مثال عملي
في المثال المرفق، تصل P1 وP2 إلى قسم Contact؛ وتغير P2 تسمية الرابط الظاهرة وعلامة النسخة فقط. ولا تحتاج أي نسخة إلى إرسال بريد أو كتابة سجل في قاعدة بيانات.
Netlify: متغيرات البيئة وسياقات النشر · Netlify: متغيرات البيئة الخاصة بسياق النشر
جرّب بنفسك
ماذا فعلت المهمة نفسها في كل نسخة؟ وأي حدود لخدمات الاختبار تحققت منها؟
عرض حل نموذجي مشروح
مثال مقارنة: يصل كل من “Find contact information” في P1 و“Contact me” في P2 إلى Contact في عرض ضيق ودون دخول. لا يرسل التعديل المرفق بريدًا ولا ينفذ دفعًا أو إجراء قاعدة بيانات؛ ولم أشغّل عنوان البريد المؤقت.
- ينفذ مهمة التواصل نفسها في النسختين ويقارن نتيجتها.
- يفحص الاستخدام في العرض الضيق ودون دخول، ويميز الإجراء الثابت عن آثاره الخارجية الحقيقية.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
افصل بيانات المعاينة وآثارها الجانبية
رابط مختلف لا يعزل الخلفية تلقائيًا.
ليس لمثال رابط التواصل الثابت آثار خلفية جانبية. في تطبيق حقيقي، راجع متغيرات سياق المعاينة منفصلة: قد لا تزال قاعدة البيانات ومستلم البريد ووضع الدفع وبيانات الاعتماد تشير إلى الإنتاج.
استخدم بيانات اختبار قابلة للاستغناء عنها وبيئات تجريبية لدى المزوّد حيث يلزم. قد تظل معاينة محمية من المشاهدة العابرة تنفّذ دالة خادم بأي بيانات اعتماد أعددتها.
مثلًا، إذا قرأت دالتك SUPABASE_URL، فاحتفظ باسم المتغير نفسه لكن اضبط قيمة سياق Deploy Preview له على مشروع قاعدة البيانات القابل للاستغناء عنه. لا تختلق اسم متغير لا تقرؤه الشيفرة. راجع كل سر ومستلم ووضع دفع في ذلك السياق أيضًا؛ نسخ قيمة الإنتاج يهدم العزل.
افتح إعدادات متغيرات البيئة في لوحة مشروع Netlify، وعدّل قيمة سياق Deploy Preview للمتغير مستقلة عن قيمة Production. احفظ قيمة خدمة اختبار فقط لذلك السياق، وابدأ بناء معاينة جديدًا وتحقق من إصدار المصدر الناتج؛ تغيير قيمة في اللوحة لا يثبت أن دالة منشورة أقدم التقطتها. انظر دليل السياق الرسمي أدناه.
مثال محلول
قد يرسل نموذج تواصل في معاينة متصل بمزوّد بريد الإنتاج رسائل حقيقية. كلمة «preview» في الرابط لا توقف ذلك الاستدعاء.
Netlify: متغيرات البيئة وسياقات النشر · Netlify: متغيرات البيئة الخاصة بسياق النشر
Extra implementation exercise
هل يكفي اسم مضيف معاينة فريد لضمان ألا تخصم مشتريات الاختبار أموالًا حقيقية؟
عرض حل نموذجي مشروح
لا. اضبط المعاينة ببيانات اعتماد اختبار وخدمات معزولة ثم تحقق من سلوكها الفعلي. فصل اسم المضيف وحده غير كافٍ.
- تفحص بيانات اعتماد الدفع ووضعه وأهداف البيانات.
- لا تخلط فصل رابط الواجهة الأمامية بعزل الخلفية.
خطأ شائع
نسخ كل متغيرات بيئة الإنتاج إلى المعاينات دون النظر في آثارها.
الخطوة 4
اتخذ قرار مراجعة مرتبطًا بالنسخة
تتبع الموافقة النتيجة التي فحصتها فعلًا.
أكمل review-record.csv بالروابط والنسخة المراجعة والملاحظات والمشكلات المتبقية. اطلب أي إصلاح محدد وافحص المعاينة الناتجة مجددًا.
أبقِ الموقع الحالي دون تغيير حتى اتخاذ قرار إطلاق صريح. إن تغيرت النسخة بعد المراجعة، فحدّد ما يحتاج إلى إعادة اختبار.
مثال عملي
المراجعة المفيدة محددة: «تصل تسمية التواصل المعدلة في P2 إلى القسم نفسه عند 390 بكسل وعلى سطح المكتب؛ ويبقى الأساس المنشور P1». تحدد النسخة المختبرة ولا تدمج طلب السحب.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم مقارنة المعاينة بالصفحة الحالية، مع موافقتك أو المشكلة المتبقية.
ما المطلوب إنجازه رابطا المعاينة والنسخة الحالية وسجل مقارنة فعلي للنسخة المراجعة.
عرض حل نموذجي مشروح
مثال قرار: تسمية “Contact me” في P2 أوضح، وتصل إلى قسم P1 نفسه عند 390 بكسل وعلى سطح المكتب. أوافق على نسخة المعاينة المسجلة نفسها لاتخاذ قرار إصدار لاحق؛ ويبقي التمرين طلب السحب غير مدمج وP1 منشورة. أي commit جديد يحتاج إلى مراجعة أخرى.
- يربط المقارنة وقرار المراجعة بنسخة المعاينة المحددة.
- يبقي P1 المنشورة دون تغيير ويسرد أي مشكلة تحتاج إلى معاينة ومراجعة جديدتين.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
مهمتك: سلّم تغييرًا قابلًا للمراجعة
اجعل المراجعة صغيرة وادعمها بنتائج قابلة للملاحظة.
أنشئ تحسين تسمية أو تخطيط إضافيًا في الفرع. افحص الفتح المباشر وعرض الهاتف ومهمة التواصل في معاينته. قارنه بنسخة الإنتاج.
قدم وصف تغيير قصيرًا مع رابط المعاينة وإصدار المصدر والملاحظات. لا تدمج إلا بعد موافقة المراجع المقصود على النسخة الفعلية؛ لا يتطلب هذا التدريب ترقية إلى الإنتاج.
للفحص الضيق، استخدم أدوات المطوّر في المتصفح عند نافذة عرض 390px ثم عرض حاسوب. سجّل العرض الفعلي ونتيجة مهمة التواصل في review-record.csv؛ تترك هذه المهمة الفرع غير مدمج.
مثال محلول
«غيّرت تسمية التواصل؛ ولا يزال الرابط يصل إلى #contact عند 390px وعرض الحاسوب» أنفع من «يبدو أفضل».
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
Extra implementation exercise
أنجز معاينة فرع وسجل مقارنة مكتملًا دون تغيير الإنتاج.
عرض حل نموذجي مشروح
تأكد من عمل P1 بالفعل على رابط التدريب العام وسجّل التزامها. غيّر في فرع المراجعة العلامة الظاهرة إلى P2 وتسمية التواصل إلى «Contact me»، وسجّل الفرع بالتزام وادفعه في حسابك وافتح طلب سحب غير مدمج.
سجّل الصفين في review-record.csv: رابط الإنتاج/الالتزام/P1/التواصل يعمل؛ رابط المعاينة/الالتزام الجديد/P2/التواصل يعمل. افتح الاثنين وأنت مسجّل الخروج وعند عرض ضيق. يجب أن تشير إعدادات خلفية المعاينة إلى خدمات اختبار معزولة إذا كانت لها آثار جانبية. كرر فحوص الواجهتين عند 390px وعرض حاسوب؛ واستخدم صفوف CSV منفصلة وسجّل كل عرض فعلي.
بعد التزام فرع آخر، أعد فحص إصدار المعاينة الجديد. يوضح وصف الطلب المرجعي المعلومات التي يحتاج إليها المراجع؛ أبقِ الفرع غير مدمج ولا ترقِّ الإنتاج ضمن هذه المهمة.
- يبقى الإنتاج على إصداره المعتمد أثناء المراجعة.
- يجتاز إصدار المعاينة المحدد مهمة الزائر المذكورة.
خطأ شائع
الدمج أولًا وتسمية النتيجة الفعلية معاينة.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تتيح للمستخدمين رفع الصور
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها