Модул:Wикидата/док

Izvor: Vojna Enciklopedija
Пређи на навигацију Пређи на претрагу

Ово је документациона подстраница за Модул:Wikidata

Луа еррор: Цаннот цреате процесс: проц_опен(/дев/нулл): фаилед то опен стреам: Оператион нот пермиттед Тхис модуле ис а модифицатион оф тхе оригинал ат Модуле:Сандбоx/Том Моррис wхицх wас цреатед 19 Маy 2013.

Метходс

Тхе модуле "Wикидата" цонтаинс тхе фоллоwинг метходс, тхат аллоw тхе цаллинг сцрипт то ретриеве тхе валуе фор анy пропертy фром Wикидата бy супплyинг тхе пропертy ИД ас тхе фирст параметер:

  • гетВалуе: Ретурнс wики-линкед валуес, иф апплицабле. Алл отхер валуес wилл бе оутпут симилар то {{#property:}}, еxцепт тхат иф валуес wитх преферред ранк еxист, тхен онлy тхеy аре ретурнед. Унлике форматСтатементс фром ру:Модуль:Wикидата, гетВалуе доес нот yет пицк уп анy референцес (сее Модуле талк:Wикидата#Wхy тхе референцес фром Wикидата гет дроппед?).
  • гетРаwВалуе: Ретурнс нон-линкед пропертy валуес анд нумберс wитх тхе тхоусанд сепаратор. Ит алсо ретурнс тхе плаин нумериц валуе оф а пропертy wхицх ис а qуантитy. Алл отхер валуес wилл бе оутпут симилар то {{#property:}}, инцлудинг нормал валуес, евен иф преферред валуес еxист.
  • гетДатеВалуе: Специал метход то ретурн форматтед датес. Тхе дефаулт дате формат ис [даy монтх yеар]; ан оптионал тхирд параметер цан бе аддед фор отхер дате форматс: фор [монтх даy, yеар], адд "мдy"; фор [монтх yеар], адд "мy"; фор yеар онлy, адд "y". А фуртхер оптионал параметер, wхицх муст бе фоуртх, суцх ас "БЦЕ", маy бе аддед то оверриде тхе дефаулт "БЦ" тхат ис суффиxед фор датес БЦ.
  • гетИмагес: Ретурнс алл оф тхе имагес оф а партицулар пропертy, е.г. имаге (П18), Гене Атлас Имаге (П692), етц. Параметерс аре | propertyID | value / FETCH_WIKIDATA / nil | separator (default=space) | size (default=220px). Тхе ретурнед теxт wилл бе ин тхе формат [[File:Filename | size]] фор еацх имаге wитх а селецтабле сизе анд сепаратор (wхицх маy бе хтмл). Иф а пропертy ис супплиед тхат ис нот оф тyпе "цоммонсМедиа", ит wилл ретурн емптy теxт.
  • гетУнитс Тхис такес а пропертyИД wхицх ис а qуантитy ас тхе фирст параметер, анд ретурнс тхе наме оф тхе унитс тхат тхе пропертy ис усинг он тхе цуррент паге. Ит ретурнс емптy иф тхе пропертy ис нот а qуантитy тyпе ор иф тхе валуе ис нот сет. Тхе сецонд параметер маy бе усед то оверриде фетцхинг фром Wикидата, иф ит ис анyтхинг отхер тхан "ФЕТЦХ_WИКИДАТА".
  • гетУнитИД Тхис такес а пропертyИД wхицх ис а qуантитy ас тхе фирст параметер, анд ретурнс тхе QИД оф тхе унитс тхат тхе пропертy ис усинг он тхе цуррент паге. Ит ретурнс емптy иф тхе пропертy ис нот а qуантитy тyпе ор иф тхе валуе ис нот сет. Тхе сецонд параметер маy бе усед то оверриде фетцхинг фром Wикидата, иф ит ис анyтхинг отхер тхан "ФЕТЦХ_WИКИДАТА".

Wикидата qуалифиер валуес (иф пресент) цан бе ретриевед бy тхе фоллоwинг метходс:

  • гетQуалифиерВалуе: ретурнс онлy wики-линкед валуес, иф апплицабле.
  • гетРаwQуалифиерВалуе: ретурнс нон-линкед валуес
  • гетQуалифиерДатеВалуе: ретурнс форматтед датес

Иф тхе пропертy ис нот дефинед ин Wикидата фор тхе артицле тхат инвокес тхис цоде, тхен ан емптy стринг ("") ис ретурнед.

Отхер метходс:

  • пагеИд: ретурнс тхе Wикидата ид (Q…) оф тхе цуррент паге ор нотхинг иф тхе паге ис нот цоннецтед то Wикидата
  • гетТАВалуе: гетс тхе ТА98 (Терминологиа Анатомица фирст едитион 1998) валуес фор пропертy П1323. Ит такес но параметерс анд цонструцтс итс оутпут ас а лист, wитх еацх валуе линкед то ан еxтернал ресоурце. Тхис ис ан еxемплар фор wритинг цаллс тхат неед то ретурн еxтернал линкс.
  • ВиеwСометхинг: гетс анyтхинг ин тхе струцтуред дата, инцлудинг лабелс, десцриптионс, референцес анд интерwики линкс. Сее [1]
  • гетСитеЛинк: гетс наме оф а паге ин гивен ин аргумент wики (лике енwикиqуоте фор Енглисх Wикиqуоте).
  • Думп: спиес тхе струцтуред дата. Ит усес тхе саме аргументс ас ВиеwСометхинг. Трy тхис wитх превиеw онлy то сее ресултс. Тхат хелпс yоу а лот ин девелопинг Луа сцриптс тхат аццесс тхе дата. Иф усед wитхоут аргументс, ит думпс еверyтхинг инцлудинг лабелс, десцриптионс, референцес анд интерwики линкс. Сее [2]
  • гетИмагеЛегенд: ретурнс ан имаге легенд (имаге ис пропертy П18; имаге легенд ис пропертy П2096).
    Цалл ас {{#invoke:Wikidata |getImageLegend | <PARAMETER> | lang=<ISO-639code> |id=<QID>}}
    Ретурнс ПАРАМЕТЕР, унлесс ит ис еqуал то "ФЕТЦХ_WИКИДАТА", фром Итем QИД (еxпенсиве цалл). Иф QИД ис омиттед ор бланк, тхе цуррент артицле ис усед (нот ан еxпенсиве цалл). Иф ланг ис омиттед, ит усес тхе лоцал wики лангуаге, отхерwисе ит усес тхе провидед ИСО-639 лангуаге цоде.
    Тхе лабел ис ретурнед фром тхе фирст имаге wитх 'преферред' ранк; ор фром тхе фирст имаге wитх 'нормал' ранк иф но имаге хас преферред ранк.
  • гетВалуеСхортНаме: ретурнс тхе саме дата ас гетВалуе, бут утилизес тхе пропертy схорт наме ас тхе лабел, иф аваилабле. Тхис аллоwс фор пипед линкс то усе а схортер лабел wхере преферред. Иф схорт наме ис нот сет он тхе итем, тхе нормал лабел ис усед.

Арбитрарy Аццесс

Ас оф 16 Септембер 2015, ит ис ноw поссибле то фетцх дата фром отхер артицлес бy усинг тхеир QИД. Тхе фоллоwинг цалл:

  • {{#invoke:Wikidata|getValueFromID|<QID>|<Property>|FETCH_WIKIDATA}}

wилл до тхе саме ас гетВалуе, бут такес ан еxтра параметер, wхицх ис тхе QИД оф тхе Wикидата итем тхат yоу wант то гет тхе пропертy валуе фром. Фор еxампле:

  • {{#invoke:Wikidata|getValueFromID|Q151973|P26|FETCH_WIKIDATA}}

will fetch a list of the linked values for 'spouse' (P26) from 'Richard Burton' (Q151973) from anywhere in the English Wikipedia.

This means that testing environments may be set up in user space, but remember that these calls are classed as expensive, so please use them as sparingly as possible.

Parameters

  • For the generalized case (getValue), two unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. P19 for birthplace or P26 for spouse). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value.
  • For the generalized unlinked case (getRawValue), two unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. P21 for gender). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value.
  • For the generalized date case (getDateValue), three unnamed parameters are supplied. The first is the ID of the property that is to be retrieved (e.g. P569 for date of birth). The second may be null, "FETCH_WIKIDATA", or any other string, which becomes the returned value. The third is the format that the date should be returned in, either dmy, mdy, my, or y.

Please note that lower-case parameters are no longer supported by the wikibase call: p123, so please check that upper-case, like P123, is used if problems should arise.

Usage

Example: spouse (P26)

  • {{#invoke:Wikidata|getValue|P26|}} = ретурнс нотхинг, со суппрессес тхе дисплаy оф споусе ин ан инфобоx
  • {{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}} = ретурнс тхе линкед валуе(с) оф пропертy П26 (споусе) сторед ин wикидата фор тхе цорреспондинг артицле (е.г. фор артицле Билл Цлинтон, ит ретурнс Хилларy Цлинтон)
  • {{#invoke:Wikidata|getValue|P26|[[Hillary Rodham Clinton]]}} = ретурнс Хилларy Родхам Цлинтон, аллоwинг ан инфобоx то усе а лоцал валуе ратхер тхан тхе валуе сторед ин Wикидата.

Еxампле ин Инфобоx темплате

Инсиде ан инфобоx дефинитион, ит маy бе цаллед лике тхис:

  • | data55 = {{#invoke:Wikidata|getValue|P26|{{{spouse|FETCH_WIKIDATA}}} }}

wхицх цаусес тхе инфобоx то:

  1. нот дисплаy споусе иф тхе инфобоx параметер |spouse ис сет то бе бланк (ас "| spouse ="}
  2. дисплаy тхе линкед валуе(с) фром Wикидата иф тхе инфобоx параметер |spouse ис нот супплиед
  3. дисплаy тхе лоцал инфобоx параметер |spouse иф ит ис супплиед (е.г. "|spouse = Hillary Rodham Clinton")

Оптионаллy, ит цоулд бе цаллед ас:

  • | data55 = {{#invoke:Wikidata|getValue|P26|{{{spouse|}}} }}

wхицх цаусес тхе инфобоx то:

  1. нот дисплаy споусе иф тхе инфобоx параметер |spouse ис сет то бе бланк (ас "| spouse ="}
  2. нот дисплаy споусе иф тхе инфобоx параметер |spouse ис нот супплиед
  3. дисплаy тхе лоцал инфобоx параметер |spouse иф ит ис супплиед (е.г. "|spouse = Hillary Rodham Clinton")
  4. дисплаy тхе линкед валуе(с) фром Wикидата иф тхе инфобоx параметер ис лоцаллy сет то ФЕТЦХ_WИКИДАТА

Сее Модуле:WикидатаИБ фор а модифицатион тхат аллоwс фиелдс, он а пер артицле басис, то бе блацклистед со тхат тхеy невер дисплаy. Ит алсо аллоwс тхе едитор то специфy, он а пер артицле басис, wхицх фиелдс маy бе аутоматицаллy фетцхед фром Wикидата wхен лоцал параметер ис супплиед; тхе дефаулт ис ноне, аллоwинг ан инфобоx то бе модифиед то аццепт Wикидата wитхоут анy цханге ин тхе артицлес усинг тхе инфобоx унтил тхе фунцтионалитy ис енаблед ин тхе артицле.

Еxампле:биртх плаце

Тхис wоркс ин јуст тхе саме wаy ас тхе цаллс абове:

  • {{#invoke:Wikidata|getValue|P19|}} = ретурнс нотхинг, со суппрессес тхе дисплаy оф биртх плаце ин ан инфобоx
  • {{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}} = ретурнс тхе линкед валуе(с) оф пропертy П19 (плаце оф биртх) сторед ин wикидата фор тхе цорреспондинг артицле (е.г. фор артицле Билл Цлинтон, ит ретурнс Хопе, Аркансас)
  • {{#invoke:Wikidata|getValue|P19|[[Hope, Arkansas|Hope]]}} = ретурнс Хопе, аллоwинг ан инфобоx то усе а лоцал валуе ратхер тхан тхе валуе сторед ин Wикидата.

Еxампле:гендер

Wе дон'т wант тхе ретурнед валуе линкед, со усе:

  • - {{#invoke:Wikidata|getRawValue|P21|FETCH_WIKIDATA}}

Еxампле:дате оф биртх

Иф wе wант тхе дате оф биртх ин дмy формат, wе усе:

  • - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|dmy}}

Иф wе wант тхе дате оф биртх ин мдy формат, wе усе:

  • - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|mdy}}

Иф wе wант а yеар оф биртх, wе усе:

  • - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}

Иф wе wант а yеар оф биртх тхат маy бе БЦ, бут схоулд реад "БЦЕ", wе усе:

  • - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y|BCE}}

Еxампле: Линкинг то Wикидата итем

Усе тхе фоллоwинг цоде то јуст ретриеве тхе Q-ИД:

  • - {{#invoke:Wikidata|pageId}}

Линкинг то Wикидата усед тхе усуал Wики маркуп:

  • - [[d:{{#invoke:Wikidata|pageId}}|Name of Link]]

Еxампле: Линкинг то анотхер wики паге

Усе цоде лике тхис то линк то анотхер wики. Енглисх Wикивоyаге ин тхе еxампле:

  • - [[voy:{{#invoke:Wikidata|getSiteLink|enwikivoyage}}|Name of Link]]


Тестинг

Тестинг споусе

Цопy анд пасте тхе фоллоwинг инто анy артицле анд превиеw ит (плеасе дон'т саве!): 

* - {{#invoke:Wikidata|getValue|P26|}}
* - {{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P26|[[Hillary Rodham Clinton]]}}

Ин Билл Цлинтон yоу схоулд гет:


Ин Барацк Обама yоу схоулд гет:


Ин Рицхард Буртон yоу схоулд гет:


Ин Франз Кафка yоу схоулд гет:

Тестинг биртхплаце

Цопy анд пасте тхе фоллоwинг инто анy артицле анд превиеw ит (плеасе дон'т саве!): 

* - {{#invoke:Wikidata|getValue|P19|}}
* - {{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P19|[[Newport]]}}

Трy Wиллиам Еллерy анд цхецк тхат тхе Wикидата цалл цоррецтлy дисамбигуатес.

Тестинг гетВалуе, гетРаwВалуе анд гетДатеВалуе

Цопy анд пасте тхе фоллоwинг инто анy артицле анд превиеw ит (плеасе дон'т саве!): 

* - {{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P27|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P140|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getRawValue|P21|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|dmy}}
* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|mdy}}
* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}

Тхис схоулд ретурн тхе Wикидата валуес фор биртхплаце, споусе, цитизенсхип, религион, гендер, дате оф биртх (тwице) анд yеар оф биртх, иф тхеy еxист. Тхе доб ис фирст ин дмy формат анд тхен ин мдy.

Тестинг датес БЦ/БЦЕ

Цопy анд пасте тхе фоллоwинг инто а схорт сецтион оф артицле суцх ас Хораце #Сее алсо анд превиеw ит (плеасе дон'т саве!): 

* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}
* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y|BCE}}

Тхис схоулд ретурн 65 БЦ анд 65 БЦЕ, респецтивелy.


Преузето из „https://vojnaenciklopedija.com//index.php?title=Модул:Wikidata/док&oldid=19493”