Bu Modul:Wikidata/Medals modulunun sənədləşmə səhifəsidir.
Bu moduldan Vikidatadan mükafatların (P166) idxalı və formatlaşdırılması məqsədilə istifadə olunur.
- Mükafat şəkli üçün ilk növbədə piktoqram (P2910), sonra isə lent (P2425) parametrləri yoxlanılır.
- Mükafatın verilmə tarixi (P585) varsa, həmin il tire ilə ayrılaraq başlığa əlavə edilir.
- Piktoqram və ya mükafat lenti müxtəlif dövrlərdə fərqli cür olubsa, başlama (P580) və bitmə (P582) tarixlərinə əsasən təsvir müəyyən edilir.
- Eyni təbiətə malik olan bəzi mükafatlar əvəzlənərək avtomatik digər mükafata yönəldilir (məsələn: "Qızıl ulduz" medalı → Sovet İttifaqı Qəhrəmanı).
- Mükafatın dərəcəsi verilibsə, ona daxili keçid kimi Azərbaycan dilində mövcud olan üst məqaləyə keçid verilir.
- Ölkə adları üçün ölkə (P17) parametrindən istifadə olunur və ölkə adının Azərbaycan dilində P1813 abreviaturu varsa, o göstərilir.
- Əgər mükafatın təsviri yoxdursa, sadəcə kateqoriya şəklində (P2517) əlavə edilir .
- Göstərilən mükafat təsviri tipinə əsasən (piktoqram və ya mükafat lenti) kontur (border) parametri təyin edilir.
- Mükafatların ardıcılığı müvafiq siyahıya uyğun olaraq yenilənir.
formatProperty(context, options)- Cari səhifənin (və ya göstərilən "entity"nin) P166 (mükafat) xüsusiyyətlərinə əsasən bütün mükafatları emal edir və şəkilli, sıralı şəkildə çıxış verir. Modulun əsas funksiyasıdır. Şablon və məlumat qutuları bu funksiyadan istifadə edir.
formatValue(context, options, statement)- Yalnız bir mükafat üçün verilmiş bəyanatı (statement) formatlaşdırır. Bu funksiya, əsasən, fərdi mükafatların göstərilməsi üçün nəzərdə tutulmuşdur.
buildAwardHTML(id, statement)- Mükafatın şəkilli və ya kateqoriya əsaslı HTML çıxışını qurur. Şəkil, il, ölkə və etiket daxil olmaqla bütün lazımi məlumatları birləşdirir.
getImage(entity, awardDate)- Mükafatın piktoqram (P2910) və ya lent (P2425) şəkillərini, tarix aralığına əsaslanaraq düzgün şəkildə seçir. Şəkil ölçüsü və kontur (border) təyinatını da burada müəyyən edir.
getCountryLabel(entity)- Mükafatın aid olduğu ölkənin Azərbaycan dilində qısa və ya tam adını qaytarır. Əgər mükafat başqa mükafatın tərkib hissəsidirsə (P361), o üst elementə baxılır.
shouldAppendCountry(label, country, fullCountry)- Ölkə adı artıq mükafat etiketində varsa, təkrar yazılmasının qarşısını alır.
getAwardYear(statements, id)- Verilmiş bəyanatda (P585) göstərilən tarixdən il çıxararaq başlığa əlavə edir.
getMainValue(claims, property)- Göstərilən xüsusiyyət (property) üçün əsas dəyəri (main snak) qaytarır.
getCategoryWikitext(entity)- Mükafat üçün kateqoriya əlaqəsi (P2517) varsa, onu nəticəyə əlavə edir. Əgər birbaşa tapılmırsa, üst elementdə (P361) axtarır.
wrapWithClaimDiv(html, propertyId, itemId)- HTML çıxışını Vikidataya uyğun "div" strukturuna yerləşdirir.