
درس مصغّر 20 من 30 · ربط البيانات والذكاء الاصطناعي
جرّب البحث الجاهز
لمن هذا الدرس؟
لمن يريدون مساعدة القراء في العثور على مواضيع داخل موقع صغير. مشروع البحث مرفق؛ ويستطيع مساعد برمجة صيانة فهرسه التقني.
اعثر على موضوع وافتح المقالة الفعلية.
هدف هذا الدرس
- ابحث في المحتوى المرفق وافتح نتيجة حقيقية.
- أضف مقالة جديدة وحافظ على تحديث البحث معها.
- ميّز عدم وجود نتائج من عدم توفر البحث.
شرح ومثال محلول وتدريب
قبل أن تبدأ
تحتاج إلى حزمة المدونة والبحث المرفقة ومساعد برمجة لتشغيل مجلد public عبر HTTP. يمكنك استخدام المقالات الجاهزة؛ لا تحتاج إلى مدونة شخصية قائمة.
تحقّق من مهارات البداية
هذه مهارات مفيدة وليست دروسًا إلزامية تمنع الدخول. ابدأ هنا إن كنت تتقنها، وإلا افتح التحضير المرتبط. ملفات البداية مرفقة، فلا تحتاج إلى موقع شخصي سابق.
- كيف تضيف مدونة إلى موقعك
حوّل مسودة عادية إلى صفحة مقالة مقروءة.
الوقت المتوقع: 14–26 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. يلائم هذا الفهرس العام البسيط مجموعات محتوى صغيرة. تحتاج الأرشيفات الكبيرة وترتيب النتائج متعدد اللغات إلى استراتيجية بحث مختلفة.
افهم الفكرة
اطلب من المساعد تشغيل مجلد public المرفق عبر HTTP. ابحث عن موضوع من المقالات الجاهزة، ثم افتح نتيجة وقارنها بالعنوان والملخص اللذين وعدت بهما.
ينبغي أن يظهر المحتوى العام فقط في البحث. إخفاء رابط المسودة من القائمة لا يجعل نصها المضمّن خاصًا.
مثال عملي
تكون نتيجة البحث مفيدة عندما تصل إلى مقالة ذات محتوى، لا إلى صفحة فارغة.
استخدم مشروع المدونة والبحث المرفق. أضف المقالة الرابعة المرفقة أو مسودتي، وحدّث بيانات البحث معها، مع إبقاء المسودات خاصة والوجهات آمنة. تولَّ كود الفهرس نيابة عني. ساعدني في اختبار عبارة مميزة وموضوع غائب وفشل تحميل بيانات البحث، مع الحفاظ على طريقة لتصفح المقالات.ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ماذا وجد استعلامك الأول؟ وأين فُتحت النتيجة؟
عرض حل نموذجي مشروح
مثال أول بحث: «بحثت عن smaller image فظهر Send a smaller image to a smaller screen. وفتح النتيجة أوصلني إلى المقال الذي يشرح الفرق بين حجم العرض والبايتات المنزلة».
لا يكفي تطابق العنوان إذا كانت الوجهة فارغة. يجب إبقاء المسودات الخاصة خارج بيانات البحث العامة حتى عند إخفاء روابط التنقل إليها.
ما تتضمنه الإجابة السليمة
- يذكر استعلامًا من المقالات العامة المرفقة والنتيجة التي أعادها.
- يفتح النتيجة ويتأكد من أن وجهتها تحتوي على المقال الموعود.
كيف يعمل؟ (اختياري)
ساعد الزوار على العثور على المقال الصحيح
ينبغي أن يربط البحث سؤالًا بصفحة حقيقية، لا أن يحرّك مربع بحث فقط.
توسّع الورشة موقع المدونة بإضافة search.html وفهرس JSON وسكربت متصفح. يبحث في عناوين المقالات ونصوصها ويعيد روابط إلى الصفحات القائمة.
الفهرس كله عام ويُنزل إلى المتصفح. لا تضع فيه مسودات خاصة أو ملاحظات سرية. البحث هنا ميزة تنقل، وليس نظام صلاحيات.
مثال محلول
يعيد البحث عن «image» المقال المتعلق بمصادر صور أصغر. ويعيد البحث عن كلمة غير مرتبطة رسالة واضحة بعدم وجود نتائج، مع إبقاء رابط التصفح متاحًا.
تمرين تقني إضافي
هل يمكن أن تظل مسودة خاصة إذا أخفيت رابط صفحتها لكن أدرجت نصها كاملًا في search-index.json؟
عرض حل نموذجي مشروح
لا. يستطيع أي شخص تنزيل JSON. استبعد المحتوى الخاص من البحث العام وطبّق ضوابط الوصول على أي خادم خلفي خاص فعلًا.
- تدرك أن الفهرس نفسه عام.
- تُبقي المواد الخاصة خارج الملفات العامة.

