Модуль:Wd/документація
Зовнішній вигляд
Це підсторінка документації модуля Модуль:Wd. Вона містить інформацію про використання, категорії та інший вміст, що не є частиною оригінальної сторінки модуля. |
Цей модуль помічено як К:альфа-модуль (14). У нього можуть вносити редагування треті особи і його можна використати на кількох сторінках, аби перевірити можливі проблеми пов'язані з використанням модуля, використовувати його слід обережно. Вітаються пропозиції щодо нової функціональности чи зміни в механізмах їхнього вводу і виводу. |
Цей модуль Lua використовується на близько 39 000 сторінках і його зміни будуть дуже помітними. Будь ласка, перевіряйте будь-які зміни на підсторінках /пісочниці та /тестів цього модуля, або у вашій пісочниці модуля, та зважайте на обговорення змін на сторінці обговорення перед їхнім впровадженням. |
Цей модуль залежить від наступних модулів: |
This модуль is intended to fetch data from Wikidata with or without a link to the connected Wikipedia article.
The модуль is under development and is not yet complete. Of the available datatypes, it currently supports strings, quantities, monolingual text, time and globe coordinates.
Usage
[ред. код]{{#invoke:wd|function|flag1|flag2|flag3|arg1|arg2|arg3}}
Functions
[ред. код]property
Returns the requested property or list of properties from the given item.qualifier
Returns the requested qualifier or list of qualifiers from the given property of the given item.propertyWithQualifier
Returns the requested property and its requested qualifier or a list thereof from the given item, with the qualifier formatted between parentheses behind the property and with units of measurement if applicable.label
Returns the label of the given item or property.main
Intended for use by wrapper templates (around this module) to invoke one of the above functions, returning their respective output.
Parameters
[ред. код]Flags
[ред. код]linked
Creates a link to the Wikipedia article that is connected to the property or qualifier if it exists.
If this parameter is omitted, then the plain property or qualifier value will be returned.unit
Appends the unit of measurement to the value if applicable.
For units, thelinked
flag behaves slightly different in that it links the unit of measurement where it would normally link the property or qualifier value.
If this flag is used with time datatypes, then it makes the returned dates more verbose (e.g.11 February 1731
). Either way, dates in the Julian calendar stored with a precision of days through millenniums will have "Julian" attached to the output, where without theunit
flag it will look like1731-2-11/Julian
(which may be split off using the{{#titleparts}}
template function).
If this flag is used with globe coordinate datatypes, then it adds the various symbols to the returned value (e.g.52°5'3"N, 4°19'3"E
). Without theunit
flag, globe coordinates will look like52/5/3/N/4/19/3/E
(which may be split into parts using the{{#titleparts}}
template function).short
(EXPENSIVE
when used)
Gets the short name (P1813) of any item returned if they have one attached. If that is not the case, then the default behaviour of returning the item label will occur.single
Returns only a single value instead of multiple (if multiple claims match). The returned value is the first match found from the best-ranked claims.- One of:
best
(default)preferred
normal
deprecated
Sets a rank constraint for the selected claims.
The latter three can be followed by a+
or a-
, e.g.normal+
orpreferred-
, where the first selects claims with a 'normal' rank or higher and the second selects claims with a 'preferred' rank or lower. To get claims of all ranks, usepreferred-
ordeprecated+
.
Output is always sorted from highest rank to lowest (regardless of this flag being set). - One of:
future
current
former
Sets a time constraint for the selected claims. Uses the claims' qualifiers of start time (P580) and end time (P582) to determine if the claim is valid for the selected time period.
Arguments
[ред. код]property | [<flags>] | [<item_id>] | <property_id>
<flags>
(optional)
A list of flags (see above).<item_id>
(optional,EXPENSIVE
when used)
Q-identifier of the item to be accessed (e.g. Q55).
If this parameter is omitted, then the item connected to the current page will be used.<property_id>
P-identifier of the property to be accessed (e.g. P38).
qualifier | [<flags>] | [<item_id>] | <property_id> | [<claim_id_or_value>] | <qualifier_id>
<flags>
(optional)
A list of flags (see above).<item_id>
(optional,EXPENSIVE
when used)
Q-identifier of the item to be accessed (e.g. Q55).
If this parameter is omitted, then the item connected to the current page will be used.<property_id>
P-identifier of the property to be accessed (e.g. P38).<claim_id_or_value>
(optional)
Either the Q-identifier of the particular claim to be accessed (e.g. Q6655) or a literal value (i.e. string or quantity etc., no item label) equal to the claim to be accessed.
Dates as literal values must be formattedyear-month-day
(e.g.1731-2-11
) for dates with a precision of days,year-month
(e.g.1731-2
) for dates with a precision of months, andyear
(e.g.1731
) for dates of lesser precision without any spaces or leading zeros. Dates BCE require a minus sign in front of the year (e.g.-2950-1-31
). Dates stored in the Julian calendar must have/Julian
attached to the end (e.g.1731-2-11/Julian
). Decades like the 2010s must be given as2010
(but the 2010s BCE as-2019
), centuries like the 20th century as1901
(but the 20th century BCE as-2000
), and millenniums like the 3rd millennium as2001
(but the 3rd millennium BCE as-3000
).
Globe coordinates as literal values must be formatted with forward slashes (i.e./
) between the parts and no symbols (e.g.52/5/3/N/4/19/3/E
) without any spaces or leading zeros.
The special type 'no value' can be given by entering the empty string (i.e.||
) and the special type 'unknown value' can be given by entering a space (i.e.|␣|
).
If this parameter is omitted, then all claims (matching any other constraints) within the property will be accessed.<qualifier_id>
P-identifier of the qualifier to be accessed (e.g. P518).
propertyWithQualifier | [<flags>] | [<item_id>] | <property_id> | [<claim_id_or_value>] | <qualifier_id>
This function is equivalent toqualifier
, except that the property is also returned with the qualifier between parentheses behind it. It also enables theunit
flag (see above).
label | [<flags>] | [<item_or_property_id>]
<flags>
(optional)
A list of flags (see above).<item_or_property_id>
(optional)
Q-identifier of the item (e.g. Q55) or P-identifier of the property (e.g. P38) to be accessed.
If this parameter is omitted, then the item connected to the current page will be used.
main | <function> | [<parameters>]
<function>
The name of one of the above functions.<parameters>
(optional)
A list of flags and arguments applicable to the chosen function.
Examples
[ред. код]property
[ред. код]{{#invoke:wd|property|Q55|P395}}
→ NL
- Q55 (Нідерланди), P1549 (катойконім): [monolingual text]
{{#invoke:wd|property|Q55|P1549}}
→ голандець
property with rank
[ред. код]- Q55 (Нідерланди), P38 (валюта): [item label]
- best rank (default)
{{#invoke:wd|property|Q55|P38}}
→ євро{{#invoke:wd|property|best|Q55|P38}}
→ євро{{#invoke:wd|property|best|linked|Q55|P38}}
→ євро
- other ranks
{{#invoke:wd|property|preferred|Q55|P38}}
→ євро{{#invoke:wd|property|preferred-|linked|Q55|P38}}
→ євро
{{#invoke:wd|property|normal+|Q55|P38}}
→ євро{{#invoke:wd|property|normal|Q55|P38}}
→ нідерландський гульден
property with time constraint
[ред. код]- Q55 (Нідерланди), P38 (валюта): [item label]
{{#invoke:wd|property|normal+|current|Q55|P38}}
→ євро{{#invoke:wd|property|normal+|former|Q55|P38}}
→ нідерландський гульден
property with short name
[ред. код]- Q55 (Нідерланди), P38 (валюта): [item label]
{{#invoke:wd|property|normal|current|short|Q55|P38}}
→ долар США{{#invoke:wd|property|normal|current|short|linked|Q55|P38}}
→ долар США
property with unit
[ред. код]- Q55 (Нідерланди), P2884 (мережева напруга): [quantity]
{{#invoke:wd|property|unit|Q55|P2884}}
→ вольт{{#invoke:wd|property|unit|linked|Q55|P2884}}
→ вольт
property with return of globe coordinate
[ред. код]- Q55 (Нідерланди), P625 (географічні координати): [globe coordinate]
{{#invoke:wd|property|Q55|P625}}
→ 52°19'N, 5°33'E{{#invoke:wd|property|unit|Q55|P625}}
→ 52°19'N, 5°33'E{{#invoke:wd|property|unit|linked|Q55|P625}}
→ 52°19'N, 5°33'E
property with return of single value
[ред. код]- Q55 (Нідерланди), P150 (адміністративно-територіально поділяється на): [item label]
{{#invoke:wd|property|Q55|P150}}
→ Гронінген{{#invoke:wd|property|single|Q55|P150}}
→ Гронінген
qualifier
[ред. код]qualifier with rank
[ред. код]- Q55 (Нідерланди), P38 (валюта), P518 (стосується частини): [item label]
- best rank (default)
{{#invoke:wd|qualifier|Q55|P38|P518}}
→ European Netherlands{{#invoke:wd|qualifier|best|Q55|P38|P518}}
→ European Netherlands{{#invoke:wd|qualifier|best|linked|Q55|P38|P518}}
→ European Netherlands
- other ranks
{{#invoke:wd|qualifier|preferred|Q55|P38|P518}}
→ European Netherlands{{#invoke:wd|qualifier|preferred-|linked|Q55|P38|P518}}
→ European Netherlands; Нідерландські Карибські острови
{{#invoke:wd|qualifier|normal+|Q55|P38|P518}}
→ European Netherlands; Нідерландські Карибські острови{{#invoke:wd|qualifier|normal|Q55|P38|P518}}
→ Нідерландські Карибські острови
qualifier with time constraint
[ред. код]- Q55 (Нідерланди), P38 (валюта), P518 (стосується частини): [item label]
{{#invoke:wd|qualifier|normal+|current|Q55|P38|P518}}
→ European Netherlands; Нідерландські Карибські острови{{#invoke:wd|qualifier|normal+|former|Q55|P38|P518}}
→
qualifier with claim ID
[ред. код]- Q55 (Нідерланди), P38 (валюта), Q4917 (долар США), P518 (стосується частини): [item label]
{{#invoke:wd|qualifier|Q55|P38|Q4917|P518}}
→ Нідерландські Карибські острови{{#invoke:wd|qualifier|linked|Q55|P38|Q4917|P518}}
→ Нідерландські Карибські острови
qualifier with literal value
[ред. код]- Q55 (Нідерланди), P2884 (мережева напруга), 230 volt, P2144 (частота): [quantity]
{{#invoke:wd|qualifier|Q55|P2884|230|P2144}}
→ 50 герц
qualifier with unit
[ред. код]- Q55 (Нідерланди), P2884 (мережева напруга), 230 volt, P2144 (частота): [quantity]
{{#invoke:wd|qualifier|unit|Q55|P2884|230|P2144}}
→ герц{{#invoke:wd|qualifier|unit|linked|Q55|P2884|230|P2144}}
→ герц
qualifier with return of time
[ред. код]- Q55 (Нідерланди), P38 (валюта), Q788472 (нідерландський гульден), P582 (час/дата закінчення): [time]
{{#invoke:wd|qualifier|Q55|P38|Q788472|P582}}
→ 1 січня 2002{{#invoke:wd|qualifier|unit|Q55|P38|Q788472|P582}}
→ 1 січня 2002
propertyWithQualifier
[ред. код]- Q55 (Нідерланди), P2884 (мережева напруга), P2144 (частота): [quantity]
{{#invoke:wd|propertyWithQualifier|Q55|P2884|P2144}}
→ Помилка скрипту: Функції «propertyWithQualifier» не існує.{{#invoke:wd|propertyWithQualifier|linked|Q55|P2884|P2144}}
→ Помилка скрипту: Функції «propertyWithQualifier» не існує.
- Q55 (Нідерланди), P38 (валюта), P518 (стосується частини): [item label]
{{#invoke:wd|propertyWithQualifier|normal+|current|Q55|P38|P518}}
→ Помилка скрипту: Функції «propertyWithQualifier» не існує.{{#invoke:wd|propertyWithQualifier|normal+|current|short|linked|Q55|P38|P518}}
→ Помилка скрипту: Функції «propertyWithQualifier» не існує.
If the module is transcluded on the Netherlands page (which is linked to Q55), then the Q55
can be omitted:
- P38 (валюта), P518 (стосується частини): [item label]
{{#invoke:wd|propertyWithQualifier|normal+|current|P38|P518}}
→ Помилка скрипту: Функції «propertyWithQualifier» не існує.
label
[ред. код]{{#invoke:wd|label|Q4917}}
→ долар США
{{#invoke:wd|label|linked|Q4917}}
→ долар США
{{#invoke:wd|label|short|Q4917}}
→ долар США
{{#invoke:wd|label|short|linked|Q4917}}
→ долар США
{{#invoke:wd|label|P38}}
→ валюта
See also
[ред. код]- {{Wikidata}}, a user-friendly wrapper template for this module.
Це сторінка документації для Модуль:Wd