درس مصغّر · العربية

كيف تصلح معاينة موقعك عند مشاركة رابط

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

ابدأ الدرس التفاعلياقرأ ملاحظات الدرس

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

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

قبل أن تبدأ

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

الوقت المتوقع: 15–27 دقيقة

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

ما الذي ستتعلمه؟

  • اربط العنوان والوصف والصورة المقصودين.
  • تحقق من إمكانية جلب الصورة للعامة.
  • افحص معاينة المنصة الفعلية وحدودها.

ملفات ورشة العمل

الخطوة 1

اختر البطاقة التي تريد مشاركتها

تُنشأ المعاينة من صفحة يمكن جلبها للعامة.

افتح الصفحة المرفقة. عنوانها “Practical notes for building a website”، وتتضمن share-card.jpg. قيّم هل يصف العنوان والوصف القصير والصورة ما سيفتحه الزائر بدقة.

أعط المساعد عنوان HTTPS العام الحقيقي للصفحة، واطلب منه ربط هذه القيم للمشاركة. أصل العنوان المحجوز https://YOUR-SITE.example/ مجرد قالب؛ ولا تستطيع منصة جلب صورة موجودة على حاسوبك فقط.

مثال عملي

الوصف المرفق هو “Small examples, working files and clear checks for your next website feature.” يعد مع العنوان بملاحظات عملية لبناء مواقع، لا بصفحة رئيسية لا علاقة لها بذلك.

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

Open Graph: البيانات الوصفية الأساسية

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

اجعل الرابط المشترك يشرح وجهته

تحتاج المعاينة إلى بيانات الصفحة الوصفية وصورة تستطيع المنصة جلبها فعلًا.

تُجمّع معاينة المشاركة عادةً عندما تجلب منصة رابطك وتقرأ البيانات الوصفية. ليست ببساطة لقطة شاشة لما يراه متصفحك المسجّل الدخول.

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

مثال محلول

يقول العنوان المفيد ما تقدمه الصفحة. «My site» يقدم سياقًا أقل بكثير من «Practical notes for building a website» متبوعًا بوصف قصير، أي ملاحظات عملية لإنشاء موقع.

Open Graph: البيانات الوصفية الأساسية

Extra implementation exercise

لماذا قد تعمل صورة مصغرة على حاسوبك المحمول لكنها تفشل في Slack؟

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

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

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

الخطوة 2

افحص الصورة المنشورة

افحص مسار الصورة الذي تشير إليه البطاقة فعلًا.

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

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

مثال عملي

إذا فتح رابط الصورة صفحة HTML الرئيسية للموقع بدل share-card.jpg، فقد يعيد الخادم 200 مع ذلك. يعمل الرابط كصفحة، لكنه لا يقدم صورة للبطاقة.

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

ضع المعاينة في HTML الأولي

استخدم روابط مطلقة للصورة والصفحة الأساسية تصمد أمام الجلب الخارجي.

افحص الرأس المرفق. تصف og:title وog:description وog:type وog:url وog:image هذه الصفحة بعينها. مسار الصورة مطلق لأن زاحفًا بعيدًا يحتاج إلى وجهة لا لبس فيها.

استبدل YOUR-SITE.example في كل موضع. الصورة ملف حقيقي مرفق بالورشة. لا تعتمد على JavaScript في المتصفح لإدخال بيانات وصفية أساسية بعد التحميل؛ يختلف سلوك الزواحف.

البطاقة الأفقية المرفقة بأبعاد 1672 × 941 بكسل. قد تقصّها المنصات أو تغير حجمها بطرق مختلفة، لذا أبقِ التفاصيل المهمة بعيدة عن الحواف وافحص النتيجة الفعلية. هذه صورة أولية يمكنك البناء عليها، وليست وعدًا بأن تعرض كل منصة القص نفسه. تأكد من وجود share-card.jpg في المجلد العام المنشور.

قبل تجربة أي منصة، افتح رابط og:image المنشور الدقيق وأنت مسجّل الخروج، وتحقق من استجابة image/jpeg ناجحة مع ظهور الصورة الفعلية. يفشل هذا الفحص عند ملف مفقود أو أصل تجريبي محجوز أو استجابة HTML بديلة.

مثال محلول

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

<meta property="og:image"
  content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">

Extra implementation exercise

غيّرت صورة الصفحة الظاهرة، لكن og:image لا تزال تشير إلى ملف مفقود. أي صورة سيحاول الزاحف جلبها؟

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

سيحاول عادةً صورة البيانات الوصفية، وهي لا تزال معطلة. صحح رابط og:image وتحقق من استجابته الفعلية.

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

الخطوة 3

افحص معاينة منصة حقيقية

انتبه إلى الجلب البعيد والتخزين المؤقت.

