مواد پر جائیں

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 پر ایڈٹ کریں