模块:WikidataIB/doc
这是Module:WikidataIB的文档页面
![]() | 此模块文档已被保护。此为高度可见模块文档,其已用于大量条目或被频繁替换引用。由于破坏或失误会影响诸多页面,即便细小的改动也可能导致大量服务器负载,因此已被保护,不可编辑。 |
![]() | 此模块文档被引用于约70,000个页面,占全部页面的1%。 为了避免造成大规模的影响,所有对此模块文档的编辑应先于沙盒或测试样例上测试。 测试后无误的版本可以一次性地加入此模块文档中,但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
![]() | 此模块功能的便捷版见{{wdib}}。 |
![]() | 此模块的文档不存在、不全面或不能详细描述其功能及/或其代码中的参数。请帮助扩充并改进其文档。 |
此模块是为在{{infobox}}(信息框)或其他模板中使用而设计,并经专门设计而允许条目编者控制是否显示特定的维基数据值。IB为Info Box之缩写。
应使用两组沙盒页面来测试非琐碎修改。
概述
编辑该模块目前为信息框目的提供如下函数调用(call):
getValue
- 主函数,获取指定属性的一个或多个值getQualifierValue
- 提供:(1) 一个属性; (2) 属性的值; (3) 修饰符(qualifier)的属性ID。返回匹配的值getValueByQual
获取具有给定实体值的限定词的属性值(此处下划线用于标示一个相对整体,帮助读者理解,下同)getValueByLang
获取修饰符p:P407(作品或名称语言)的值为给定语言代码的属性值getValueByRefSource
gets the value of a property which has a reference "stated in" (P248) whose value has the given entity-IDgetPropOfProp
if the value(s) of prop1 are of type "wikibase-item" then it returns the value(s) of prop2 of each of those wikibase-itemsgetAwardCat
if the item has values of P166 (award received), then it examines each of those awards for P2517 (category for recipients of this award) and it returns the corresponding category, with the item's P734 (family name) as sort key, or no sort key if there is no family namegetIntersectCat
for each value of the prop1 it fetches the value's main category and then each value of prop2, then it returns all of the categories representing the intersection of those propertiesgetSumOfParts
scans the property 'has part' (P527) for values matching a list, If the matched values have a qualifier 'quantity' (P1114), those quantities are summed and returned (but zero returns nil)getCoords
- gets coordinates and passes them through {{Coord}}getPreferredValue
- Deprecated but retained for backward compatibility. Use the|getValue|rank=best
parameters instead.
The obsolete call getSourcedValue has now been removed as it is redundant to getValue which can do the same job using the |onlysourced=true
parameter (which is set by default).
工具函数
编辑getLink
if there is a sitelink to an article on the local Wiki, it returns a link to the article with the Wikidata label as the displayed text. If there is no sitelink, it returns the label as plain text. If there is no label in the local language, it returns the entity-IDgetAT
(Article Title) If there is a sitelink to an article on the local Wiki, it returns the sitelink as plain text, otherwise nothinggetSiteLink
gets the plain text link to an article on a given wikigetLabel
returns the Wikidata label for the local language as plain text. If there is no label in the local language, it returns the entity-IDgetAllLabels
fetches the set of labels and formats it for display as wikitextlabelorid
returns the label with all wikitext removed, or the entity-ID if no labelgetDescription
returns the article description for the Wikidata entity if the local parameter is "Wikidata".getAllDescriptions
fetches the set of descriptions and formats it for display as wikitextgetAliases
returns the aliases for the entity in the current or given languagegetAllAliases
fetches the set of aliases and formats it for display as wikitextpageId
returns the connected Wikidata page id (entity-ID, Q-number) of the current pageformatDate
takes a datetime of the usual format from mw.wikibase.entity:formatPropertyValues and formats it according to the df (date format) and bc parametersformatNumber
formats a number according to the supplied language codecheckBlacklist
returns true if the field is not blacklisted (i.e. allowed)emptyor
returns nil if the parameter is just punctuation, whitespace or html tags, otherwise returns the argument unchangedgetLang
returns the MediaWiki language code or the full language name of the current contentgetItemLangCode
looks for country (P17), then for that country's official language (P37), and returns its language code (P424)findLanguage
returns (1) supplied language if valid; or (2) the user's set language; or (3) the language of the current wikigetQid
returns (1) the entity-ID, if supplied; or (2) the entity ID of the "category's main topic (P301)"; or (3) the entity ID associated with the current page; or (4) nothingfollowQid
given a list of properties, looks for each property in turn and returns the entity-ID of the first value that matches (optionally, returns all entity-IDs that match)getGlobe
returns the entity-ID of the globe used in P625 (coordinate location), or nil if there isn't onegetCommonsLink
returns one of the following in order of preference: the Commons sitelink of the linked Wikidata item; the Commons sitelink of the topic's main category of the linked Wikidata item;siteID
returns the root of the globalSiteID, e.g. "en" for "enwiki", "enwikisource", "en-gb", etc.projID
same as siteIDlocation
scans from the current location upwards along the chain of higher-level locations, returning each one until it reaches a countryexamine
returns a formatted dump of the given propertyurl2
takes a parameter that is a proper url and formats it for use in an infobox; it accepts its own output as inputgetWebsite
fetches the Official website (P856) and formats it for use in an infoboxcheckvalue
looks through a property for a given entity-ID as its value and returns that entity-ID if found; otherwise nilcheckValidity
returns whether the first unnamed parameter represents a valid entity-idshowNoLinks
displays the article titles that should not be linked
函数用法示例
编辑{{#invoke:WikidataIB |getValue |<PropertyID> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no> |noicon=<yes/no> |df=<dmy/mdy/y> |bc=<BC/BCE> |qual=<ALL/DATES/P999> |list=<ubl/hlist/prose> |linked=<yes/no> |<local parameter>}}
{{#invoke:WikidataIB |getCoords |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |<local parameter>}}
{{#invoke:WikidataIB |getQualifierValue |<PropertyID> |pval=<ID of target value for the property> |qual=<qualifier ID for that target value> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
{{#invoke:WikidataIB |getValueByQual |<PropertyID> |qualID=<qualifier property ID to match> |qvalue=<QID of target value for the qualifier property> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
{{#invoke:WikidataIB |getValueByLang |<PropertyID> |lang=<language code to match> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}
getValue
编辑getValue的参数
编辑名称 | 别名 | 函数 | 默认值 |
---|---|---|---|
(第一个未命名参数) | 1 | 要返回的值的属性ID。必填。 | |
(第二个未命名参数) | 2 | 本地提供的值,非空则比维基数据的值优先而被显示。 | 空 |
qid | 要查询其属性的维基数据项目编号(QID)。如果非空,默认使用当前页面所关联的维基数据项目——即mw.wikibase.getEntityIdForCurrentPage()。 | 当前页面的项目ID(QID) | |
eid | 备用QID。Except for eid , all parameters to getValue treat nil and the empty string the same. So, setting |x= gives the same result as omitting the parameter. However, to provide some compatibility with other modules, using |eid= always returns an empty string, while omitting eid allows qid to work as normal.
|
当前页面的项目ID(QID) | |
rank | (不区分大小写)。设为best 时,返回首选级的值(如果存在),不然返回普通级的值。设为preferred 时,返回返回首选级的值。设为normal 时,返回普通级的值。设为deprecated 时,返回弃用级的值。参数以"b"开头均视为"best";以"p"开头均视为"preferred";以"n"开头均视为"normal";以"d"开头均视为deprecated。允许提供多个值,如"p n d"将返回所有评级的值。"Best"将覆盖其他参数设置。其他参数将忽略,如果没有要求特定级别的值,将返回首选及普通级的值。
|
首选及普通级 | |
qual | A punctuation-separated list of property-IDs of qualifiers that are to be returned in parentheses after the property. Setting qual=ALL returns all qualifiers. Setting qual=DATES returns 始于 (P580) and 终于 (P582) with a date separator.
|
无 | |
qualsonly | qo | A boolean which enables the display of just the qualifier(s), without the property value or parentheses. Values no , false and 0 are all false; anything else is true.
|
false |
fetchwikidata | fwd | 所需值所在的字段列表。ALL 获取所有字段。NONE 或留空或省略则不获取任何字段。
|
无 |
suppressfields | spf | 拒绝显示的字段列表。这能也停止显示本地提供的字段值。 | 无 |
name | 字段名称。编写信息框时,这是fetchwikidata和suppressfields用来识别的名称。已指定fetchwikidata或suppressfields时必填(除非fetchwikidata=ALL )。
|
nil | |
onlysourced | osd | 布尔值,是否过滤掉无来源或者仅基于维基百科的维基数据值。This 2018 RFC要求条目信息框显示的维基数据必须有据可查。值no 、false 或0 均视作false,其余视作true。
|
true |
df | 日期格式:可能为dmy (日月年)或mdy (月日年)或y (仅有年)。
|
dmy | |
qdf | 日期格式限定符。省略则默认为df 参数,df 也被省略则默认为"y"。
|
df的值,或者"y" | |
bc | Format of the BC/BCE suffix for dates. | BCE | |
plaindate | pd | String to modify formatting of dates. Setting "true"/"yes"/"1" disables adding "sourcing cirumstances" (P1480) and any links. Setting "adj" does the same but uses the adjectival form of the date. | false |
linked | 布尔值,是否基于维基数据上的站点链接,提供为内部链接形式。值no 、false 或0 均视作false,其余视作true。
|
true | |
displaytext | dt | 覆盖内部链接的显示文本的字符串。原有显示文本非空时有效。 | 空 |
shortname | sn | A boolean that enables the use of shortname (P1813) instead of label for a linked item. Values no , false and 0 are all false; anything else is true.
|
false |
uselabel | uselbl | A boolean that forces the display of the label instead of the disambiguated sitelink for a linked item. Labels are much more prone to vandalism that sitelinks. Values no , false and 0 are all false; anything else is true.
|
false |
wdlinks | wdl | A boolean that enables the display of links to Wikidata when no local article exists. Values no , false and 0 are all false; anything else is true.
|
false |
unitabbr | uabbr | A boolean that enables unit abbreviations for common units. Values no , false and 0 are all false; anything else is true.
|
false |
convert | conv | A boolean that enables passing of quantities to Template:Cvt. Values no , false and 0 are all false; anything else is true.
|
false |
showunits | su | 布尔值,是否显示限定符的单位。值no 、false 或0 均视作false,其余视作true。
|
true |
scale | A string that sets scaling for format of quantities. Values are: "a"=automatic; "0"=no scaling; "3"=thousand; "6"=million; "9"=billion; "12"=trillion. | 0 | |
maxvals | Sets the maximum number of values to be returned when multiple values are available. Setting it to 1 is useful where the returned string is used within another call, e.g. image. Values 0 and empty return all values.
|
0 (all) | |
collapse | Sets the maximum number of values to be returned before the content is auto-collapsed. Values 0 and empty allow all content to be displayed uncollapsed.
|
0 (all) | |
linkprefix | lp | A link prefix that is prepended to the linked value when linked. Applies only to items that have articles and to strings (e.g. url). It triggers linking of strings. Any double-quotes " are stripped out, so that spaces may be passed. | empty |
linkpostfix | A link postfix that is appended to the linked value when linked. Applies only to items that have articles and to strings (e.g. url). It triggers linking of strings. Any double-quotes " are stripped out, so that spaces may be passed. | empty | |
prefix | A prefix that is prepended to the displayed value of strings (e.g. url). Any double-quotes " are stripped out, so that spaces may be passed. | empty | |
postfix | A postfix that is appended to the displayed value of strings (e.g. url). Any double-quotes " are stripped out, so that spaces may be passed. | empty | |
qlinkprefix | qlp | Qualifier link prefix (see linkprefix). | empty |
qlinkpostfix | Qualifier link postfix (see linkpostfix). | empty | |
qprefix | Qualifier prefix (see prefix). | empty | |
qpostfix | Qualifier postfix (see postfix). | empty | |
sorted | 布尔值,是否排序返回的值。值no 、false 或0 均视作false,其余视作true。
|
false | |
qsorted | 布尔值,是否根据返回的每个值的限定符排序。值no 、false 或0 均视作false,其余视作true。
|
false | |
noicon | A boolean which will suppress the trailing "edit at Wikidata" pen-icon. Useful for when the returned value is to be further processed. Values no , false and 0 are all false (i.e. shows the icon); anything else is true (i.e. suppresses the icon).
|
false | |
list | The name of a template that the list of multiple values is then passed through. Examples include "cslist", "hlist", "ubl", "blist", "olist", "p-1". A special value, prose , produces "1, 2, 3 and 4".
|
none | |
sep | 自定义返回多个值时的分隔符字符串。将去除全部英文双引号",以便能传入空格。如果未传入任何内容或者留空,将使用默认的列表分隔符(英文中默认为", ")。 | ", " | |
qsep | 自定义返回的多个有限定符的值的分隔符字符串。将去除全部英文双引号",以便能传入空格。如果未传入任何内容或者留空,将使用默认的列表分隔符(英文中默认为", ")。 | ", " | |
format | 决定是否将全球坐标呈现为度/分/秒,或者十进制值。任何"dec"(不区分大小写)开头的值视作要求十进制值,否则呈现度分秒。 | dms(度分秒) | |
show | Determines how global coordinates should be returned. The value "longlat" will return longitude, latitude . Any other value beginning "lon" (case insensitive) will return just longitude. Any value beginning "lat" (case insensitive) will return just latitude. When used with |noicon=true , all of these will be pure numbers in decimal degrees (signed: N and E as positive), which are intended for use in mapping templates, etc. Anything other value (or nothing) will render the usual coordinate values as DMS or decimal with "NSEW" qualifiers, etc.
|
empty | |
lang | Allows an unlinked value to be returned in the chosen language. Takes a standard ISO language code recognised by MediaWiki. If not supplied or blank, the local language (or set language for multi-lingual wikis) is used as normal. | 本地语言 | |
parameterset | ps | Convenience parameter to allow commonly used sets of parameters to be specified with a single parameter: ps=1 gets a simple linked value wherever possible; ps=2 represents a plain text value. See Parameter sets | |
linkredir | Boolean to switch on or off the check for a redirect with the same name as the label when there is no sitelink on Wikidata for the value. 值no 、false 或0 均视作false,其余视作true。
|
false |
基本参数
编辑- getValue can also take a named parameter
|qid=
which is the Wikidata ID for an article. This will not normally be used as omitting it defaults to the current article. - The property whose value is to be returned is passed in the first unnamed property and is required.
- The second unnamed parameter, if supplied, will become the returned value and no call to Wikidata will be made.
白名单与黑名单
编辑- The name of the field that this function is called from is passed in the named parameter
|name=
, which is first checked against a blacklist of fields that are never to be displayed, (i.e. the call must return nil in all circumstances). If the field is not on the blacklist, it is then checked against a whitelist. If the name of the field matches, the call will return any locally supplied value if it is supplied as the second unnamed parameter, or the Wikidata value otherwise. - Specifying
|fetchwikidata=ALL
is a shortcut to return all fields that are not blacklisted. - The name is compulsory when the blacklist or whitelist is used, so the module returns nil if it is not supplied, other than when
|fetchwikidata=ALL
. - The blacklist is passed in the named parameter
|suppressfields=
- The whitelist is passed in the named parameter
|fetchwikidata=
源头
编辑The getValue function will accept a boolean parameter onlysourced
which will suppress return of Wikidata values that are unsourced or only sourced to a Wikimedia project. The absence of the parameter, an empty parameter (|onlysourced=
) and the empty string (""
) all default to true (i.e. only referenced values are returned). The values no
, false
and 0
are treated as false (i.e. all values are returned); any other value is true (although |onlysourced=yes/no
is recommended for readability).
链接到维基数据
编辑The getValue function will accept a boolean parameter noicon
which will suppress the trailing "edit at Wikidata" icon and link for cases when the returned value is to be further processed by the infobox (e.g. a url). The absence of the parameter or an empty parameter (|noicon=
) default to false (i.e. the icon is added). The empty string (""
) and the values no
, false
and 0
are treated as false; any other value is true (although |noicon=true
is recommended for readability).
Following a discussion at Module talk:WikidataIB #Visibility of pen icon, the pen icon is hidden from users who are not autoconfirmed. This means that most readers don't see the pen icon, and represents a balance between aesthetics and vandalism at Wikidata on the one hand, and the desire to encourage editing Wikidata on the other.
日期
编辑In order to handle the requirement for dates in mdy, dmy or just year formats, getValue accepts a named parameter |df=
that may take the values "dmy", "mdy", or "y" - default is "dmy".
As an article may require either of suffixes BC and BCE, getValue accepts a named parameter |bc=
that may take the values "BC", or "BCE" - default is "BCE". Some test cases are shown at Module talk:WikidataIB/testing #Calls to getValue for dates.
排名
编辑The |rank=
parameter, when set to preferred, returns only preferred values; when set to normal, returns only normal values; when set to deprecated, returns only deprecated values. If the parameter is set to best, it returns preferred values if present, otherwise normal values. Any parameter value beginning with "p" is "preferred"; any parameter value beginning with "n" is "normal"; any parameter value beginning with "d" is "deprecated"; any parameter value beginning with "b" is "best". Combinations of values are allowed, e.g. |rank=p n
returns all the preferred and normal values (which is the default), although "best" overrides any other parameters.
特定的数据类型处理
编辑The module has specific handlers for the following data types:
- Items that correspond to an article in some Wikipedia, called "wikibase-items". These will be linked to the corresponding (and disambiguated) article on English Wikipedia where possible.
- Items that represent dates. These may be centuries, years, years and months, or years, months and days.
- Items that represent Commons media, urls, external ids, or other sorts of plain text.
- Items that represent quantities. All of these may have an associated unit, or be dimensionless, and may have a range.
- Items that represent global coordinates. These will be in degrees of latitude and longitude and will have an associated precision.
Items that represent other types of data are not handled at present.
The third class of data types may be used with the parameters:
|prefix=
,|postfix=
,|linkprefix=
,|linkpostfix=
If you don't supply at least one of |linkprefix=
or |linkpostfix=
, then just |prefix=
and |postfix=
are used. For example, when getting the 小行星中心观测代码 (P717) in 维也纳天文台 (Q532127):
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix="before " |postfix=" after" |qid=Q532127}}
→ before 045 after
Use double-quotes to enclose the parameter value if it has leading or trailing spaces (otherwise they are stripped out). If you supply |linkprefix=
or |linkpostfix=
, then all four parameters are used and a link is made for each value like this:
[[ linkprefix WikidataValue1 linkpostfix | prefix WikidataValue1 postfix]], [[ linkprefix WikidataValue2 linkpostfix | prefix WikidataValue2 postfix]], etc.
That allows multiple links to be made to different sections of a list article, such as List of observatory codes. For example, when getting the 小行星中心观测代码 (P717) in 维也纳天文台 (Q532127) we can make the links:
{{#invoke:WikidataIB/sandbox|getValue|P717|fetchwikidata=ALL|onlysourced=no |prefix= |postfix= |linkprefix="List of observatory codes#" |linkpostfix= |qid=Q532127}}
→ [List of observatory codes#045 045]
The parameters |prefix=
, |postfix=
, |linkprefix=
, |linkpostfix=
are also applied to wikibase-items if they are linked.
格式化返回的多个值
编辑|sorted=<yes|no>
is a boolean passed to enable sorting of the values returned. No parameter, or an empty string, or "false", or "no", or "0" disables sorting. It's only a very dumb alphabetical sort and sorts linked values as "[[ ..."|sep=<separator characters>
allows the separator between multiple returned values to be defined. The default is", "
(comma plus normal space). If the separator has leading or trailing spaces, enclose it in double quotes (e.g.|sep=" - "
). Any double quotes are stripped from the separator. The pipe character (|
) must be escaped as{{!}}
. For reasons of accessibility (see MOS:PLIST), do not use|sep=<br>
for vertical unbulleted lists; use|list=ubl
instead.|list=<prose|cslist|hlist|ubl|blist|olist>
allows multiple returned values to be displayed as a sentence with last two values separated by "and" (|list=prose
), a horizontal comma-separated list (|list=cslist
, not to be used in prose), a horizontal list (|list=hlist
), a vertical unbulleted list (|list=ubl
), a vertical bulleted list (|list=blist
), or a vertical ordered list (|list=olist
). These override the separator and do not display the 'pen icon' linked to "Edit at Wikidata".|list=p-1
displays the last value. Combine with|maxvals=n
to display the nth value.
限定返回的值
编辑Sometimes a property is expected to have a single value, such as 图像 (P18), but may have multiple values on Wikidata. Setting |maxvals=1
will limit the number of values returned to 1. Any other value is possible and functions as expected, but zero is treated as "no limit".
不要链接
编辑A returned value that represents an article on the local wiki will be linked by default. This includes redirects, but not dab pages. Sometimes there is a need not to link that returned values and this may be accomplished by setting |linked=no
.
单位缩写
编辑When the returned value is a quantity, the name of the units in which it is expressed is appended. Infoboxes may wish to use abbreviations instead for common units. This can be done by setting |unitabbr=true
.
修饰符
编辑A parameter |qual=
may be supplied, which will return qualifiers of the required property, if they exist. If the value is set to a punctuation-separated list of property-IDs (e.g. P123, P456), then only the values of qualifiers with that property will be returned. If the value is set to |qual=ALL
, then all of the qualifier values are returned. If the value is set to |qual=DATES
then the 始于 (P580) and the 终于 (P582) of the property are returned with a date separator. In each case, any qualifier values returned follow the property value, and are enclosed in parentheses. If multiple qualifier values are returned, they will be separated by commas by default, although the separator can be changed by specifying |qsep=
(which may be enclosed in double-quotes, which are stripped out, so that spaces can be included). Setting the parameter |qsorted=yes
will sort the returned qualifier values alphanumerically.
参数缩写
编辑Some of the longer parameters may be abbreviated to make infobox designs more compact:
fwd → fetchwikidata
osd → onlysourced
spf → suppressfields
wdl → wdlinks
参数集
编辑Generally, getValue
has a set of defaults for its parameters that represent consensus decisions by editors. For example, |onlysourced=
defaults to true
so only Wikidata values that are sourced to something better than "Wikipedia" will be returned, and |fetchwikidata=
defaults to none
so nothing is returned until it is enabled by setting some field names or "ALL". This represents the fail-safe condition and allows infoboxes to be made Wikidata-capable without changing any article until enabled for that article.
To simplify the use of getValue
in other circumstances, common combinations of parameters can be specified with |parameterset=
or its alias |ps=
for convenience. Two combinations are implemented at present and these are:
- ps=1
- a common set of overrides to get a simple value, linked where possible:
|rank ="best" |fetchwikidata="ALL" |onlysourced ="no" |noicon ="true"
- ps=2
- a sort of raw value in plain text:
|rank = "best" |fetchwikidata = "ALL" |onlysourced = "no" |noicon = "true" |linked = "no" |plaindate = "true"
Other sets could be created if there is a demand.
封装模板
编辑The template {{wdib}} can be used as a convenient wrapper for {{#invoke:WikidataIB |getValue}}
.
其他主要函数
编辑getPreferredValue
编辑The getPreferredValue function works exactly like getValue, taking the same parameters, but if any values for a property have the preferred rank set, it will only return those values. This is now deprecated in favour of getValue|rank=best
.
getCoords
编辑- getCoords can also take a named parameter
|qid=
which is the Wikidata ID for an article. This will not normally be used as omitting it defaults to the current article. - The first unnamed parameter, if supplied, will become the returned value and no call to Wikidata will be made.
- The coordinates from Wikidata are parsed and passed to Template:Coord which returns the display as if it were called manually.
- The blacklist of fields that are never to be displayed, and the whitelist are implemented in the same way as for getValue using
|suppressfields=
and|fetchwikidata=
- The
format
parameter sets the display format to decimal or dms. Any value beginning with "dec" sets decimal; anything else sets dms. - The
display
parameter sets the display position to "inline", "title" or "inline, title". Default is nothing (so uses default for {{Coord}}, currently "inline").
getQualifierValue
编辑The getQualifierValue function is for use when we want to fetch the value of a qualifier. We need to know the property and the value of the property that the qualifier relates to. The parameters are:
- The property ID passed in the unnamed parameter (or
|1=
) - The target value for that property in
|pval=
- The qualifier ID for that target value in
|qual=
- The same parameters to implement whitelisting and blacklisting of the property as in getValue
- Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
getQualifierValue示例
编辑In 南极望远镜 (Q1513315) there is a property 重大事件 (P793), which has a value 建筑施工 (Q385378). That has two qualifiers, 始于 (P580) and 终于 (P582). To get the start date:
{{#invoke:WikidataIB |getQualifierValue |qid=Q1513315 |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}
In South Pole Telescope it returns:
getValueByQual
编辑The getValueByQual function returns the value of a property which has a qualifier with a given entity value. The parameters are:
- The property ID passed in the unnamed parameter (or
|1=
) - The property ID for a qualifier (or "ALL" or "DATES") in
|qualID=
- The Wikibase-entity ID of a value for that qualifier in
|qvalue=
- The same parameters to implement whitelisting and blacklisting of the property as in getValue
- Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
getValueByQual示例
编辑In 肉类食物 (Q10990) there is a property 读音 (音频文件) (P443) that has multiple values, each of which has a qualifier 作品或名称使用语言 (P407). We can return the property value whose qualifier has the value 英国英语 (Q7979)
{{#invoke:WikidataIB |getValueByQual |qid=Q10990 |P443 |qualID=P407 |qvalue=Q7979 |fwd=ALL |osd=no |noicon=true}}
→
getValueByLang
编辑The getValueByLang function returns the value of a property which has a qualifier 作品或名称使用语言 (P407) whose value has the given language code. The parameters are:
- The property ID passed in the unnamed parameter (or
|1=
) - The 维基媒体语言代码 (P424) to match the language whose code is given by
|lang=xx[-yy]
. If no code is supplied, it uses the default language. - The same parameters to implement whitelisting and blacklisting of the property as in getValue
- Optional boolean to specify whether only sourced values of the property are returned (defaults to "no") in
|onlysourced=
- Optional item ID for arbitrary access in
|qid=
- The same parameters to format output as in getValue
getValueByLang示例
编辑In 开源开发网络 (Q7565108) there is a property 官方网站 (P856) that has multiple values, each of which has a qualifier 作品或名称使用语言 (P407). We can return the property value whose 作品或名称使用语言 (P407) qualifier value (a WD item) itself has the 维基媒体语言代码 (P424) property that is "ja", i.e, 日语 (Q5287)
{{#invoke:WikidataIB |getValueByLang |qid=Q7565108 |P856 |lang=ja |fwd=ALL |osd=no |noicon=true}}
→ https://ja.osdn.net/
If |lang=
is unspecified, we can obtain the same value with the default language (here that is the 英语 (Q1860) and its 维基媒体语言代码 (P424) is "en")
{{#invoke:WikidataIB |getValueByLang |qid=Q7565108 |P856 |fwd=ALL |osd=no |noicon=true}}
→
工具函数
编辑getLink
编辑getLink has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=
If there is a sitelink to an article on the local Wiki, it returns a link to the article with the Wikidata label as the displayed text. If there is no sitelink, it returns the label as plain text. If there is no label in the local language, it displays the qid instead.
- Wikidata: Corisca and the Satyr (Q29016906) and 考古学家 (Q3621491)
{{#invoke:WikidataIB |getLink |Q29016906}}
→ Corisca and the Satyr{{#invoke:WikidataIB |getLink |Q3621491}}
→ 考古学家
getLabel
编辑getLabel has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=
It returns the Wikidata label in the local language for an item by the given qid. If there is no label in the local language, it returns the qid instead. Note that this is the label given to the Wikidata entry in the same language as the current Wiki, if the label exists.
- Wikidata: Corisca and the Satyr (Q29016906) and 考古学家 (Q3621491)
{{#invoke:WikidataIB |getLabel |Q29016906}}
→ Corisca and the Satyr{{#invoke:WikidataIB |getLabel |Q3621491}}
→ 考古学家{{#invoke:WikidataIB |getLabel |Q19805408}}
→ Module:Biblio/Ouvrage
label
编辑label has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=
It returns the Wikidata label in the local language for an item by the given qid or linked to the current page. If there is no label in the local language, it returns an empty string. Note that this is the label given to the Wikidata entry in the same language as the current Wiki, if the label exists.
- Wikidata: Corisca and the Satyr (Q29016906) and 考古学家 (Q3621491)
{{#invoke:WikidataIB |label |Q29016906}}
→ Corisca and the Satyr{{#invoke:WikidataIB |label |Q3621491}}
→ 考古学家{{#invoke:WikidataIB |label |Q19805408}}
→ Module:Biblio/Ouvrage
getAT
编辑getAT has the qid of a Wikidata entity passed as the first unnamed parameter or as |qid=
If there is a sitelink to an article on the local Wiki, it returns the sitelink as plain text, i.e. the article title. If there is no sitelink, it returns nothing. Note that this is the title of the article in the current Wikipedia, if the interlanguage link exists in the Wikidata entry.
- Wikidata: Corisca and the Satyr (Q29016906) and 考古学家 (Q3621491)
{{#invoke:WikidataIB |getAT |Q29016906}}
→{{#invoke:WikidataIB |getAT |Q3621491}}
→
getDescription
编辑getDescription has the qid of a Wikidata entity passed as |qid= (it defaults to the associated qid of the current article if omitted). It has a local parameter passed as the first unnamed parameter. Any local parameter passed (other than "Wikidata" or "none") becomes the return value. It returns the article description for the Wikidata entity in plain text if the local parameter is "Wikidata". Nothing is returned if the description doesn't exist or "none" is passed as the local parameter.
- Wikidata: Corisca and the Satyr (Q29016906) and 考古学家 (Q3621491)
{{#invoke:WikidataIB |getDescription |qid=Q29016906 |wikidata}}
→ painting by Artemisia Gentileschi{{#invoke:WikidataIB |getDescription |qid=Q29016906 |A painting}}
→ A painting{{#invoke:WikidataIB |getDescription |qid=Q29016906 |none}}
→{{#invoke:WikidataIB |getDescription |qid=Q3621491 |wikidata}}
→ 研究过去人类活动的人{{#invoke:WikidataIB |getDescription |qid=Q3621491 |A profession}}
→ A profession{{#invoke:WikidataIB |getDescription |qid=Q3621491 |none}}
→
formatDate
编辑formatDate accepts a datetime of the usual format from mw.wikibase.entity:formatPropertyValues, like "1 August 30 BCE" as parameter 1 and formats it according to the df (date format) and bc parameters.
{{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BCE |df=dmy}}
→ 1 August 30 公元前{{#invoke:WikidataIB |formatDate | 1 August 30 BCE |bc=BC |df=mdy}}
→ August 1, 30 公元前- df = "dmy" / "mdy" / "y" - default is "dmy"
- bc = "BC" / "BCE" - default is "BCE"
checkBlacklist
编辑checkBlacklist allows a test to check whether a named field is allowed. It returns true if the field is not blacklisted (i.e. allowed) It returns false if the field is blacklisted (i.e. disallowed)
Example:
{{#if:{{#invoke:WikidataIB |checkBlacklist |name=nationality |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}}
→ not blacklisted{{#if:{{#invoke:WikidataIB |checkBlacklist |name=birth_place |suppressfields=residence; nationality; citizenship}} | not blacklisted | blacklisted}}
→ not blacklisted
emptyor
编辑emptyor returns nil if its first unnamed argument is just punctuation, whitespace or html tags otherwise it returns the argument unchanged (including leading/trailing space).
If the argument could contain "=", then it must be called explicitly:
| 1 = whatever-the-argument-is
In that case, leading and trailing spaces are trimmed.
It finds use in infoboxes where it can replace tests like:
{{#if: {{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}} | <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> | }}
with a form that uses just a single call to Wikidata:
{{#invoke |WikidataIB |emptyor |1= <span class="xxx">{{#invoke:WikidataIB |getvalue |P99 |fwd=ALL}}</span> }}
labelorid
编辑labelorid is a public function to expose the output of labelOrId().
The Q-number (entity ID) is passed as |qid= or as an unnamed parameter.
It returns the Wikidata label for that entity or the qid if no label exists.
getQid
编辑- getQid works with the current page and its associated Wikidata entry.
- It returns qid, if supplied as the first unnamed parameter or as
|qid=
; - failing that, the Wikidata entity ID of the "category's main topic (P301)", if it exists;
- failing that, the Wikidata entity ID associated with the current page, if it exists;
- otherwise, nothing
examine
编辑examine provides a dump of the entire property given in the first unnamed parameter (or in |pid=
as a named alias) from the item given by the parameter 'qid', or from the item corresponding to the current page if qid is not supplied. Both parameters may be unnamed and given in any order.
It works in a similar manner to the Dump function, but only loads a single claim, rather than the whole Wikidata entry.
- Example:
{{#invoke:WikidataIB |examine |qid=Q1396889 |P50}}
There is a Template:Examine which acts as a wrapper for the call.
- Example:
{{examine |Q4048254 |P31}}
→
url2
编辑url2 takes a parameter url= that is a proper url and formats it for use in an infobox.
Examples:
{{#invoke:WikidataIB |url2 |url= http://www.example.com/ }}
→ www.example .com/ <span class="url">[http://www.example.com/ www<wbr/>.example<wbr/>.com/]</span>
{{#invoke:WikidataIB |url2 |url= http://www.example.com/path/ }}
→ www.example .com/path/ <span class="url">[http://www.example.com/path/ www<wbr/>.example<wbr/>.com/path/]</span>
{{#invoke:WikidataIB |url2 |url= {{wdib |P856 |qid=Q23317 |fwd=ALL |osd=no}} }}
→ www.audi .com、https://www .audi .co .za/、https://www .audi .de/、https://www .audi .fr/ <span class="url">[https://www.audi.com、https://www.audi.co.za/、https://www.audi.de/、https://www.audi.fr/ www<wbr/>.audi<wbr/>.com、https://www<wbr/>.audi<wbr/>.co<wbr/>.za/、https://www<wbr/>.audi<wbr/>.de/、https://www<wbr/>.audi<wbr/>.fr/]</span> [[File:OOjs UI icon edit-ltr-progressive.svg |frameless |text-top |10px |alt=编辑维基数据|link=https://www.wikidata.org/wiki/Q23317?uselang=zh-cn#P856|编辑维基数据]]
{{wdib |P856 |qid=Q23317 |fwd=ALL |osd=no}}
→ https://www.audi.com、https://www.audi.co.za/、https://www.audi.de/、https://www.audi.fr/https://www.audi.com、https://www.audi.co.za/、https://www.audi.de/、https://www.audi.fr/ [[File:OOjs UI icon edit-ltr-progressive.svg |frameless |text-top |10px |alt=编辑维基数据|link=https://www.wikidata.org/wiki/Q23317?uselang=zh-cn#P856|编辑维基数据]]
{{#invoke:WikidataIB |url2 |url= {{url|http://www.example.com/}} }}
→ www.example .com www .example .com/ www .example .com]] <span class="url">[http://www.example.com/ www<wbr/>.example<wbr/>.com]</span> www<wbr/>.example<wbr/>.com/ www<wbr/><wbr/>.example<wbr/><wbr/>.com]</span>]</span>
Comparison with output of {{URL}}:
{{URL | http://www.example.com/ }}
→ www.example .com <span class="url">[http://www.example.com/ www<wbr/>.example<wbr/>.com]</span>
{{URL | http://www.example.com/path/ }}
→ www.example .com /path / <span class="url">[http://www.example.com/path/ www<wbr/>.example<wbr/>.com<wbr/>/path<wbr/>/]</span>
{{URL | {{wikidata|property|Q23317|P856}} }}
→ www.audi .com <span class="url">[https://www.audi.com www<wbr/>.audi<wbr/>.com]</span>
{{wikidata|property|Q23317|P856}}
→ https://www.audi.comhttps://www.audi.com
另见
编辑- {{#invoke:URL|url}} & {{#invoke:URL|url2}}
编入信息框
编辑Typically, the getValue call will be invoked in an infobox definition, using appropriate template parameters. One simple implementation is given as an example in Template:Infobox book/Wikidata/Sandbox. As an illustration, the 'author' field in the infobox is coded like this:
| label2 = Author{{#if:{{{authors|}}}|s}} | data2 = {{#invoke:WikidataIB |getValue |P50 |name=author |fetchwikidata={{{fetchwikidata|}}} |suppressfields={{{suppressfields|}}} |{{{authors|{{{author|}}}}}} }}
The property to be fetched is the first unnamed parameter. In this case it is 作者 (P50).
The name of the field is passed in |name=
and that name is checked against the blacklist and the whitelist. To always suppress the author field in a particular article, an editor will set |suppressfields=author
in the infobox. The author field will then never be displayed.
If the field is not blacklisted, then the infobox can be set to display a locally supplied value for author simply by setting |author=George Orwell
, for example, in the infobox. It also accepts |authors=
. If the name of the field is on the whitelist, e.g. |fetchwikidata=author; genre; pub_date; pages; dewey; congress
, and the local value is not supplied, then the infobox will display the value retrieved from Wikidata. Any separators can be used, except | and {}.
As a shorthand, |fetchwikidata=ALL
will fetch all of the fields that are not blacklisted, as long as no local value is already provided in the article for a given field.
Since Wikidata labels are normally lower case, the ucfirst function from Module:String2 can be used to capitalise the first letter of the returned text, e.g.
{{#invoke:String2 | ucfirst | {{#invoke:WikidataIB |getValue |P136 |name=genre |fetchwikidata=ALL |onlysourced=false}} }}
in 动物庄园 (Q1396889) produces:- 影射小说、satirical fiction、寓言、反乌托邦作品
信息框中调用的示例
编辑Basic use of getValue:
{{#invoke:WikidataIB |getValue |P000 |name=fieldname |qid={{{qid|}}} |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |{{{localparameter|}}} }}
Full collection of parameters:
{{#invoke:WikidataIB |getValue |P000 |name=fieldname |qid={{{qid|}}} |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |noicon={{{noicon|}}} |wdl={{{wikidatalink|}}} |df={{dateformat|}} |bc={{{bc|}}} |prefix= |postfix= |linkprefix= |linkpostfix= |sorted={{{sorted|}}} |sep={{{separator|}}} |list={{listtype|}}} |{{{localparameter|}}} }}
Any of the parameters can, of course, be fixed for a given field in an infobox, rather than taking the parameter supplied to the infobox, which will affect all fields. For example, one field may set |list=hlist
where a series of short words is expected; whereas another field could use |list=ubl
where an unbulleted vertical list of several words on each line is required.
坐标
编辑The getCoords call will display the output of Template:Coord when supplied with the coordinates returned from Wikidata. It can be coded like this:
|label20 = Coordinates | data20 = {{#invoke:WikidataIB |getCoords |name=coordinates |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |{{{coordinates|}}} }}
An example is Template:Infobox biosphere reserve
{{Infobox biosphere reserve | fetchwikidata = ALL }}
Displays coordinates in the usual positions when used in an article where Wikidata has coordinates.
升级现有信息框
编辑Since the parameter |fetchwikidata=
is needed for any Wikidata functionality, an existing infobox may be replaced by an infobox incorporating these calls without any change whatsoever to any article. Each article using the new infobox can later be enabled by supplying |fetchwikidata=ALL
, or a list of required fields for that article. At that point, the onus is on the editor enabling the functionality to check that no unwanted fields are now being displayed. If so, they can be added to a blacklist for the article by setting |suppressfields=
to the list of unwanted fields.
可查证性
编辑Where it will always be essential for a particular field to only contain values that are referenced, use getValue
, making sure that |onlysourced=
is not set to 'false', '0' or 'no'. By default it will exclude values that are unsourced or only sourced to a Wikipedia, thus making the job of checking easier at the article level. If unsourced data is acceptable (!), set |onlysourced=no
. As it is beyond my wit to produce an automated mechanism that knows whether an existing source is reliable or not in a given context, that job must still be performed at the article level by an editor familiar with the subject. It should always be done when first enabling Wikidata for that article.
助手模板
编辑- Template:If then show
- tests whether the first unnamed parameter is not an empty string and returns it if it isn't. Otherwise it returns the second unnamed parameter. Optional third and fourth unnamed parameters provide a prefix and a suffix for the first parameter when returned. Useful when the first parameter is a call to Wikidata.
- Template:Ifnoteq then show
- tests whether the first unnamed parameter is equal to the second unnamed parameter and returns the third unnamed parameter if it does. Otherwise it returns the first unnamed parameter. This is useful when the first parameter is a
{{#invoke:
of a Lua module that returns a value for which a specific exception is required. - Template:If then wikilink
- tests whether the first unnamed parameter is not an empty string and if it isn't, it returns the parameter formatted as piped wiki-link using an optional namespace prefix.
- Template:Formatter link
- takes an external identifier code as
|code=
and uses a formatter url as|url=
to construct a link to the external resource, which uses the code as display. - Template:Emptyor
- tests a piece of text to ascertain whether it's effectively empty or contains some text. If the unnamed parameter consists only of html tags, punctuation (e.g. wiki markup) and whitespace, then Emptyor returns nothing; otherwise it returns the parameter unchanged. Wrapper for p.emptyor function.
Infobox book示例
编辑此章节摘自英文维基百科的Template:Infobox book/Wikidata/Sandbox/doc。
无维基数据
编辑{{Infobox book/Wikidata/Sandbox | suppressfields = | fetchwikidata = | name = Animal Farm | title_orig = Animal Farm: A Fairy Story | image = Animal Farm - 1st edition.jpg | image_size = 200px | caption = First edition cover | author = [[George Orwell]] | country = United Kingdom | language = English | genre = Political satire }}
Works as a non-aware infobox: only locally supplied parameters are displayed.
{{Infobox book/Wikidata/Sandbox | name = Animal Farm | title_orig = Animal Farm: A Fairy Story | image = Animal Farm - 1st edition.jpg | image_size = 200px | caption = First edition cover | author = [[George Orwell]] | country = United Kingdom | language = English | genre = Political satire }}
The blacklist and whitelist can be omitted if unused
全部采用维基数据
编辑{{Infobox book/Wikidata/Sandbox | fetchwikidata = author; genre; pub_date; pages; dewey; congress }}
Fetches the author, publication date, number of pages, Dewey index, and Library of Congress catalogue number values from Wikidata.
{{Infobox book/Wikidata/Sandbox | fetchwikidata = ALL }}
As shorthand, the |fetchwikidata=
parameter can be set to ALL to fetch all available fields.
Any field can be suppressed by naming it in |suppressfields=
, or overridden by supplying a local value.
停止显示流派
编辑{{Infobox book/Wikidata/Sandbox | suppressfields = genre | fetchwikidata = author; genre; pub_date; pages; dewey; congress }}
The genre field will always be suppressed, even if a local value is supplied.
{{Infobox book/Wikidata/Sandbox | suppressfields = genre | fetchwikidata = author; genre; pub_date; pages; dewey; congress | genre = Political satire }}
本地覆盖
编辑{{Infobox book/Wikidata/Sandbox | fetchwikidata = author; genre; pub_date; pages; dewey; congress | genre = Political satire }}
The genre field is set to display "Political satire", no matter what is stored in Wikidata.
{{Infobox book/Wikidata/Sandbox | fetchwikidata = ALL | genre = Novel }}
The genre field is set to display "Novel", no matter what is stored in Wikidata.
不获取流派
编辑{{Infobox book/Wikidata/Sandbox | suppressfields = | fetchwikidata = author; pub_date; pages; dewey; congress }}
The genre field will not be fetched from Wikidata. Only the author, publication date, number of pages, Dewey index, and Library of Congress catalogue number are imported. A local value for genre will display.
导出该模块
编辑WikidataIB has been developed to run on any language wiki (or Wikimedia project) with a minimum of modification. An optional sub-module Module:WikidataIB/i18n may be created to replace the values for error messages, ordinal suffixes etc. as shown in the local i18n definitions in the module. Although the same result can be arrived at by directly editing those values in WikidataIB, using the sub-module will allow an updated version of WikidataIB to directly replace the older module without having to re-edit the i18n definitions.
项目链接
编辑If the target Wiki has a convention that certain items are not normally linked (see en:Wikipedia:Manual of Style/Linking #What generally should not be linked for an example), then a sub-module Module:WikidataIB/nolinks can be created to list items that should not be linked, using the English Wikipedia sub-module as an exemplar.
斜体标题
编辑If the target Wiki has a convention that certain works should be italicised or quoted (see en:Wikipedia:Manual of Style/Text formatting #Names and titles for an example), then a sub-module Module:WikidataIB/titleformats can be created to list items that should be italicised or quoted, using the English Wikipedia sub-module as an exemplar.
复杂日期
编辑Most of the output from the module will use the local language (or any user-specified one on multi-lingual wikis) where the sitelink or label exists on Wikidata. However, dates are more complicated and not handled perfectly in all languages. To solve this, WikidataIB uses Module:Complex date – developed on Commons by Jarekt – which allows expansion to support a wider variety of languages. As a result, it is necessary to install Complex date and its dependencies alongside WikidataIB when installing on another Wikimedia project.
复杂日期依赖
编辑Module:Complex_date relies on the following modules:
- Module:Calendar (lazy loading with no dependencies)
- Module:ISOdate
- Module:DateI18n (no dependencies)
- Module:i18n/complex date
- Module:Ordinal (lazy loading)
- Module:I18n/ordinal (no dependencies)
- Module:Yesno (from en.wikipedia) (no dependencies)
- Module:Formatnum (no dependencies)
- Module:Roman (lazy loading with no dependencies)
- Module:Linguistic (lazy loading with no dependencies)
- Module:Ordinal (lazy loading)
Unless otherwise noted, the authoritative version of each module can be found on Commons although the versions on English Wikipedia are usually kept in sync.
另见
编辑- Module:Wikidata,更底层的处理维基数据
- Template:WikidataOI,使用Module:Wd的模板,可选提供
|fetch=
和|ifeq=
选项,类似此模块的|fetchwikidata=
与|fwd=
追踪分类
编辑- Category:缺少维基数据信息的条目(367)