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 | نتائج، جو نیچے بیان ہیں۔ |
relaxedToTokens | true جب عین عبارت نہ ملی اور اس کی جگہ ڈھیلی لفظی تلاش نے جواب دیا۔ |
scope | جس دائرے میں تلاش ہوئی، واپس دہرایا گیا۔ |
booksSearched | اس دائرے میں کتنی کتابیں تھیں۔ |
totalMatches | کل کتنے صفحات مطابق نکلے، جن میں سے آپ کو limit تک ملے۔ متبادل مرحلے میں null ہو سکتا ہے۔ |
note | صرف اس وقت موجود جب نتیجے کے ساتھ کوئی تنبیہ ضروری ہو — نیچے دیکھیں۔ |
passages کی ہر اندراج:
| فیلڈ | مطلب |
|---|---|
book | عنوان بشمول طباعت، مثلاً صحيح البخاري - ط السلطانية۔ |
author | مصنف کا نام۔ |
authorDied | سنِ وفات ہجری میں، یا نامعلوم ہو تو null۔ |
printedPage | جلد اور صفحہ جیسا کہ اس طباعت کی صفحہ بندی ہے، مثلاً 1/ 6۔ |
arabic | عبارت بذاتِ خود، ہو بہو، تمام مارک اپ ہٹا کر۔ |
matchedIn | body، footnote، both یا unknown — الفاظ کہاں ملے۔ |
matchQuality | مطابقت کیسے ہوئی، مثلاً exact_phrase۔ |
bookId، pageId | صفحے کے شاملہ شناخت کنندگان۔ |
edition، editor، publisher | اس طباعت کا کتابیاتی ڈیٹا۔ صرف تب موجود جب لائبریری کے پاس ہو؛ کبھی اندازے سے نہیں بھرا جاتا۔ |
sourceUrl | https://qurangallery.com/maktabah/book/{bookId}/{pageId}، وہی صفحہ مکتبہ ریڈر میں۔ نقل کرتے وقت مکتبہ شاملہ کا حوالہ دیں۔ |
دو مراحل
تلاش پہلے سخت مرحلہ چلاتی ہے، پھر متبادل پر آتی ہے:
- عین عبارت۔ آپ کے الفاظ، اسی ترتیب میں، جیسے لکھے گئے۔
- الفاظ یکجا، اگر عبارت سے کچھ نہ ملا — وہی الفاظ صفحے پر کہیں بھی، کسی بھی ترتیب میں۔
آپ کو relaxedToTokens کے ذریعے ہمیشہ بتایا جاتا ہے کہ کس نے جواب دیا۔ یہ فلیگ محض حساب کتاب نہیں؛ یہ نتیجے کا مطلب بدل دیتا ہے، اور نتیجہ پڑھنا بتاتا ہے کہ کیسے۔
متبادل مرحلہ اس لیے ہے کہ منقول الفاظ مختلف طباعتوں میں بدل جاتے ہیں۔ إنما الأعمال بالنيات کو سخت عبارت کے طور پر تلاش کرنے سے ایک کتاب ملتی ہے اور صحیح بخاری رہ جاتی ہے، جس میں بالنية چھپا ہے۔ ڈھیلا مرحلہ بخاری، ابن ماجہ، ابو داود اور نسائی کو ڈھونڈ لیتا ہے۔ صرف سخت مرحلہ چلانے سے ایک مشہور اور ثابت شدہ حدیث “نہیں ملی” بن جاتی — جو اس موضوع میں اپنی ذات میں ایک غلط دعویٰ ہے۔
ایک عملی مثال
hadith-primary دائرے میں إنما الأعمال بالنيات تلاش کرنے پر، دوسروں کے ساتھ، یہ ملتا ہے:
| فیلڈ | قدر |
|---|---|
book | صحيح البخاري - ط السلطانية |
author | البخاري |
authorDied | 256 |
printedPage | 1/ 6 |
matchedIn | body |
matchQuality | exact_phrase |
arabic | …عُمَرَ بْنَ الْخَطَّابِ ﵁ عَلَى الْمِنْبَرِ، قَالَ: سَمِعْتُ رَسُولَ اللهِ ﷺ، يَقُولُ: «إِنَّمَا الْأَعْمَالُ بِالنِّيَّاتِ… |
booksSearched: 8 اور relaxedToTokens: false کے ساتھ — ایڈیشن سے بندھے آٹھ مجموعے، اور عین عبارت مل گئی۔
شروع کا … دانستہ ہے: یہ بتاتا ہے کہ عبارت جملے کے بیچ سے شروع ہوتی ہے، کیونکہ اقتباس صفحے کی ایک کھڑکی ہے، پورا صفحہ نہیں۔
اقتباس کی لمبائی
عبارات تقریباً 1,600 عربی حروف تک محدود ہیں اور لمبی ہوں تو آخر میں … کے ساتھ کاٹ دی جاتی ہیں۔ یہ ٹول اقتباسات لوٹاتا ہے، کتابیں نہیں۔
اگر آپ کو مطابق کھڑکی کے بجائے پورا صفحہ چاہیے تو نتیجے سے bookId اور pageId لے کر shamela_read (unit: 'page') کو دیں۔ shamela_read (unit: 'range') اور shamela_read (unit: 'section') مزید آگے پڑھتے ہیں — مکمل ٹول فہرست دیکھیں۔