模組:Wikidata
![]() | 此模块的文档不存在、不全面或不能详细描述其功能及/或其代码中的参数。请帮助扩充并改进其文档。 |
![]() | 此模块被引用於約149,000個頁面。 為了避免造成大規模的影響,所有對此模块的編輯應先於沙盒或測試樣例上測試。 測試後無誤的版本可以一次性地加入此模块中,但是修改前請務必於討論頁發起討論。 模板引用數量會自動更新。 |
![]() | 此模块已评为alpha版,可接受第三方输入,并可用于少量页面以检查是否存在问题,但需要受到检查。欢迎提供新功能或修改其输入输出机制的建议。 |
- 英文维基百科中已弃用该模块,并推荐使用Module:WikidataIB或Module:Wd代替。
方法
“Wikidata”模块包含下列方法,将属性ID作为首个参数提供,可从维基数据中检索任何属性的值:
getValue
:以wiki内链形式返回值(如果适用)。其他值的输出类似{{#property:}}
,但如果值有首选等级则值返回有首选等级的值。与w:ru:Модуль:Wikidata的formatStatements
不同,getValue
不获取任何参考资料(另见w:en:Module talk:Wikidata/Archive 1#Why the references from Wikidata get dropped?)。getRawValue
:返回的属性值不加内链,数字使用千位分隔符。将数量属性的数值返回为纯数字。其他值的输出类似{{#property:}}
,包括一般的值,即使存在首选的值。getDateValue
:返回经过格式化的日期。默认格式[日 月 年];可选添加第三个参数来指定格式:[月 日, 年]用"mdy";"my"仅有月和年;"y"则仅有年。A further optional parameter, which must be fourth, such as "BCE", may be added to override the default "BC" that is suffixed for dates BC.getImages
:返回特定属性的所有图像。例如图像 (P18),基因图谱图像 (P692)等。参数为| propertyID | value / FETCH_WIKIDATA / nil | separator (default=space) | size (default=220px)
. The returned text will be in the format [[File:Filename | size]] for each image with a selectable size and separator (which may be html). If a property is supplied that is not of type "commonsMedia", it will return empty text.getUnits
:需要将表示数量的一个属性ID作为第一个参数,返回该属性在当前页面上使用的单位的名称。属性非数量类型或者未设置时返回空。如果第二个参数不是"FETCH_WIKIDATA",则会使用该参数代替从维基数据获取值。getUnitID
:同上,但返回单位的QID。
可以通过以下方法检索维基数据的限定符值(如果存在):
getQualifierValue
:返回有wiki链接(内链)的值,如果适用。getRawQualifierValue
:返回非内链格式的值getQualifierDateValue
:返回格式化后的日期
如果调用此代码的条目在维基数据中没有定义属性,则返回一个空字符串("")。
其他方法:
pageId
:返回当前页面的维基数据ID(QID),如果未链接维基数据则什么也不返回。使用{{#invoke:ResolveEntityId|page}}获取其他页面的QID。getTAValue
:获取P1323属性的TA98值(《解剖学术语》第一版 1998)。它不需要参数,并将其输出构造为列表,每个值都链接到外部资源。这是编写需要返回外部链接的函数的示例。ViewSomething
:获取结构化数据中的任何内容,包括标签、描述、参考资料和跨wiki链接。另见[1]getSiteLink
:获取一个页面在参数指定的某个wiki中的名称(例如"enwikiquote"对应英文维基语录,"arwiki"对应阿拉伯语维基百科)。Dump
:{{#invoke:Wikidata|Dump|claims}}
用来探查结构化数据。参数与ViewSomething相同。仅通过预览查看此调用的结果。这对开发访问数据的Lua脚本大有帮助。如果不带参数使用,会转储所有内容,包括标签、描述、参考资料和跨wiki链接。封装模板另见{{Dump}}。getImageLegend
:返回图像图例(非P18属性,而是P2096属性)。- Call as
{{#invoke:Wikidata |getImageLegend | <PARAMETER> | lang=<ISO-639code> |id=<QID>}}
- Returns PARAMETER, unless it is equal to "FETCH_WIKIDATA", from Item QID (expensive call). If QID is omitted or blank, the current article is used (not an expensive call). If lang is omitted, it uses the local wiki language, otherwise it uses the provided ISO-639 language code.
- The label is returned from the first image with 'preferred' rank; or from the first image with 'normal' rank if no image has preferred rank.
- Call as
getValueShortName
:与getValue返回的数据相同,但尽可能运用简称属性作为标签。这样可以让管道链接首选使用较短的文字标签。如果项没有短名称,则使用普通的标签。
访问其他QID
2015年9月16日起,可以通过其他条目的QID获取其他条目的数据。 调用如下:
{{#invoke:Wikidata|getValueFromID|<QID>|<属性>|FETCH_WIKIDATA}}
与getValue相同,但使用一个额外的参数表示要获取属性值的QID。 例如:
{{#invoke:Wikidata|getValueFromID|{{Get QID|理查德·伯顿}}|P26|FETCH_WIKIDATA}}
将从本维基百科中的标题为理查德·伯顿的页面对应的维基数据项(理查德·伯顿 (Q151973))中获取'配偶'(P26)列表,以内链形式展示。
如此,可以在用户命名空间中设置测试环境,但请注意,这些是“高成本”调用,请不要过度使用。
参数
- 对一般用法(getValue),提供两个未命名参数。第一个是要检索的属性ID(例如P19对应出生地)。第二个参数可能为空、"FETCH_WIKIDATA",或者将作为返回值的其他字符串。
- 对于一般的不加内链用法(getRawValue),提供两个未命名参数。第一个是要检索的属性ID(例如P21对应性别)。第二个参数可能为空、"FETCH_WIKIDATA",或者将作为返回值的其他字符串。
- 对于一般的日期用法(getDateValue),提供三个未命名参数。第一个是要检索的属性ID(例如P569对应出生日期)。第二个参数可能为空、"FETCH_WIKIDATA",或者将作为返回值的其他字符串。第三个参数是返回的日期格式,可能为dmy, mdy, my或y(另见实际源码)。
请注意,wikibase调用不再支持小写参数:p123,因此如果出现问题,检查是否正确使用了大写参数(如P123)。
用法
例子:配偶 (P26)
{{#invoke:Wikidata|getValue|P26|}}
= 不返回任何内容{{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}}
= 返回内链形式的维基数据中存储的P26(配偶)属性{{#invoke:Wikidata|getValue|P26|[[Hillary Rodham Clinton]]}}
= 返回Hillary Rodham Clinton,即允许信息框使用本地自定义的值代替维基数据中的值。
信息框模板中使用
信息框的定义中可以这样调用:
| data55 = {{#invoke:Wikidata|getValue|P26|{{{spouse|FETCH_WIKIDATA}}} }}
使信息框变为:
- 信息框参数
|spouse
设为空(即"| spouse ="
)时,不显示spouse - 未提供信息框参数
|spouse
时,根据维基数据内容显示内链形式的一个或多个值 - 本地提供信息框参数时,显示本地提供的参数
|spouse
。例如"|spouse = Hillary Rodham Clinton"
另一种方式:
| data55 = {{#invoke:Wikidata|getValue|P26|{{{spouse|}}} }}
使信息框变为:
- 信息框参数
|spouse
设为空(即"| spouse ="
)时,不显示spouse - 未提供信息框参数
|spouse
时,不显示spouse - 本地提供信息框参数时,显示本地提供的参数
|spouse
。例如"|spouse = Hillary Rodham Clinton"
- 本地将信息框参数设为FETCH_WIKIDATA时,根据维基数据内容显示内链形式的一个或多个值
另见Module:WikidataIB版本,支持在每个条目上用本地参数定义:不显示的参数(黑名单);仅从维基数据自动获取哪些参数(白名单)。用它可以修改信息框而不对使用信息框的条目内容和效果产生任何修改,直至在条目中明确启用相应参数。
例子:出生地
方式如上所述:
{{#invoke:Wikidata|getValue|P19|}}
= 不返回任何内容{{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}}
= 返回内链形式的维基数据中存储的P19(出生地)属性,指向对应条目{{#invoke:Wikidata|getValue|P19|[[Hope, Arkansas|Hope]]}}
= 返回Hope,即允许信息框使用本地自定义的值代替维基数据中的值。
例子:性别
不希望返回内链形式的性别,因此使用:
- -
{{#invoke:Wikidata|getRawValue|P21|FETCH_WIKIDATA}}
例子:出生日期
使用dmy格式的出生日期则使用:
- -
{{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|dmy}}
使用mdy格式的出生日期则使用:
- -
{{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|mdy}}
仅获取出生年份:
- -
{{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}
获取出生年份(BC)但希望显示为BCE:
- -
{{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y|BCE}}
例子:链接到一个维基数据项
使用下列代码检索QID:
- -
{{#invoke:Wikidata|pageId}}
用wiki语法的内链链接到维基数据:
- -
[[d:{{#invoke:Wikidata|pageId}}|Name of Link]]
例子:链接到另一个wiki页面
链接到另一个wiki站点,此例为英文维基导游:
- -
[[voy:{{#invoke:Wikidata|getSiteLink|enwikivoyage}}|Name of Link]]
测试
配偶
复制并粘贴下列代码到任何条目并预览(请勿保存!):
* - {{#invoke:Wikidata|getValue|P26|}} * - {{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}} * - {{#invoke:Wikidata|getValue|P26|[[希拉里·克林顿]]}}
在比尔·克林顿中可以看到:
但在贝拉克·奥巴马中:
在理查德·伯顿中:
在弗朗茨·卡夫卡中则是:
- -
- -
- - 希拉里·克林顿
出生地
复制并粘贴下列代码到任何条目并预览(请勿保存!):
* - {{#invoke:Wikidata|getValue|P19|}} * - {{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}} * - {{#invoke:Wikidata|getValue|P19|[[纽波特]]}}
在威廉·埃勒里中尝试,看到维基数据如何正确的消歧义。
测试getValue、getRawValue及getDateValue
复制并粘贴下列代码到任何条目并预览(请勿保存!):
* - {{#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}}
如果存在,这分别会返回出生地、配偶、国籍、宗教、性别、出生日期(两种格式)、出生年份。
另见
- Module:WikidataIB,用于信息框中处理维基数据
-- vim: set noexpandtab ft=lua ts=4 sw=4:require('strict')localp={}localdebug=false-------------------------------------------------------------------------------- module local variables and functionslocalwiki={langcode=mw.language.getContentLanguage().code}-- internationalisationlocali18n={["errors"]={["property-not-found"]="Property not found.",["entity-not-found"]="Wikidata entity not found.",["unknown-claim-type"]="Unknown claim type.",["unknown-entity-type"]="Unknown entity type.",["qualifier-not-found"]="Qualifier not found.",["site-not-found"]="Wikimedia project not found.",["unknown-datetime-format"]="Unknown datetime format.",["local-article-not-found"]="Article is not yet available in this wiki."},["datetime"]={-- $1 is a placeholder for the actual number[0]="$1 billion years",-- precision: billion years[1]="$100 million years",-- precision: hundred million years[2]="$10 million years",-- precision: ten million years[3]="$1 million years",-- precision: million years[4]="$100,000 years",-- precision: hundred thousand years[5]="$10,000 years",-- precision: ten thousand years[6]="$1 millennium",-- precision: millennium[7]="$1 century",-- precision: century[8]="$1s",-- precision: decade-- the following use the format of #time parser function[9]="Y",-- precision: year,[10]="F Y",-- precision: month[11]="F j, Y",-- precision: day[12]="F j, Y ga",-- precision: hour[13]="F j, Y g:ia",-- precision: minute[14]="F j, Y g:i:sa",-- precision: second["beforenow"]="$1 BCE",-- how to format negative numbers for precisions 0 to 5["afternow"]="$1 CE",-- how to format positive numbers for precisions 0 to 5["bc"]='$1 "BCE"',-- how print negative years["ad"]="$1",-- how print positive years-- the following are for function getDateValue() and getQualifierDateValue()["default-format"]="dmy",-- default value of the #3 (getDateValue) or-- #4 (getQualifierDateValue) argument["default-addon"]="BC",-- default value of the #4 (getDateValue) or-- #5 (getQualifierDateValue) argument["prefix-addon"]=false,-- set to true for languages put "BC" in front of the-- datetime string; or the addon will be suffixed["addon-sep"]=" ",-- separator between datetime string and addon (or inverse)["format"]=-- options of the 3rd argument{["mdy"]="F j, Y",["my"]="F Y",["y"]="Y",["dmy"]="j F Y",["ymd"]="Y-m-d",["ym"]="Y-m"}},["monolingualtext"]='<span lang="%language">%text</span>',["warnDump"]="[[Category:Called function 'Dump' from module Wikidata]]",["ordinal"]={[1]="st",[2]="nd",[3]="rd",["default"]="th"}}--require("Module:i18n").loadI18n("Module:Wikidata/i18n", i18n)-- got idea from [[:w:Module:Wd]]localmodule_title;if...==nilthenmodule_title=mw.getCurrentFrame():getTitle()elsemodule_title=...endrequire('Module:i18n').loadI18n(module_title..'-i18n',i18n)-- this function needs to be internationalised along with the above:-- takes cardinal numer as a numeric and returns the ordinal as a string-- we need three exceptions in English for 1st, 2nd, 3rd, 21st, .. 31st, etc.localfunctionmakeOrdinal(cardinal)localordsuffix=i18n.ordinal.defaultifcardinal%10==1thenordsuffix=i18n.ordinal[1]elseifcardinal%10==2thenordsuffix=i18n.ordinal[2]elseifcardinal%10==3thenordsuffix=i18n.ordinal[3]end-- In English, 1, 21, 31, etc. use 'st', but 11, 111, etc. use 'th'-- similarly for 12 and 13, etc.if(cardinal%100==11)or(cardinal%100==12)or(cardinal%100==13)thenordsuffix=i18n.ordinal.defaultendreturntostring(cardinal)..ordsuffixendlocalfunctionprintError(code)return'<span class="error">'..(i18n.errors[code]orcode)..'</span>'endlocalfunctionparseDateFormat(f,timestamp,addon,prefix_addon,addon_sep)localyear_suffixlocaltstr=""locallang_obj=mw.language.new(wiki.langcode)localf_parts=mw.text.split(f,'Y',true)foridx,f_partinpairs(f_parts)doyear_suffix=''ifstring.match(f_part,"x[mijkot]$")then-- for non-Gregorian yearf_part=f_part..'Y'elseifidx<#f_partsthen-- supress leading zeros in yearyear_suffix=lang_obj:formatDate('Y',timestamp)year_suffix=string.gsub(year_suffix,'^0+','',1)endtstr=tstr..lang_obj:formatDate(f_part,timestamp)..year_suffixendifaddon~=""andprefix_addonthenreturnaddon..addon_sep..tstrelseifaddon~=""thenreturntstr..addon_sep..addonelsereturntstrendendlocalfunctionparseDateValue(timestamp,date_format,date_addon)localprefix_addon=i18n["datetime"]["prefix-addon"]localaddon_sep=i18n["datetime"]["addon-sep"]localaddon=""-- check for negative dateifstring.sub(timestamp,1,1)=='-'thentimestamp='+'..string.sub(timestamp,2)addon=date_addonendlocal_date_format=i18n["datetime"]["format"][date_format]if_date_format~=nilthenreturnparseDateFormat(_date_format,timestamp,addon,prefix_addon,addon_sep)elsereturnprintError("unknown-datetime-format")endend-- This local function combines the year/month/day/BC/BCE handling of parseDateValue{}-- with the millennium/century/decade handling of formatDate()localfunctionparseDateFull(timestamp,precision,date_format,date_addon)localprefix_addon=i18n["datetime"]["prefix-addon"]localaddon_sep=i18n["datetime"]["addon-sep"]localaddon=""-- check for negative dateifstring.sub(timestamp,1,1)=='-'thentimestamp='+'..string.sub(timestamp,2)addon=date_addonend-- get the next four characters after the + (should be the year now in all cases)-- ok, so this is dirty, but let's get it working firstlocalintyear=tonumber(string.sub(timestamp,2,5))ifintyear==0andprecision<=9thenreturn""end-- precision is 10000 years or moreifprecision<=5thenlocalfactor=10^((5-precision)+4)localy2=math.ceil(math.abs(intyear)/factor)localrelative=mw.ustring.gsub(i18n.datetime[precision],"$1",tostring(y2))ifaddon~=""then-- negative daterelative=mw.ustring.gsub(i18n.datetime.beforenow,"$1",relative)elserelative=mw.ustring.gsub(i18n.datetime.afternow,"$1",relative)endreturnrelativeend-- precision is decades (8), centuries (7) and millennia (6)localera,cardifprecision==6thencard=math.floor((intyear-1)/1000)+1era=mw.ustring.gsub(i18n.datetime[6],"$1",makeOrdinal(card))endifprecision==7thencard=math.floor((intyear-1)/100)+1era=mw.ustring.gsub(i18n.datetime[7],"$1",makeOrdinal(card))endifprecision==8thenera=mw.ustring.gsub(i18n.datetime[8],"$1",tostring(math.floor(math.abs(intyear)/10)*10))endiferathenifaddon~=""thenera=mw.ustring.gsub(mw.ustring.gsub(i18n.datetime.bc,'"',""),"$1",era)elseera=mw.ustring.gsub(mw.ustring.gsub(i18n.datetime.ad,'"',""),"$1",era)endreturneraendlocal_date_format=i18n["datetime"]["format"][date_format]if_date_format~=nilthen-- check for precision is year and override supplied date_formatifprecision==9then_date_format=i18n["datetime"][9]endreturnparseDateFormat(_date_format,timestamp,addon,prefix_addon,addon_sep)elsereturnprintError("unknown-datetime-format")endend-- the "qualifiers" and "snaks" field have a respective "qualifiers-order" and "snaks-order" field-- use these as the second parameter and this function instead of the built-in "pairs" function-- to iterate over all qualifiers and snaks in the intended order.localfunctionorderedpairs(array,order)ifnotorderthenreturnpairs(array)end-- return iterator functionlocali=0returnfunction()i=i+1iforder[i]thenreturnorder[i],array[order[i]]endendend-- precision: 0 - billion years, 1 - hundred million years, ..., 6 - millennia, 7 - century, 8 - decade, 9 - year, 10 - month, 11 - day, 12 - hour, 13 - minute, 14 - secondlocalfunctionnormalizeDate(date)date=mw.text.trim(date,"+")-- extract yearlocalyearstr=mw.ustring.match(date,"^\-?%d+")localyear=tonumber(yearstr)-- remove leading zeros of yearreturnyear..mw.ustring.sub(date,#yearstr+1),yearendlocalfunctionformatDate(date,precision,timezone)precision=precisionor11localdate,year=normalizeDate(date)ifyear==0andprecision<=9thenreturn""end-- precision is 10000 years or moreifprecision<=5thenlocalfactor=10^((5-precision)+4)localy2=math.ceil(math.abs(year)/factor)localrelative=mw.ustring.gsub(i18n.datetime[precision],"$1",tostring(y2))ifyear<0thenrelative=mw.ustring.gsub(i18n.datetime.beforenow,"$1",relative)elserelative=mw.ustring.gsub(i18n.datetime.afternow,"$1",relative)endreturnrelativeend-- precision is decades, centuries and millennialocaleraifprecision==6thenera=mw.ustring.gsub(i18n.datetime[6],"$1",tostring(math.floor((math.abs(year)-1)/1000)+1))endifprecision==7thenera=mw.ustring.gsub(i18n.datetime[7],"$1",tostring(math.floor((math.abs(year)-1)/100)+1))endifprecision==8thenera=mw.ustring.gsub(i18n.datetime[8],"$1",tostring(math.floor(math.abs(year)/10)*10))endiferathenifyear<0thenera=mw.ustring.gsub(mw.ustring.gsub(i18n.datetime.bc,'"',""),"$1",era)elseifyear>0thenera=mw.ustring.gsub(mw.ustring.gsub(i18n.datetime.ad,'"',""),"$1",era)endreturneraend-- precision is yearifprecision==9thenreturnyearend-- precision is less than yearsifprecision>9then--[[ the following code replaces the UTC suffix with the given negated timezone to convert the global time to the given local time timezone = tonumber(timezone) if timezone and timezone ~= 0 then timezone = -timezone timezone = string.format("%.2d%.2d", timezone / 60, timezone % 60) if timezone[1] ~= '-' then timezone = "+" .. timezone end date = mw.text.trim(date, "Z") .. " " .. timezone end ]]--localformatstr=i18n.datetime[precision]ifyear==0thenformatstr=mw.ustring.gsub(formatstr,i18n.datetime[9],"")elseifyear<0then-- Mediawiki formatDate doesn't support negative yearsdate=mw.ustring.sub(date,2)formatstr=mw.ustring.gsub(formatstr,i18n.datetime[9],mw.ustring.gsub(i18n.datetime.bc,"$1",i18n.datetime[9]))elseifyear>0andi18n.datetime.ad~="$1"thenformatstr=mw.ustring.gsub(formatstr,i18n.datetime[9],mw.ustring.gsub(i18n.datetime.ad,"$1",i18n.datetime[9]))endreturnmw.language.new(wiki.langcode):formatDate(formatstr,date)endendlocalfunctionprintDatavalueEntity(data,parameter)-- data fields: entity-type [string], numeric-id [int, Wikidata id]localidifdata["entity-type"]=="item"thenid="Q"..data["numeric-id"]elseifdata["entity-type"]=="property"thenid="P"..data["numeric-id"]elsereturnprintError("unknown-entity-type")endifparameterthenifparameter=="link"thenlocallinkTarget=mw.wikibase.sitelink(id)locallinkName=mw.wikibase.label(id)iflinkTargetthen-- if there is a local Wikipedia article link to it using the label or the article titlereturn"[["..linkTarget.."|"..(linkNameorlinkTarget).."]]"else-- if there is no local Wikipedia article output the label or link to the Wikidata object to let the user input a proper labeliflinkNamethenreturnlinkNameelsereturn"[[:d:"..id.."|"..id.."]]"endendelsereturndata[parameter]endelsereturnmw.wikibase.label(id)oridendendlocalfunctionprintDatavalueTime(data,parameter)-- data fields: time [ISO 8601 time], timezone [int in minutes], before [int], after [int], precision [int], calendarmodel [wikidata URI]-- precision: 0 - billion years, 1 - hundred million years, ..., 6 - millennia, 7 - century, 8 - decade, 9 - year, 10 - month, 11 - day, 12 - hour, 13 - minute, 14 - second-- calendarmodel: e.g. http://www.wikidata.org/entity/Q1985727 for the proleptic Gregorian calendar or http://www.wikidata.org/wiki/Q11184 for the Julian calendar]ifparameterthenifparameter=="calendarmodel"thendata.calendarmodel=mw.ustring.match(data.calendarmodel,"Q%d+")-- extract entity id from the calendar model URIelseifparameter=="time"thendata.time=normalizeDate(data.time)endreturndata[parameter]elsereturnformatDate(data.time,data.precision,data.timezone)endendlocalfunctionprintDatavalueMonolingualText(data,parameter)-- data fields: language [string], text [string]ifparameterthenreturndata[parameter]elselocalresult=mw.ustring.gsub(mw.ustring.gsub(i18n.monolingualtext,"%%language",data["language"]),"%%text",data["text"])returnresultendendlocalfunctionfindClaims(entity,property)ifnotpropertyornotentityornotentity.claimsthenreturnendifmw.ustring.match(property,"^P%d+$")then-- if the property is given by an id (P..) access the claim list by this idreturnentity.claims[property]elseproperty=mw.wikibase.resolvePropertyId(property)ifnotpropertythenreturnendreturnentity.claims[property]endendlocalfunctiongetSnakValue(snak,parameter)ifsnak.snaktype=="value"then-- call the respective snak parserifsnak.datavalue.type=="string"thenreturnsnak.datavalue.valueelseifsnak.datavalue.type=="globecoordinate"thenreturnprintDatavalueCoordinate(snak.datavalue.value,parameter)elseifsnak.datavalue.type=="quantity"thenreturnprintDatavalueQuantity(snak.datavalue.value,parameter)elseifsnak.datavalue.type=="time"thenreturnprintDatavalueTime(snak.datavalue.value,parameter)elseifsnak.datavalue.type=="wikibase-entityid"thenreturnprintDatavalueEntity(snak.datavalue.value,parameter)elseifsnak.datavalue.type=="monolingualtext"thenreturnprintDatavalueMonolingualText(snak.datavalue.value,parameter)endendreturnmw.wikibase.renderSnak(snak)endlocalfunctiongetQualifierSnak(claim,qualifierId)-- a "snak" is Wikidata terminology for a typed key/value pair-- a claim consists of a main snak holding the main information of this claim,-- as well as a list of attribute snaks and a list of references snaksifqualifierIdthen-- search the attribute snak with the given qualifier as keyifclaim.qualifiersthenlocalqualifier=claim.qualifiers[qualifierId]ifqualifierthenreturnqualifier[1]endendreturnnil,printError("qualifier-not-found")else-- otherwise return the main snakreturnclaim.mainsnakendendlocalfunctiongetValueOfClaim(claim,qualifierId,parameter)localerrorlocalsnaksnak,error=getQualifierSnak(claim,qualifierId)ifsnakthenreturngetSnakValue(snak,parameter)elsereturnnil,errorendendlocalfunctiongetReferences(frame,claim)localresult=""-- traverse through all referencesforrefinpairs(claim.referencesor{})dolocalrefparts-- traverse through all parts of the current referenceforsnakkey,snakvalinorderedpairs(claim.references[ref].snaksor{},claim.references[ref]["snaks-order"])doifrefpartsthenrefparts=refparts..", "elserefparts=""end-- output the label of the property of the reference part, e.g. "imported from" for P143refparts=refparts..tostring(mw.wikibase.label(snakkey))..": "-- output all values of this reference part, e.g. "German Wikipedia" and "English Wikipedia" if the referenced claim was imported from both sitesforsnakidx=1,#snakvaldoifsnakidx>1thenrefparts=refparts..", "endrefparts=refparts..getSnakValue(snakval[snakidx])endendifrefpartsthenresult=result..frame:extensionTag("ref",refparts)endendreturnresultendlocalfunctionparseInput(frame)localqid=frame.args.qidifqidand(#qid==0)thenqid=nilendlocalpropertyID=mw.text.trim(frame.args[1]or"")localinput_parm=mw.text.trim(frame.args[2]or"")ifinput_parm~="FETCH_WIKIDATA"thenreturnfalse,input_parm,nil,nilendlocalentity=mw.wikibase.getEntityObject(qid)localclaimsifentityandentity.claimsthenclaims=entity.claims[propertyID]ifnotclaimsthenreturnfalse,"",nil,nilendelsereturnfalse,"",nil,nilendreturntrue,entity,claims,propertyIDendlocalfunctionisType(claims,type)returnclaims[1]andclaims[1].mainsnak.snaktype=="value"andclaims[1].mainsnak.datavalue.type==typeendlocalfunctiongetValue(entity,claims,propertyID,delim,labelHook)iflabelHook==nilthenlabelHook=function(qnumber)returnnil;endendifisType(claims,"wikibase-entityid")thenlocalout={}fork,vinpairs(claims)dolocalqnumber="Q"..v.mainsnak.datavalue.value["numeric-id"]localsitelink=mw.wikibase.sitelink(qnumber)locallabel=labelHook(qnumber)ormw.wikibase.label(qnumber)orqnumberifsitelinkthenout[#out+1]="[["..sitelink.."|"..label.."]]"elseout[#out+1]="[[:d:"..qnumber.."|"..label.."]]<abbr title='"..i18n["errors"]["local-article-not-found"].."'>[*]</abbr>"endendreturntable.concat(out,delim)else-- just return best valuesreturnentity:formatPropertyValues(propertyID).valueendend-------------------------------------------------------------------------------- module global functionsifdebugthenfunctionp.inspectI18n(frame)localval=i18nfor_,keyinpairs(frame.args)dokey=mw.text.trim(key)val=val[key]endreturnvalendendfunctionp.descriptionIn(frame)locallangcode=frame.args[1]localid=frame.args[2]-- return description of a Wikidata entity in the given language or the default language of this Wikipedia sitereturnmw.wikibase.getEntityObject(id).descriptions[langcodeorwiki.langcode].valueendfunctionp.labelIn(frame)locallangcode=frame.args[1]localid=frame.args[2]-- return label of a Wikidata entity in the given language or the default language of this Wikipedia sitereturnmw.wikibase.getEntityObject(id).labels[langcodeorwiki.langcode].valueend-- This is used to get a value, or a comma separated list of them if multiple values existp.getValue=function(frame)localdelimdefault="、"-- **internationalise later**localdelim=frame.args.delimiteror""delim=string.gsub(delim,'"','')if#delim==0thendelim=delimdefaultendlocalgo,errorOrentity,claims,propertyID=parseInput(frame)ifnotgothenreturnerrorOrentityendreturngetValue(errorOrentity,claims,propertyID,delim)end-- Same as above, but uses the short name property for label if available.p.getValueShortName=function(frame)localgo,errorOrentity,claims,propertyID=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentity-- if wiki-linked value output as link if possiblelocalfunctionlabelHook(qnumber)locallabellocalclaimEntity=mw.wikibase.getEntity(qnumber)ifclaimEntity~=nilthenifclaimEntity.claims.P1813thenfork2,v2inpairs(claimEntity.claims.P1813)dofor_,variantinipairs{"zh","zh-hans","zh-hant","zh-cn","zh-hk","zh-mo","zh-sg","zh-tw"}doifv2.mainsnak.datavalue.value.language==variantthenlabel=v2.mainsnak.datavalue.value.textendendendendendiflabel==nilorlabel==""thenreturnnilendreturnlabelendreturngetValue(errorOrentity,claims,propertyID,", ",labelHook);end-- This is used to get a value, or a comma separated list of them if multiple values exist-- from an arbitrary entry by using its QID.-- Use : {{#invoke:Wikidata|getValueFromID|<ID>|<Property>|FETCH_WIKIDATA}}-- E.g.: {{#invoke:Wikidata|getValueFromID|Q151973|P26|FETCH_WIKIDATA}} - to fetch value of 'spouse' (P26) from 'Richard Burton' (Q151973)-- Please use sparingly - this is an *expensive call*.p.getValueFromID=function(frame)localitemID=mw.text.trim(frame.args[1]or"")localpropertyID=mw.text.trim(frame.args[2]or"")localinput_parm=mw.text.trim(frame.args[3]or"")ifinput_parm=="FETCH_WIKIDATA"thenlocalentity=mw.wikibase.getEntity(itemID)localclaimsifentityandentity.claimsthenclaims=entity.claims[propertyID]endifclaimsthenreturngetValue(entity,claims,propertyID,", ")elsereturn""endelsereturninput_parmendendlocalfunctiongetQualifier(frame,outputHook)localpropertyID=mw.text.trim(frame.args[1]or"")localqualifierID=mw.text.trim(frame.args[2]or"")localinput_parm=mw.text.trim(frame.args[3]or"")ifinput_parm=="FETCH_WIKIDATA"thenlocalentity=mw.wikibase.getEntityObject()ifentity.claims[propertyID]~=nilthenlocalout={}fork,vinpairs(entity.claims[propertyID])dofork2,v2inpairs(v.qualifiers[qualifierID])doifv2.snaktype=='value'thenout[#out+1]=outputHook(v2);endendendreturntable.concat(out,"、"),trueelsereturn"",falseendelsereturninput_parm,falseendendp.getQualifierValue=function(frame)localfunctionoutputValue(value)localqnumber="Q"..value.datavalue.value["numeric-id"]if(mw.wikibase.sitelink(qnumber))thenreturn"[["..mw.wikibase.sitelink(qnumber).."]]"elsereturn"[[:d:"..qnumber.."|"..qnumber.."]]<abbr title='"..i18n["errors"]["local-article-not-found"].."'>[*]</abbr>"endendreturn(getQualifier(frame,outputValue))end-- This is used to get a value like 'male' (for property p21) which won't be linked and numbers without the thousand separatorsp.getRawValue=function(frame)localgo,errorOrentity,claims,propertyID=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentitylocalresult=entity:formatPropertyValues(propertyID,mw.wikibase.entity.claimRanks).value-- if number type: remove thousand separators, bounds and unitsifisType(claims,"quantity")thenresult=mw.ustring.gsub(result,"(%d),(%d)","%1%2")result=mw.ustring.gsub(result,"(%d)±.*","%1")endreturnresultend-- This is used to get the unit name for the numeric value returned by getRawValuep.getUnits=function(frame)localgo,errorOrentity,claims,propertyID=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentitylocalresult=entity:formatPropertyValues(propertyID,mw.wikibase.entity.claimRanks).valueifisType(claims,"quantity")thenresult=mw.ustring.sub(result,mw.ustring.find(result," ")+1,-1)endreturnresultend-- This is used to get the unit's QID to use with the numeric value returned by getRawValuep.getUnitID=function(frame)localgo,errorOrentity,claims=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentitylocalresultifisType(claims,"quantity")then-- get the url for the unit entry on Wikidata:result=claims[1].mainsnak.datavalue.value.unit-- and just reurn the last bit from "Q" to the end (which is the QID):result=mw.ustring.sub(result,mw.ustring.find(result,"Q"),-1)endreturnresultendp.getRawQualifierValue=function(frame)localfunctionoutputHook(value)ifvalue.datavalue.value["numeric-id"]thenreturnmw.wikibase.label("Q"..value.datavalue.value["numeric-id"])elsereturnvalue.datavalue.valueendendlocalret,gotData=getQualifier(frame,outputHook)ifgotDatathenret=string.upper(string.sub(ret,1,1))..string.sub(ret,2)endreturnretend-- This is used to get a date value for date_of_birth (P569), etc. which won't be linked-- Dates and times are stored in ISO 8601 format (sort of).-- At present the local formatDate(date, precision, timezone) function doesn't handle timezone-- So I'll just supply "Z" in the call to formatDate below:p.getDateValue=function(frame)localdate_format=mw.text.trim(frame.args[3]ori18n["datetime"]["default-format"])localdate_addon=mw.text.trim(frame.args[4]ori18n["datetime"]["default-addon"])localgo,errorOrentity,claims=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentitylocalout={}fork,vinpairs(claims)doifv.mainsnak.datavalue.type=='time'thenlocaltimestamp=v.mainsnak.datavalue.value.timelocaldateprecision=v.mainsnak.datavalue.value.precision-- A year can be stored like this: "+1872-00-00T00:00:00Z",-- which is processed here as if it were the day before "+1872-01-01T00:00:00Z",-- and that's the last day of 1871, so the year is wrong.-- So fix the month 0, day 0 timestamp to become 1 January instead:timestamp=timestamp:gsub("%-00%-00T","-01-01T")out[#out+1]=parseDateFull(timestamp,dateprecision,date_format,date_addon)endendreturntable.concat(out,"、")endp.getQualifierDateValue=function(frame)localdate_format=mw.text.trim(frame.args[4]ori18n["datetime"]["default-format"])localdate_addon=mw.text.trim(frame.args[5]ori18n["datetime"]["default-addon"])localfunctionoutputHook(value)localtimestamp=value.datavalue.value.timereturnparseDateValue(timestamp,date_format,date_addon)endreturn(getQualifier(frame,outputHook))end-- This is used to fetch all of the images with a particular property, e.g. image (P18), Gene Atlas Image (P692), etc.-- Parameters are | propertyID | value / FETCH_WIKIDATA / nil | separator (default=space) | size (default=frameless)-- It will return a standard wiki-markup [[File:Filename | size]] for each image with a selectable size and separator (which may be html)-- e.g. {{#invoke:Wikidata|getImages|P18|FETCH_WIKIDATA}}-- e.g. {{#invoke:Wikidata|getImages|P18|FETCH_WIKIDATA|<br>|250px}}-- If a property is chosen that is not of type "commonsMedia", it will return empty text.p.getImages=function(frame)localsep=mw.text.trim(frame.args[3]or" ")localimgsize=mw.text.trim(frame.args[4]or"frameless")localgo,errorOrentity,claims=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentityif(claims[1]andclaims[1].mainsnak.datatype=="commonsMedia")thenlocalout={}fork,vinpairs(claims)dolocalfilename=v.mainsnak.datavalue.valueout[#out+1]="[[File:"..filename.."|"..imgsize.."]]"endreturntable.concat(out,sep)elsereturn""endend-- This is used to get the TA98 (Terminologia Anatomica first edition 1998) values like 'A01.1.00.005' (property P1323)-- which are then linked to http://www.unifr.ch/ifaa/Public/EntryPage/TA98%20Tree/Entity%20TA98%20EN/01.1.00.005%20Entity%20TA98%20EN.htm-- uses the newer mw.wikibase calls instead of directly using the snaks-- formatPropertyValues returns a table with the P1323 values concatenated with ", " so we have to split them out into a table in order to construct the return stringp.getTAValue=function(frame)localent=mw.wikibase.getEntityObject()localprops=ent:formatPropertyValues('P1323')localout={}localt={}fork,vinpairs(props)doifk=='value'thent=mw.text.split(v,", ")fork2,v2inpairs(t)doout[#out+1]="[http://www.unifr.ch/ifaa/Public/EntryPage/TA98%20Tree/Entity%20TA98%20EN/"..string.sub(v2,2).."%20Entity%20TA98%20EN.htm "..v2.."]"endendendlocalret=table.concat(out,"<br> ")if#ret==0thenret="Invalid TA"endreturnretend--[[This is used to return an image legend from Wikidataimage is property P18image legend is property P2096Call as {{#invoke:Wikidata |getImageLegend | <PARAMETER> | lang=<ISO-639code> |id=<QID>}}Returns PARAMETER, unless it is equal to "FETCH_WIKIDATA", from Item QID (expensive call)If QID is omitted or blank, the current article is used (not an expensive call)If lang is omitted, it uses the local wiki language, otherwise it uses the provided ISO-639 language codeISO-639: https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html#wp1252447Ranks are: 'preferred' > 'normal'This returns the label from the first image with 'preferred' rankOr the label from the first image with 'normal' rank if preferred returns nothingRanks: https://www.mediawiki.org/wiki/Extension:Wikibase_Client/Lua]]p.getImageLegend=function(frame)-- look for named parameter id; if it's blank make it nillocalid=frame.args.idifidand(#id==0)thenid=nilend-- look for named parameter lang-- it should contain a two-character ISO-639 language code-- if it's blank fetch the language of the local wikilocallang=frame.args.langif(notlang)or(#lang<2)thenlang=mw.language.getContentLanguage().codeend-- first unnamed parameter is the local parameter, if suppliedlocalinput_parm=mw.text.trim(frame.args[1]or"")ifinput_parm=="FETCH_WIKIDATA"thenlocalent=mw.wikibase.getEntityObject(id)localimgsifentandent.claimsthenimgs=ent.claims.P18endlocalimglblifimgsthen-- look for an image with 'preferred' rankfork1,v1inpairs(imgs)doifv1.rank=="preferred"andv1.qualifiersandv1.qualifiers.P2096thenlocalimglbls=v1.qualifiers.P2096fork2,v2inpairs(imglbls)doifv2.datavalue.value.language==langthenimglbl=v2.datavalue.value.textbreakendendendend-- if we don't find one, look for an image with 'normal' rankif(notimglbl)thenfork1,v1inpairs(imgs)doifv1.rank=="normal"andv1.qualifiersandv1.qualifiers.P2096thenlocalimglbls=v1.qualifiers.P2096fork2,v2inpairs(imglbls)doifv2.datavalue.value.language==langthenimglbl=v2.datavalue.value.textbreakendendendendendendreturnimglblelsereturninput_parmendend-- This is used to get the QIDs of all of the values of a property, as a comma separated list if multiple values exist-- Usage: {{#invoke:Wikidata |getPropertyIDs |<PropertyID> |FETCH_WIKIDATA}}-- Usage: {{#invoke:Wikidata |getPropertyIDs |<PropertyID> |<InputParameter> |qid=<QID>}}p.getPropertyIDs=function(frame)localgo,errorOrentity,propclaims=parseInput(frame)ifnotgothenreturnerrorOrentityendlocalentity=errorOrentity-- if wiki-linked value collect the QID in a tableif(propclaims[1]andpropclaims[1].mainsnak.snaktype=="value"andpropclaims[1].mainsnak.datavalue.type=="wikibase-entityid")thenlocalout={}fork,vinpairs(propclaims)doout[#out+1]="Q"..v.mainsnak.datavalue.value["numeric-id"]endreturntable.concat(out,"、")else-- not a wikibase-entityid, so return emptyreturn""endend-- returns the page id (Q...) of the current page or nothing of the page is not connected to Wikidatafunctionp.pageId(frame)localentity=mw.wikibase.getEntityObject()ifnotentitythenreturnnilelsereturnentity.idendendfunctionp.claim(frame)localproperty=frame.args[1]or""localid=frame.args["id"]localqualifierId=frame.args["qualifier"]localparameter=frame.args["parameter"]locallist=frame.args["list"]localreferences=frame.args["references"]localshowerrors=frame.args["showerrors"]localdefault=frame.args["default"]ifdefaultthenshowerrors=nilend-- get wikidata entitylocalentity=mw.wikibase.getEntityObject(id)ifnotentitythenifshowerrorsthenreturnprintError("entity-not-found")elsereturndefaultendend-- fetch the first claim of satisfying the given propertylocalclaims=findClaims(entity,property)ifnotclaimsornotclaims[1]thenifshowerrorsthenreturnprintError("property-not-found")elsereturndefaultendend-- get initial sort indiceslocalsortindices={}foridxinpairs(claims)dosortindices[#sortindices+1]=idxend-- sort by claim ranklocalcomparator=function(a,b)localrankmap={deprecated=2,normal=1,preferred=0}localranka=rankmap[claims[a].rankor"normal"]..string.format("%08d",a)localrankb=rankmap[claims[b].rankor"normal"]..string.format("%08d",b)returnranka<rankbendtable.sort(sortindices,comparator)localresultlocalerroriflistthenlocalvalue-- iterate over all elements and return their value (if existing)result={}foridxinpairs(claims)dolocalclaim=claims[sortindices[idx]]value,error=getValueOfClaim(claim,qualifierId,parameter)ifnotvalueandshowerrorsthenvalue=errorendifvalueandreferencesthenvalue=value..getReferences(frame,claim)endresult[#result+1]=valueendresult=table.concat(result,list)else-- return first elementlocalclaim=claims[sortindices[1]]result,error=getValueOfClaim(claim,qualifierId,parameter)ifresultandreferencesthenresult=result..getReferences(frame,claim)endendifresultthenreturnresultelseifshowerrorsthenreturnerrorelsereturndefaultendendend-- look into entity objectfunctionp.ViewSomething(frame)localf=(frame.args[1]orframe.args.id)andframeorframe:getParent()localid=f.args.idifidand(#id==0)thenid=nilendlocaldata=mw.wikibase.getEntityObject(id)ifnotdatathenreturnnilendlocali=1whiletruedolocalindex=f.args[i]ifnotindextheniftype(data)=="table"thenreturnmw.text.jsonEncode(data,mw.text.JSON_PRESERVE_KEYS+mw.text.JSON_PRETTY)elsereturntostring(data)endenddata=data[index]ordata[tonumber(index)]ifnotdatathenreturnendi=i+1endend-- getting sitelink of a given wiki-- get sitelink of current item if qid not suppliedfunctionp.getSiteLink(frame)localqid=frame.args.qidifqid==""thenqid=nilendlocalf=mw.text.trim(frame.args[1]or"")localentity=mw.wikibase.getEntity(qid)ifnotentitythenreturnendlocallink=entity:getSitelink(f)ifnotlinkthenreturnendreturnlinkendfunctionp.Dump(frame)localf=(frame.args[1]orframe.args.id)andframeorframe:getParent()localdata=mw.wikibase.getEntityObject(f.args.id)ifnotdatathenreturni18n.warnDumpendlocali=1whiletruedolocalindex=f.args[i]ifnotindexthenreturn"<pre>"..mw.dumpObject(data).."</pre>"..i18n.warnDumpenddata=data[index]ordata[tonumber(index)]ifnotdatathenreturni18n.warnDumpendi=i+1endendreturnp