الخطوة 1 · كيف تضيف بحثًا إلى موقعك
استخدم عبارة مميزة
اختر ما تستطيع تمييزه في المقالة والبحث.
شرح ومثال محلول وتدريب
افهم الفكرة
اختر عبارة قصيرة ومميزة لموضوع المقالة الرابعة المرفقة أو الجديدة. اطلب من المساعد نشر المقالة وتحديث بيانات البحث معها.
لا يعرف البحث تلقائيًا بوجود صفحة لمجرد حفظها. وقد يفوّت البحث البسيط القائم على الكلمات أخطاء الكتابة أو الصياغات غير المألوفة.
مثال عملي
تساعد عبارة مطابقة على تحديد ما إذا كانت المقالة الجديدة قد رُبطت بالبحث أصلًا.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
أي عبارة ستستخدم؟ وهل تستطيع العثور عليها في المقالة المقصودة؟
عرض حل نموذجي مشروح
مثال خطة بحث: «سيحتوي مقالي التدريبي الرابع على العبارة turquoise anchor check. سأطلب من المساعد نشر المقال وإضافة إدخال البحث المطابق معًا، ثم أبحث عن العبارة نفسها».
العثور على الكلمات في مسودة محفوظة لا يثبت ظهور نتيجة في البحث. تحقق أولًا من وجودها في المقال العام المقصود، ثم اختبر البحث العامل.
ما تتضمنه الإجابة السليمة
- يختار عبارة مميزة موجودة فعلًا في المقال الرابع.
- يوضح وجوب تحديث المقال وإدخاله في البحث معًا قبل توقع ظهور النتيجة.
كيف يعمل؟ (اختياري)
طابق الكلمات واعرض نتائج آمنة
اجعل قاعدة المطابقة بسيطة بما يكفي لشرحها واختبارها.
يحوّل السكربت الاستعلام إلى أحرف صغيرة، ويقسمه إلى كلمات، ويشترط وجود كل كلمة في موضع ما من عنوان المقال أو نصه. هذه مطابقة مقاطع نصية، وليست بحثًا دلاليًا أو تصحيحًا للأخطاء الإملائية.
ينشئ الروابط بطرق 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))
);تمرين تقني إضافي
لماذا قد لا يطابق مقال ذو صلة استعلامًا يحتوي على كلمة مكتوبة خطأ؟
عرض حل نموذجي مشروح
المقطع النصي الحرفي غير موجود في نصه. لا يملك البحث الحالي تصحيحًا إملائيًا؛ صحح الاستعلام أو نفّذ بديلًا مختبرًا.
- تصف المطابقة الحرفية المنفذة.
- لا تدعي فشل الطلب أو فهمًا دلاليًا.