بعد النشر، افحص رابطَي الصفحة والصورة دون دخول. ثم استخدم أداة منصة مثل LinkedIn Post Inspector إن كانت متاحة، أو شارك رابط التدريب بصورة خاصة وافحص بطاقته الفعلية. قارن العنوان والوصف واقتصاص الصورة المعروضة.

دوّن المنصة وما عرضته. إذا كانت الملفات العامة حديثة والمنصة ما زالت تعرض بطاقة قديمة، فافحص ذاكرتها المؤقتة؛ طلب التحديث خطوة، وليس نتيجة مرئية.

مثال عملي

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

LinkedIn Post Inspector · Meta Sharing Debugger

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

افحص الاستجابة قبل لوم التخزين المؤقت

تحقق من HTML الخام وإعادة التوجيه والوصول إلى الصورة، ثم اختبر المنصة.

افتح الرابط المشترك الدقيق في متصفح مسجّل الخروج وافحص المصدر الخام. اتبع إعادة التوجيه وافحص الحالة النهائية. اجلب الصورة منفصلة: يجب أن تعيد بايتات صورة بنوع محتوى مناسب بدل HTML بديل.

بعد صحة مخرجات الخادم، استخدم أداة فحص المنصة حيث تتوفر وجرّب مشاركة جديدة. قد تحتفظ الرسائل القائمة بمعاينات مخزنة مؤقتًا. تحديث ذاكرة متصفحك المؤقتة لا يمحو ذاكرة منصة تواصل.

مثلًا، افتح LinkedIn Post Inspector بحسابك وأدخل الرابط العام الدقيق. تُعد Meta Sharing Debugger أداة أخرى خاصة بمنصة وقد تتطلب تسجيل دخول. في أدوات المطوّر بالمتصفح، اختر طلب الصورة في Network وافحص Headers → Content-Type ومعاينة الاستجابة. قد تظل أدوات المنصات غير متاحة أو تعرض بيانات مخزنة مؤقتًا.

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

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

مثال محلول

قد يكون طلب صورة يعيد 200 text/html استجابة بديلة لتطبيق صفحة واحدة في الواقع. الحالة 200 وحدها لا تثبت تقديم صورة.

LinkedIn Post Inspector · Meta Sharing Debugger

Extra implementation exercise

يعيد طلب og:image الحالة 200 مع صفحة تسجيل دخول. هل نجح فحص الصورة؟

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

لا. تلقى الزاحف HTML بدل الصورة. أصلح التوجيه أو الوصول حتى يعيد رابط الصورة الملف الفعلي دون تسجيل دخول.

  • تفحص نوع المحتوى والمتن إلى جانب الحالة.
  • تشترط وصولًا دون مصادقة إلى بايتات الصورة الفعلية.

الخطوة 4

أكمل بطاقة خاصة بالمقالة

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

اطلب من المساعد إضافة المقال المرجعي المرفق “Fix a mismatched contact link” بعنوان مشاركة ووصف ورابط صفحة خاص به. يمكنه استخدام share-card.jpg نفسها؛ لكن يجب أن تصف هويته ذلك المقال، لا الصفحة الرئيسية.

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

مثال عملي

يجب أن يكون عنوان بطاقة المقال “Fix a mismatched contact link”. يشرح وصفه مقارنة href وid وإصلاح الرابط الداخلي وفحص النتيجة. إعادة استخدام عنوان الصفحة الرئيسية العام تخفي ما يعلمه هذا الرابط بعينه.

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

Start hereملفات ورشة العمل

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

مهمتك: أنشئ معاينة لمقال محدد

امنح رابطًا عميقًا عنوانه الدقيق ووصفه وصورته الخاصة.

أنشئ صفحة مقال ببياناتها الوصفية الخاصة ورسالة مشاركة وصفية. أبقِ canonical/og:url على ذلك المقال بدل الصفحة الرئيسية.

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

مثال محلول

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

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

Extra implementation exercise

أنجز معاينة خاصة بمقال واحد وسجل اختبار للاستجابة والمنصة.

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

استبدل الأصل المحجوز في canonical وog:url وog:image. انشر JPEG المرفق إلى جانب HTML. افتح الرابطين الدقيقين وأنت مسجّل الخروج وافحص استجابة Network: ينبغي أن تكون الصفحة HTML، والصورة بايتات image/jpeg فعلية بدل استجابة HTML بديلة.

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

استخدم LinkedIn Post Inspector أو Meta Sharing Debugger حيث يملك حسابك وصولًا، ثم سجّل نتيجة المنصة الفعلية ووقت الاختبار. المعاينة القديمة المخزنة ملاحظة مختلفة عن مخرجات خادم حالية غير صحيحة. لا تستطيع فحوص المصدر المحلية وحدها إثبات معاينة WhatsApp فعلية.

  • تصف البيانات الوصفية المقال المشترك نفسه.
  • يُفحص HTML الخام والوصول إلى الصورة؛ وتُسجّل نتيجة المنصة بصدق.

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

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

واصل التعلّم

استكشف الدروس الأخرى