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

كيف تضيف بحثًا إلى موقعك

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

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

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

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

قبل أن تبدأ

تحتاج إلى حزمة المدونة والبحث المرفقة ومساعد برمجة لتشغيل مجلد public عبر HTTP. يمكنك استخدام المقالات الجاهزة؛ لا تحتاج إلى مدونة شخصية قائمة.

الوقت المتوقع: 14–26 دقيقة

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

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

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

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

الخطوة 1

جرّب البحث الجاهز

اعثر على موضوع وافتح المقالة الفعلية.

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

ينبغي أن يظهر المحتوى العام فقط في البحث. إخفاء رابط المسودة من القائمة لا يجعل نصها المضمّن خاصًا.

مثال عملي

تكون نتيجة البحث مفيدة عندما تصل إلى مقالة ذات محتوى، لا إلى صفحة فارغة.

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

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

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

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

How it works (optional)

ساعد الزوار على العثور على المقال الصحيح

ينبغي أن يربط البحث سؤالًا بصفحة حقيقية، لا أن يحرّك مربع بحث فقط.

توسّع الورشة موقع المدونة بإضافة search.html وفهرس JSON وسكربت متصفح. يبحث في عناوين المقالات ونصوصها ويعيد روابط إلى الصفحات القائمة.

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

مثال محلول

يعيد البحث عن «image» المقال المتعلق بمصادر صور أصغر. ويعيد البحث عن كلمة غير مرتبطة رسالة واضحة بعدم وجود نتائج، مع إبقاء رابط التصفح متاحًا.

Extra implementation exercise

هل يمكن أن تظل مسودة خاصة إذا أخفيت رابط صفحتها لكن أدرجت نصها كاملًا في search-index.json؟

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

لا. يستطيع أي شخص تنزيل JSON. استبعد المحتوى الخاص من البحث العام وطبّق ضوابط الوصول على أي خادم خلفي خاص فعلًا.

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

الخطوة 2

استخدم عبارة مميزة

اختر ما تستطيع تمييزه في المقالة والبحث.

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

لا يعرف البحث تلقائيًا بوجود صفحة لمجرد حفظها. وقد يفوّت البحث البسيط القائم على الكلمات أخطاء الكتابة أو الصياغات غير المألوفة.

مثال عملي

تساعد عبارة مطابقة على تحديد ما إذا كانت المقالة الجديدة قد رُبطت بالبحث أصلًا.

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

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

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

How it works (optional)

طابق الكلمات واعرض نتائج آمنة

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

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

ينشئ الروابط بطرق DOM وtextContent. يقيّد مدقق الفهرس الوجهات بتنسيق أسماء ملفات المدونة المتوقع. يفيد ذلك حتى لفهرس يُدار محليًا لأنه يمنع وجهات مشوهة أو غير آمنة بالخطأ.

قاعدة المطابقة هي AND بين كلمات الاستعلام، في أي موضع من العنوان والمتن مجتمعين. لا يهم ترتيب الكلمات: «image browser» و«browser image» لهما المطابقات نفسها. ليس هذا بحث عبارة مطابقة تمامًا. تُحتسب كلمة موجودة في متن المقال فقط أيضًا؛ ولا يُصحح الخطأ الإملائي تلقائيًا.

مثال محلول

تطابق «image browser» صفحة تحتوي الكلمتين. لا تتحول «imagge» تلقائيًا إلى «image». إذا أردت معالجة الأخطاء الإملائية لاحقًا، فأضف سلوكًا صريحًا واختبارات.

const matches = entries.filter(entry =>
  words.every(word => (entry.title + ' ' + entry.text)
    .toLowerCase().includes(word))
);

Extra implementation exercise

لماذا قد لا يطابق مقال ذو صلة استعلامًا يحتوي على كلمة مكتوبة خطأ؟

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

المقطع النصي الحرفي غير موجود في نصه. لا يملك البحث الحالي تصحيحًا إملائيًا؛ صحح الاستعلام أو نفّذ بديلًا مختبرًا.

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

