Модул:families/doc
This is the documentation page for Модул:families
Ин модул барои гирифтан ва идора кардани оилаҳои забонҳои гуногуни Виклюғат ва иттилооти бо онҳо алоқаманд истифода мешавад. Барои маълумоти бештар Wiktionary:Families нигаред.
Ин модул дастрасӣ ба модулҳои дигарро таъмин мекунад. Барои дастрасӣ ба маълумот аз дохили қолаб, ба Модул:families/templates нигаред.
Худи маълумот дар Модул:families/data нигоҳ дошта мешавад. Ин модул набояд бевосита аз ҷониби ягон модули дигар истифода шавад на, маълумот бояд танҳо тавассути функсияҳои пешниҳодкардаи Module:families дастрас карда шавад.
Ҷустуҷӯ ва дарёфти оилаҳо
вироишМодул як қатор вазифаҳоро содир мекунад, ки барои пайдо кардани оилаҳо истифода мешаванд.
getByCode
вироишgetByCode(code)
Оилаеро пайдо мекунад, ки рамзи он ба рамзи додашуда мувофиқат мекунад. Агар он мавҷуд бошад, он объекти Family
-ро бар мегардонад, ки оиларо намояндагӣ мекунад. Дар акси ҳол, он nil
-ро бармегардонад.
getByCanonicalName
вироишgetByCanonicalName(name)
Оилаеро меҷӯяд, ки номи каноникии он (номе, ки барои муаррифии ин забон дар Викилуғатсия истифода мешавад) бо номи пешниҳодшуда мувофиқат мекунад. Агар он мавҷуд бошад, он объекти Family
бар мегардонад, ки оиларо намояндагӣ мекунад. Дар акси ҳол, он nil
бармегардонад. Номи каноникии оилаҳо бояд ҳамеша беназир бошад (барои ду оила дар Викилуғатсия як номи каноникро мубодила кардан хато аст), бинобар ин ин кафолат дода мешавад, ки ҳадди аксар як натиҷа медиҳад.
Объектҳои оилавӣ
вироишОбъекти Family
аз яке аз функсияҳои дар боло овардашуда баргардонида мешавад. Ин як намояндагии Lua як оила ва маълумоти бо он алоқаманд аст. Он дорои як қатор усулҳое мебошад, ки онҳоро бо истифода аз синтаксиси :
даъват кардан мумкин аст. Барои намуна:
local m_families = require("Module:families")
local fam = m_families.getByCode("ine")
local name = fam:getCanonicalName()
-- "name" will now be "Indo-European"
Family:getCode
вироиш:getCode()
Рамзи оилаи оиларо бармегардонад. Мисол: "ine"
барои забонҳои ҳиндуаврупоӣ.
Family:getCanonicalName
вироиш:getCanonicalName()
Номи каноникии оиларо бармегардонад. Ин номест, ки барои муаррифии он оилаи забонҳо дар Викилуғатсия истифода мешавад ва кафолат дода мешавад, ки танҳо ба он оила хос бошад. Мисол: "Indo-European"
барои забонҳои ҳиндуаврупоӣ.
Family:getDisplayForm
вироиш:getDisplayForm()
Шакли намоиши оиларо бармегардонад. Барои оилаҳо, ин ҳамон арзишест, ки аз ҷониби :getCategoryName("nocap")
баргардонида шудааст, яъне он "забонҳои NAME"-ро мехонад (масалан, "Забонҳои ҳинду-эронӣ"
). Барои забонҳои муқаррарӣ ва этимологӣ, ин ҳамон номи каноникӣ аст ва барои скриптҳо он "скрипти NAME" -ро мехонад (масалан, "хатти арабӣ"
). Матни намоишшудае, ки дар :makeCategoryLink
истифода мешавад, ҳамеша бо шакли намоиш якхела аст.
Family:getAllNames
вироиш:getAllNames()
Ҷадвали ҳамаи номҳоеро, ки оила бо онҳо маълум аст, аз ҷумла номи каноникиро бармегардонад. Номҳо кафолат дода намешавад, ки беназир бошанд, баъзан зиёда аз як оила бо ҳамон ном маълуманд. Мисол: {"Славянӣ", "Славянӣ"}
барои забонҳои славянӣ.
Family:getFamily
вироиш:getFamily()
Объекти Family
барои оилаи волидайне, ки оила ҷузъи он аст, бармегардонад.
Family:getProtoLanguage
вироиш:getProtoLanguage()
Объекти Language
(ниг. Module:languages) барои протозабони ин оила, агар мавҷуд бошад, бар мегардонад.
Family:getCategoryName
вироиш:getCategoryName(nocap)
Номи категорияи асосии он оиларо бармегардонад. Мисол: "Забонҳои олмонӣ"
барои забонҳои олмонӣ, ки категорияашон дар Category:Забонҳои олмонӣ ҷойгир аст.
Агар далели ихтиёрии nocap
дода нашавад, номи оила дар оғози арзиши баргардонидашуда ба ҳарфҳои калон навишта мешавад. Ин капитализатсия барои номҳои категория дуруст аст, аммо на агар номи хонаводагӣ бо ҳарфҳои хурд бошад ва арзиши баргардонидашудаи ин функсия дар мобайни ҷумла истифода шавад. (Масалан, оилаи псевдо бо коди qfa-mix
дорои номи "mixed"
мебошад, ки ҳангоми истифода ҳамчун ҷузъи номи категория Гурӯҳ:Илтиҳотҳое, ки аз забонҳои омехта гирифта шудаанд, вале бояд дар Category:Забонҳои омехта калонҳалф карда шаванд.) Агар шумо дар фикри истифодаи getCategoryName("nocap")
бошед, getDisplayForm()
.
Family:getWikidataItem
вироиш:getWikidataItem()
Объекти Викидотаи он оиларо бармегардонад.
Family:getWikipediaArticle
вироиш:getWikipediaArticle()
Мақолаи Википедияи он оиларо бармегардонад, ки одатан аз :getWikidataItem()
гирифта шудааст.