الخطوة 2 · كيف تضيف بحثًا إلى موقعك
افحص عدم وجود نتائج وتعطل البحث
تحتاج الحالات المختلفة إلى خطوات تالية مختلفة.
شرح ومثال محلول وتدريب
افهم الفكرة
ابحث عن موضوع غائب وافحص حالة عدم التطابق. لاختبار عدم توفر البيانات، ابدأ بتحميل جديد للصفحة واطلب من المساعد حجب طلب بيانات البحث أو إفشاله محليًا قبل أول بحث. يعيد التطبيق استخدام البيانات بعد تحميلها، لذا فقد لا يكفي حجب طلب لاحق لإعادة إنتاج الفشل المقصود.
ينبغي أن تختلف رسالة عدم العثور على مقال عن رسالة تعطل البحث مؤقتًا. أبقِ الاستعلام متاحًا للتصحيح أو المحاولة مجددًا، وجرّب مسار تصفح كل المقالات البديل. وضح أن الطلب المحجوب عمدًا محاكاة، لا انقطاع حقيقي.
مثال عملي
خطأ الطلب لا يثبت غياب مقالة ذات صلة.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ماذا أظهر كل من اختبار الموضوع الغائب واختبار عدم توفر البحث؟
عرض حل نموذجي مشروح
مثال سجل حالتين: «أعاد موضوع مختلق No matching articles. وفي صفحة حُمّلت من جديد مع حجب طلب بيانات البحث عمدًا، أبلغ البحث بعدم توفره؛ وظل Browse all articles يفتح الفهرس».
التحميل الجديد مهم لأن البحث يحتفظ في الذاكرة بالبيانات التي نجح تحميلها. حجب الطلب بعد تحميل البيانات لا يعيد إنتاج فشل تحميل جديد؛ سجل حدود هذه المحاكاة بصدق.
ما تتضمنه الإجابة السليمة
- يميز نتيجة الموضوع الغائب عن فشل تحميل بيانات البحث.
- يفحص التصحيح أو إعادة المحاولة أو تصفح الجميع في كل حالة، ويوضح أي محاكاة.
كيف يعمل؟ (اختياري)
افصل عدم وجود نتائج عن عدم توافر البحث
فشل تنزيل الفهرس لا يثبت عدم وجود مقال مطابق.
شغّل حالات النجاح والموضوع المفقود والاستعلام الفارغ المرفقة. ثم استخدم أدوات المطوّر لحجب search-index.json وأعد التحميل قبل البحث؛ يخزن السكربت الفهرس المحمّل بنجاح في الذاكرة.
تقدم رسالة الفشل فهرس المقالات. يظل بإمكان الزائر التصفح عند فشل البحث. تحقق من رابط كل نتيجة واختبر النموذج بلوحة المفاتيح.
مثال محلول
تعني «No matching articles» أن فهرسًا صالحًا للاستخدام قد بُحث فيه. وتعني «Search unavailable» أن الحصول على الفهرس أو التحقق منه لم ينجح. تصف الرسالتان دليلين مختلفين.
تمرين تقني إضافي
يعيد طلب JSON الحالة 500. هل ينبغي أن تقول الصفحة إنه لا توجد مقالات مطابقة؟
عرض حل نموذجي مشروح
لا. أبلغ عن عدم توافر البحث واحتفظ برابط التصفح. لا تدّعِ انعدام المطابقات إلا بعد تحميل الفهرس وفحصه بنجاح.
- تميّز فشل النقل عن المطابقات الفارغة.
- تقدم مسار تنقل بديلًا يعمل.

