মডিউল:SST/নথি

এটি মডিউল:SST-এর জন্য একটি নথির উপপাতা।
এখানে ব্যবহার সংক্রান্ত তথ্য, বিষয়শ্রেণী এবং অন্যান্য সামগ্রী রয়েছে যা মূল মডিউল পাতার অংশ নয়।

ব্যবহৃত লুয়া:

এই মডিউলটি Specific-Source Template System (SSTS)-এর মূল রাউটার হিসেবে কাজ করে। এটি নির্দিষ্ট-উৎস টেমপ্লেটগুলোর জন্য একটি ডাইনামিক র‍্যাপার এবং ডিসপ্যাচার হিসেবে কাজ করে। এটি নির্দিষ্ট প্যারামিটারগুলো গ্রহণ করে, অনুরোধটিকে সঠিক হোস্ট ইঞ্জিনে (যেমন: ইন্টারনেট আর্কাইভ, হাথিট্রাস্ট, বা গুগল বুকস) পাঠিয়ে দেয় এবং ফরম্যাট করা ডেটাগুলো {{cite book}}-এর মতো স্ট্যান্ডার্ড উদ্ধৃতি টেমপ্লেটে পৌঁছে দেয়।

ব্যবহার

উইকিপিডিয়া:SSTS

আর্কিটেকচার এবং ডেটা শার্ডিং

মেমোরিতে একটি বিশাল ডেটা টেবিল লোড করা এড়াতে, কনফিগারেশন ডেটাগুলোকে বর্ণানুক্রমিক উপ-পাতায় বা **শার্ডস**-এ ভাগ করা হয়েছে।

ভ্যালিডেশন: যখন মডিউলটি কল করা হয়, এটি যাচাই করে যে একটি সঠিক হোস্ট কোড (যেমন: IA, Hathi, GBook) এবং বুক কি (Book Key) দেওয়া হয়েছে কি না।
ডেটা রিট্রিভাল (Data Retrieval): এটি বুক কি-র প্রথম অক্ষরটি সংগ্রহ করে (যেমন: "BYZANTINE_SEALS_V1" থেকে "B") এবং mw.loadData() ব্যবহার করে সংশ্লিষ্ট **শার্ডস**-টি (যেমন: মডিউল:SST/শার্ডস/B) লোড করে।
ইঞ্জিন এক্সিকিউশন: এরপর এটি মডিউল:SST/হোস্ট ইঞ্জিন লোড করে এবং চূড়ান্ত URL তৈরির জন্য শার্ডস ডেটা ও ব্যবহারকারীর টেমপ্লেট আর্গুমেন্টগুলো পাঠিয়ে দেয়।
আউটপুট: সংকলিত আর্গুমেন্টগুলো শার্ডস-এ সংজ্ঞায়িত বেস টেমপ্লেটে (ডিফল্ট হিসেবে {{cite book}}) বিন্যস্ত হয়ে প্রদর্শিত হয়।

ত্রুটি ট্র্যাকিং

মডিউলটি একটি ত্রুটি ট্র্যাকিং সিস্টেম ব্যবহার করে:

মারাত্মক এক্সিকিউশন ত্রুটি: যদি মডিউলটি কোনো সিস্টেম ফেইলিয়ার (যেমন: অসমর্থিত হোস্ট ইঞ্জিন) বা নেটিভ CS1 রেড এরর-এর সম্মুখীন হয়, তবে এটি উদ্ধৃতিতে একটি বোল্ড লাল ত্রুটি বার্তা দেখায় এবং পাতাটিকে বিষয়শ্রেণী:এসএসটিএস ত্রুটি ক্যাটাগরিতে যুক্ত করে।
অনুপস্থিত রেকর্ড: যদি কোনো উদ্ধৃতিতে এমন কোনো বুক কি, শার্ডস বা ভলিউম চাওয়া হয় যা ডেটাবেজে নেই, তবে এটি একটি দৃশ্যমান ত্রুটি দেখায় এবং পাতাটিকে বিষয়শ্রেণী:এসএসটিএস প্যারামিটার লজিক ত্রুটি ক্যাটাগরিতে যুক্ত করে।
প্যারামিটার লজিক ত্রুটি: যদি কোনো সম্পাদক এমন প্যারামিটার ব্যবহার করেন যা শার্ডস-এর আর্কিটেকচারের সাথে সাংঘর্ষিক (যেমন: {{cite encyclopedia}}-তে |title= বা |article= যোগ করা), তবে মডিউলটি লাল ত্রুটি এড়াতে স্বয়ংক্রিয়ভাবে এটি সমাধানের চেষ্টা করবে, কিন্তু পাতাটিকে লুকানো ক্যাটাগরি বিষয়শ্রেণী:SSTS parameter logic faults-এ চিহ্নিত করে রাখবে।