الخطوة 3

افحص عدم وجود نتائج وتعطل البحث

تحتاج الحالات المختلفة إلى خطوات تالية مختلفة.

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

ينبغي أن تختلف رسالة عدم العثور على مقال عن رسالة تعطل البحث مؤقتًا. أبقِ الاستعلام متاحًا للتصحيح أو المحاولة مجددًا، وجرّب مسار تصفح كل المقالات البديل. وضح أن الطلب المحجوب عمدًا محاكاة، لا انقطاع حقيقي.

مثال عملي

خطأ الطلب لا يثبت غياب مقالة ذات صلة.

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

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

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

How it works (optional)

افصل عدم وجود نتائج عن عدم توافر البحث

فشل تنزيل الفهرس لا يثبت عدم وجود مقال مطابق.

شغّل حالات النجاح والموضوع المفقود والاستعلام الفارغ المرفقة. ثم استخدم أدوات المطوّر لحجب search-index.json وأعد التحميل قبل البحث؛ يخزن السكربت الفهرس المحمّل بنجاح في الذاكرة.

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

مثال محلول

تعني «No matching articles» أن فهرسًا صالحًا للاستخدام قد بُحث فيه. وتعني «Search unavailable» أن الحصول على الفهرس أو التحقق منه لم ينجح. تصف الرسالتان دليلين مختلفين.

Extra implementation exercise

يعيد طلب JSON الحالة 500. هل ينبغي أن تقول الصفحة إنه لا توجد مقالات مطابقة؟

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

لا. أبلغ عن عدم توافر البحث واحتفظ برابط التصفح. لا تدّعِ انعدام المطابقات إلا بعد تحميل الفهرس وفحصه بنجاح.

  • تميّز فشل النقل عن المطابقات الفارغة.
  • تقدم مسار تنقل بديلًا يعمل.

الخطوة 4

أبقِ المقالة الجديدة قابلة للعثور عليها

كرّر مهمة القارئ بعد التعديل.

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

تحقق أن النتيجة المحمّلة تصل إلى المحتوى الجديد الفعلي. حافظ أيضًا على سلوك عدم العثور والفشل وتصفح الجميع.

مثال عملي

مثال turquoise-anchor المرفق للمقارنة، وليس موضوع كتابة شخصيًا إلزاميًا.

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

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

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

How it works (optional)

مهمتك: أبقِ البحث متزامنًا مع مقال جديد

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

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

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

يمكن لمقالك الرابع استخدام أي موضوع حقيقي وعبارة مميزة. contact-anchor-check.html و«turquoise anchor check» حالة المقارنة المرفقة فقط، وليسا محتوى مطلوبًا للتسليم. المهم تطابق اسم ملفك الحقيقي والنص القابل للبحث في المقال والفهرس المحمّل.

مثال محلول

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

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

Extra implementation exercise

انشر المقال التجريبي الرابع وأثبت أن البحث يعثر على عبارته المميزة.

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

يستخدم المقال المرجعي الرابع العبارة المميزة «turquoise anchor check». يحتوي مدخل search-index.json المقابل على اسم ملف المدونة الحقيقي ونص ملخص أو متن قابل للبحث؛ تعرض الملفات المرجعية الكاملة الجانبين.

أعد التحميل لمحو الفهرس المخزن مؤقتًا في الذاكرة، وابحث عن العبارة وافتح المقال المُرجع. افحص JSON المحمّل أيضًا: مجرد وضع العبارة في HTML دون تحديث الفهرس لن يجعلها قابلة للبحث.

أعد اختبار موضوع مفقود وتنزيل فهرس محجوب في تبويب جديد أو بعد إعادة التحميل. يجب أن ينتج غياب المطابقات وعدم توافر البحث رسالتين مختلفتين، بينما يظل Browse all articles يعمل.

  • تفتح النتيجة المقال الحقيقي المقصود.
  • يُفهرس المحتوى الجديد دون تعطيل معالجة الفشل والاستعلام الفارغ.

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

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

واصل التعلّم

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