الخطوة 3 · كيف تضيف بحثًا إلى موقعك
أبقِ المقالة الجديدة قابلة للعثور عليها
كرّر مهمة القارئ بعد التعديل.
شرح ومثال محلول وتدريب
افهم الفكرة
أكمل المقالة الرابعة ومدخل البحث المطابق مع مساعدك. أعد التحميل لتستخدم الصفحة بيانات حديثة، وابحث عن العبارة المميزة وافتح المقالة المُعادة.
تحقق أن النتيجة المحمّلة تصل إلى المحتوى الجديد الفعلي. حافظ أيضًا على سلوك عدم العثور والفشل وتصفح الجميع.
مثال عملي
مثال turquoise-anchor المرفق للمقارنة، وليس موضوع كتابة شخصيًا إلزاميًا.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
- public/search-index.jsonتنزيل هذا الملف
- public/search.jsتنزيل هذا الملف
- search-tests.txtتنزيل هذا الملف
- worksheet.htmlتنزيل هذا الملف
- reference/assignment-walkthrough.txtتنزيل هذا الملف
- reference/public/index.htmlتنزيل هذا الملف
- reference/public/blog/contact-anchor-check.htmlتنزيل هذا الملف
- reference/public/search-index.jsonتنزيل هذا الملف
جرّب بنفسك
قدّم المقالة الجديدة ونتائج البحث والفشل التي لاحظتها.
ما المطلوب إنجازه: المقالة الجديدة ومدخل البحث ونتائج العثور وعدم التطابق وعدم التوفر الفعلية.
عرض حل نموذجي مشروح
مثال سجل نهائي: «بعد تحديث المقال الرابع وبيانات البحث، أعاد turquoise anchor check صفحته الجديدة. فتحت النتيجة ووجدت العبارة والشرح الموعودين. وظل الموضوع الغائب يعرض عدم وجود نتائج، كما ظلت محاكاة الفشل بعد تحميل جديد توفر فهرس المقالات».
إذا وُجد المقال المحفوظ ولم يعده البحث، فمسار البحث غير مكتمل. اطلب من المساعد فحص بيانات البحث الحالية والصفحة المحمّلة، بدل اعتبار نتيجة المرجع ملاحظة قمت بها أنت.
ما تتضمنه الإجابة السليمة
- يعيد المقال الجديد عند البحث عن عبارته المميزة، ويفتح الصفحة الصحيحة ذات المحتوى الفعلي.
- يعيد اختبار التعافي من عدم التطابق ومن تعذر البحث بعد تحديث الفهرس.
كيف يعمل؟ (اختياري)
مهمتك: أبقِ البحث متزامنًا مع مقال جديد
نشر صفحة وجعلها قابلة للبحث خطوتان منفصلتان في هذا الموقع الصغير.
أضف مقالًا رابعًا ومدخل فهرس مقابلًا. اختر عبارة موضوع مميزة وتأكد من أنها تعثر على الصفحة الجديدة. أبقِ الوجهة ضمن نمط أسماء ملفات المدونة المسموح.
أزل ذلك المدخل مؤقتًا ولاحظ أن الصفحة لا تزال موجودة لكنها لم تعد تظهر في البحث. يوضح ذلك لماذا قد يولّد موقع أكبر فهرسه تلقائيًا من مصدر المقالات.
يمكن لمقالك الرابع استخدام أي موضوع حقيقي وعبارة مميزة. contact-anchor-check.html و«turquoise anchor check» حالة المقارنة المرفقة فقط، وليسا محتوى مطلوبًا للتسليم. المهم تطابق اسم ملفك الحقيقي والنص القابل للبحث في المقال والفهرس المحمّل.
مثال محلول
يمكن لمولّد مواقع ثابتة إنتاج الصفحات والفهرس من مصدر واحد. في هذه النسخة المدارة يدويًا، يحميك سجل الاختبار من نسيان أحد الجانبين.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
تمرين تقني إضافي
انشر المقال التجريبي الرابع وأثبت أن البحث يعثر على عبارته المميزة.
عرض حل نموذجي مشروح
يستخدم المقال المرجعي الرابع العبارة المميزة «turquoise anchor check». يحتوي مدخل search-index.json المقابل على اسم ملف المدونة الحقيقي ونص ملخص أو متن قابل للبحث؛ تعرض الملفات المرجعية الكاملة الجانبين.
أعد التحميل لمحو الفهرس المخزن مؤقتًا في الذاكرة، وابحث عن العبارة وافتح المقال المُرجع. افحص JSON المحمّل أيضًا: مجرد وضع العبارة في HTML دون تحديث الفهرس لن يجعلها قابلة للبحث.
أعد اختبار موضوع مفقود وتنزيل فهرس محجوب في تبويب جديد أو بعد إعادة التحميل. يجب أن ينتج غياب المطابقات وعدم توافر البحث رسالتين مختلفتين، بينما يظل Browse all articles يعمل.
- تفتح النتيجة المقال الحقيقي المقصود.
- يُفهرس المحتوى الجديد دون تعطيل معالجة الفشل والاستعلام الفارغ.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.