মূল বিষয়বস্তুতে যান

shamela_search_library: উদ্ধৃতিসহ ক্লাসিক্যাল আরবি বইয়ে সার্চ

shamela_search_library-র প্যারামিটার ও ফলাফলের ক্ষেত্র: সংস্করণ, ছাপা পৃষ্ঠা ও মাকতাবাহ লিংকসহ হুবহু আরবি অংশ ফেরত দেওয়া MCP টুল।

এই পাতায়

তিনটি প্যারামিটার। এটি লাইব্রেরির একটি নামযুক্ত অংশে খোঁজে এবং উদ্ধৃতি সংযুক্ত করে অংশগুলো ফেরত দেয়।

এটি ১৫টি টুলের একটি, এবং প্রথমে চেষ্টা করার মতো — এটিই একমাত্র সার্চ যা স্কোপ ছাড়া চলতে অস্বীকার করে এবং কীভাবে মিলিয়েছে তা জানায়। এটি যা পারে না তার জন্য দেখুন পূর্ণ টুল তালিকা।

প্যারামিটার

প্যারামিটারআবশ্যকধরনমন্তব্য
queryহ্যাঁstringশুধু আরবি পাঠ। উদ্ধৃতি চিহ্নে একটি শব্দবিন্যাস সবচেয়ে ভালো কাজ করে; একটি বিষয়ও কাজ করে।
scopeহ্যাঁstringবারোটি নামের একটি — দেখুন স্কোপ বেছে নেওয়া। এই টুল একটি ছাড়া চলবে না।
limitনাintegerফেরত দেওয়ার অংশের সংখ্যা, ১–১০। ডিফল্ট ৫।

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অংশটি নিজেই, হুবহু, সব মার্কআপ সরিয়ে।
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 সহ — আটটি সংস্করণ-স্থির সংকলন, এবং হুবহু বাক্যাংশ পাওয়া গেছে।

শুরুর … ইচ্ছাকৃত: এটি এমন একটি অংশ চিহ্নিত করে যা বাক্যের মাঝখান থেকে শুরু, কারণ উদ্ধৃতাংশটি পৃষ্ঠার একটি জানালা, পুরো পৃষ্ঠা নয়।

উদ্ধৃতাংশের দৈর্ঘ্য

অংশগুলো প্রায় ১,৬০০ আরবি অক্ষরে সীমিত এবং দীর্ঘ হলে শেষে … দিয়ে কাটা হয়। এই টুল উদ্ধৃতি ফেরত দেয়, বই নয়।

মিলে যাওয়া জানালার বদলে পূর্ণ পৃষ্ঠা দরকার হলে ফলাফল থেকে bookId ও pageId নিয়ে shamela_read (unit: 'page')-এ দিন। shamela_read (unit: 'range') ও shamela_read (unit: 'section') আরো এগিয়ে পড়ে — দেখুন পূর্ণ টুল তালিকা।

পরবর্তী ধাপ

GitHub-এ এই পাতা সম্পাদনা করুন