Jump to content

Модул:families/doc

Аз Wiktionary

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() гирифта шудааст.