تخطَّ إلى المحتوى

shamela_search_library: بحث في الكتب التراثية مع التوثيق

معاملات shamela_search_library وحقول نتيجتها، أداة MCP التي تعيد مقاطع عربية حرفية مع الطبعة والصفحة المطبوعة ورابط المكتبة.

في هذه الصفحة

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

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

المعاملات

المعاملمطلوبالنوعملاحظات
queryنعمstringنص عربي فقط. الأفضل لفظ بين علامتي تنصيص؛ ويصلح موضوع أيضًا.
scopeنعمstringأحد اثني عشر اسمًا — انظر اختيار النطاق. لا تعمل هذه الأداة بدونه.
limitلاintegerعدد المقاطع المعادة، من 1 إلى 10. الافتراضي 5.

كون scope مطلوبًا هو أهم ما في هذه الأداة، وتشرح صفحة النطاقات السبب كاملًا: فبلا نطاق ترتّب هذه المكتبة بحسب كثرة ورود الكلمة، فتدفن الكتب التي تريدها فعلًا.

يجب أن يكون الاستعلام بالعربية

المكتبة عربية والفهرس كذلك. والاستعلام الذي لا كلمات عربية فيه يُرفض مباشرة — فهو خطأ في الأداة (isError) لا نتيجة فارغة، وتخبر الرسالة النموذج بما يفعله:

The library is Arabic, so the query must contain Arabic words. Translate the search terms into Arabic and call again, for example «إنما الأعمال بالنيات» for “actions are judged by intentions”.

وينطبق هذا على الإنجليزية (prayer intention) وعلى الحروف اللاتينية المنقولة (innama al-a'mal bil-niyyat) سواء. وإن كان مساعدك ينطلق من سؤال بالإنجليزية فعليه أن يترجم ألفاظ البحث إلى العربية قبل استدعاء هذه الأداة. فلا شيء يترجمها عنه. وأداة search غير المقيّدة بنطاق تسلك السلوك نفسه.

التشكيل لا يؤثر. انما الاعمال بالنيات وإِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ يعيدان النتائج نفسها، فلا حاجة إلى تشكيل استعلام ولا إلى تجريد ما نسخته من تشكيل.

ما يعود

كائن نتيجة فيه المقاطع وبعض السياق عن البحث نفسه:

الحقلالمعنى
passagesالنتائج، موصوفة أدناه.
relaxedToTokenstrue حين لم توجد العبارة بنصها وأجاب بحث ألفاظ أوسع بدلًا منها.
scopeالنطاق الذي جرى البحث فيه، مُعادًا.
booksSearchedعدد الكتب في ذلك النطاق.
totalMatchesإجمالي الصفحات المطابقة، تتلقى منها حتى limit. وقد يكون null في المرحلة الاحتياطية.
noteلا تظهر إلا حين تحتاج النتيجة إلى تنبيه — انظر أدناه.

وكل عنصر في passages:

الحقلالمعنى
bookالعنوان متضمنًا الطبعة، مثل صحيح البخاري - ط السلطانية.
authorاسم المؤلف.
authorDiedسنة الوفاة بالهجري، أو null إن جُهلت.
printedPageالمجلد والصفحة كما تُرقّمهما تلك الطبعة، مثل 1/ 6.
arabicالمقطع نفسه، حرفيًا، بعد إزالة كل الوسوم.
matchedInbody أو footnote أو both أو unknown — موضع العثور على الألفاظ.
matchQualityكيف جرت المطابقة، مثل exact_phrase.
bookId وpageIdمعرّفا الصفحة في الشاملة.
edition وeditor وpublisherالبيانات الببليوغرافية لتلك الطبعة. لا تظهر إلا إذا كانت لدى المكتبة؛ ولا تُخمَّن أبدًا.
sourceUrlhttps://qurangallery.com/maktabah/book/{bookId}/{pageId}، الصفحة نفسها في قارئ المكتبة. انسب النص إلى المكتبة الشاملة عند الاقتباس.

المرحلتان

يجري البحث المرحلة الصارمة أولًا ثم يرجع إلى الاحتياطية:

  1. العبارة بنصها. ألفاظك، بترتيبها، كما كتبتها.
  2. الألفاظ معًا، إن لم تجد العبارة شيئًا — الألفاظ نفسها في أي موضع من الصفحة وبأي ترتيب.

ويُخبرك دائمًا أي المرحلتين أجابت، عبر relaxedToTokens. وهذه الراية ليست حسابات داخلية؛ فهي تغيّر معنى النتيجة، وتتناول قراءة النتيجة كيفية ذلك.

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

مثال تطبيقي

البحث عن إنما الأعمال بالنيات في نطاق hadith-primary يعيد، من بين ما يعيد:

الحقلالقيمة
bookصحيح البخاري - ط السلطانية
authorالبخاري
authorDied256
printedPage1/ 6
matchedInbody
matchQualityexact_phrase
arabic…عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ…

مع booksSearched: 8 وrelaxedToTokens: false — ثمانية مجاميع مثبّتة على طبعات، ووُجدت العبارة بنصها.

و… في البداية مقصودة: فهي تدل على مقطع يبدأ من منتصف جملة، لأن المقتطف نافذة على الصفحة لا الصفحة كلها.

طول المقتطف

تُقيَّد المقاطع بنحو 1,600 حرف عربي وتُقتطع بـ… في آخرها إن زادت. وهذه الأداة تعيد اقتباسات لا كتبًا.

وإن احتجت الصفحة كاملة لا نافذة المطابقة فخذ bookId وpageId من النتيجة ومرّرهما إلى shamela_read (unit: 'page'). وتقرأ shamela_read (unit: 'range') وshamela_read (unit: 'section') أبعد من ذلك — انظر قائمة الأدوات الكاملة.

الخطوات التالية

عدّل هذه الصفحة على GitHub