মডিউল:উইকিউপাত্ত২/নথি

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

এই লুয়া মডিউলটি অনেক বেশি সংখ্যক পাতায় ব্যবহৃত হয়েছে।
বড় ধরনের ব্যাঘাত এবং অপ্রয়োজনীয় সার্ভারের লোড এড়ানোর জন্য, এই মডিউলটির কোন পরিবর্তন প্রথমে এটির /খেলাঘর বা /পরীক্ষা উপপাতায় পরীক্ষা করা উচিত। পরীক্ষিত পরিবর্তন তারপর একটি একক সম্পাদনায় এই পাতায় যোগ করা যাবে। অনুগ্রহ করে কোনো পরিবর্তন প্রয়োগ করার আগে আলাপ পাতায় তা আলোচনা করতে বিবেচনা করুন।

This module is subject to page protection. It is a highly visible module in use by a very large number of pages, or is substituted very frequently. Because vandalism or mistakes would affect many pages, and even trivial editing might cause substantial load on the servers, it is protected from editing.

{{উইকিউপাত্ত}}-এ ব্যবহৃত (সেখানে প্যারামিটারের বিবরণ দেখুন)। মডিউল:উইকিডাটা/কনফিগার ব্যবহার করে কনফিগার করা হয়েছে।

এই মডিউলে কোনো পরিবর্তন করার আগে, অনুগ্রহ করে সেগুলো /খেলাঘর এ পরীক্ষা করে দেখুন। অনুগ্রহ করে মনে রাখবেন যে স্যান্ডবক্সে সবকিছু সঠিকভাবে কাজ করে না।

সাধারণ জ্ঞাতব্য[সম্পাদনা]

এই মডিউলের ফাংশনগুলি সরাসরি কার্ড টেমপ্লেট বা অন্য মডিউলগুলি থেকে কল করার উদ্দেশ্যে নয় যেগুলি এটির এক্সটেনশন ফাংশন নয়৷ কার্ড টেমপ্লেট থেকে কল করতে, {{উইকিউপাত্ত}} টেমপ্লেট বা বৈশিষ্ট্যগুলির জন্য বিশেষায়িত টেমপ্লেটগুলির একটি ব্যবহার করুন। প্রদর্শনের উদ্দেশ্যে উইকিডাটা ফাংশনগুলিকে কল করার জন্য, বেশিরভাগ ক্ষেত্রেই frame:expandTemplate{} কে কল করাই যথেষ্ট যা প্রপার্টি রেন্ডার করার জন্য দায়ী টেমপ্লেটে কল করে। অন্যদিকে, কিছু নির্দিষ্ট মডিউল ফাংশন কল করা (বেশিরভাগই getEntity()) ভবিষ্যতে পছন্দের হয়ে উঠতে পারে। যে কোনো ক্ষেত্রে, এই লুয়া কার্যকারিতা অস্থির বিবেচনা করা উচিত

নিম্নলিখিত অভ্যন্তরীণ ডকুমেন্টেশন বর্ণনা. ফাংশন এবং পরামিতি নাম পরিবর্তন হতে পারে. যখন তারা পরিবর্তন হয়, পরিবর্তনের লেখককে অবশ্যই {{wikidata}} টেমপ্লেট এবং বিশেষ সম্পত্তি টেমপ্লেট আপডেট করতে হবে। অন্য জায়গায় পরিবর্তন, যদি কেউ তা সত্ত্বেও সরাসরি মডিউল ফাংশন কল করে, "ক্র্যাচ" লেখকের বিবেকের উপর থাকে। সুতরাং, একটি {{wikidata}} টেমপ্লেট বা একটি বিশেষ সম্পত্তি টেমপ্লেট কল করার সময়, নিয়ন্ত্রণ ফরম্যাট স্টেটমেন্ট ফাংশনে দেওয়া হয়, যা একটি ফ্রেম গ্রহণ করে। Из frame достаются следующие опции, которые так или иначе передаются в остальные функции:

plain — булевый переключатель (по умолчанию false). Если true, результат совпадает с обычным вызовом {{#property:pNNN}} (по факту им и будет являться)
references — булевый переключатель (по умолчанию true). Если true, после вывода значения параметра дополнительно выводит ссылки на источники, указанные в Викиданных. Для вывода используется Модуль:Sources. Обычно отключается для тех свойств, которые являются «самоописываемыми», например, внешними идентификаторами или ссылками (когда такая ссылка является доказательством своей актуальности), например, идентификаторы IMDb.
value — значение, которое надо выводить вместо значений из Викиданных (используется, если что-то задано уже в карточке в виде т. н. локального свойства)

По умолчанию модуль поддерживает вывод следующих значений без дополнительных настроек:

географические координаты (coordinates)
количественные значения (quantity)
моноязычный текст (monolingualtext)
строки (string)
даты (time)

Остальные типы данных требуют указания функции форматирования значения.

Кастомизация[সম্পাদনা]

Поддерживаются три типа параметров-функций, которые дополнительно указывают, как надо форматировать значения:

property-module, property-function — название модуля и функции модуля, которые отвечают за форматирование вывода массива значений свойства (property) с учётом квалификаторов, ссылок и прочего. Например, оформляет множество выводов в таблицу или график. Характерные примеры:
- вывод таблицы и графика населения в {{wikidata/Population}} и Модуль:Wikidata/Population.
Спецификация функции: function p.…( context, options ), поведение по умолчанию: Модуль:Wikidata#formatPropertyDefault.

claim-module, claim-function — название модуля и функции модуля, которые отвечают за форматирование вывода значения свойства (statement, claim) с учётом квалификаторов, ссылок и прочего. Может, например, дополнительно к основному значению (main snak) вывести значения квалификаторов. Характерные примеры:
- вывод вышестоящих административных единиц и страны в Модуль:Wikidata/Places;
- вывод авторов латинского названия и даты публикации в Модуль:Wikidata/Biology;
- вывод операционной системы и даты релиза в Модуль:Wikidata/Software;
- вывод количества и даты, на которую оно верно, в Модуль:Wikidata/number;
Спецификация функции: function p.…( context, options, statement )

value-module, value-function — название модуля и функции модуля, которые отвечают за форматирование значения (snak, snak data value), в зависимости от контекста, как значений свойства, так и значений квалификатора (если вызывается из claim-module/claim-function). Необходимо для изменения отображения свойства, например, генерации викиссылки вместо простой строки или даже вставки изображения вместо отображения имени файла изображения (так как ссылки на изображения хранятся как строки). Характерные примеры:
- вывод ссылки на Викисклад в Модуль:Wikidata/media
- вывод ссылок на внешние сайты в Модуль:Wikidata/link
Спецификация функции: function p.…( value, options )