Module:Wikidata/doc

英文維基百科中已棄用該模組，並推薦使用 Module:WikidataIB 或 Module:Wd 代替。

方法

“” 模組包含下列方法，將屬性 ID 作為首個引數提供，可從維基資料中檢索任何屬性的值：

getValue：以 wiki 內鍊形式返回值（如果適用）。其他值的輸出類似，但如果值有首選等級則值返回有首選等級的值。與:w:ru:Модуль:Wikidata 的 formatStatements 不同，getValue 不獲取任何參考資料（另見:w:en:Module talk:Wikidata/Archive 1#Why the references from Wikidata get dropped?）。
getRawValue：返回的屬性值不加內鏈，數字使用千位分隔符。將數量屬性的數值返回為純數字。其他值的輸出類似，包括一般的值，即使存在首選的值。
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 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：返回格式化後的日期

如果呼叫此程式碼的條目在維基資料中沒有定義屬性，則返回一個空字串（""）。

1.1 訪問其他 QID

2015 年 9 月 16 日起，可以透過其他條目的 QID 獲取其他條目的資料。

呼叫如下：

與 getValue 相同，但使用一個額外的引數表示要獲取屬性值的 QID。

例如：

將從本維基百科中的標題為理查德・伯頓的頁面對應的維基資料項（}}）中獲取 ' 配偶 '（P26）列表，以內鍊形式展示。

如此，可以在使用者名稱空間中設定測試環境，但請注意，這些是 “高成本” 呼叫，請不要過度使用。

引數

對一般用法（getValue），提供兩個未命名引數。第一個是要檢索的屬性 ID（例如 P19 對應出生地）。第二個引數可能為空、"FETCH_WIKIDATA"，或者將作為返回值的其他字串。
對於一般的不加內鏈用法（getRawValue），提供兩個未命名引數。第一個是要檢索的屬性 ID（例如 P21 對應性別）。第二個引數可能為空、"FETCH_WIKIDATA"，或者將作為返回值的其他字串。
對於一般的日期用法（getDateValue），提供三個未命名引數。第一個是要檢索的屬性 ID（例如 P569 對應出生日期）。第二個引數可能為空、"FETCH_WIKIDATA"，或者將作為返回值的其他字串。第三個引數是返回的日期格式，可能為 dmy, mdy, my 或 y（另見實際原始碼）。

請注意，wikibase 呼叫不再支援小寫引數：p123，因此如果出現問題，檢查是否正確使用了大寫引數（如 P123）。

用法

3.1 例子：配偶 (P26)

= 不返回任何內容
= 返回內鍊形式的維基資料中儲存的 P26（配偶）屬性
= 返回 Hillary Rodham Clinton，即允許資訊框使用本地自定義的值代替維基資料中的值。

3.2 資訊框模板中使用

資訊框的定義中可以這樣呼叫：

使資訊框變為：

資訊框引數 | spouse 設為空（即 "| spouse ="）時，不顯示 spouse
未提供資訊框引數 | spouse 時，根據維基資料內容顯示內鍊形式的一個或多個值
本地提供資訊框引數時，顯示本地提供的引數 | spouse。例如 "|spouse = Hillary Rodham Clinton"

另一種方式：

使資訊框變為：

資訊框引數 | spouse 設為空（即 "| spouse ="）時，不顯示 spouse
未提供資訊框引數 | spouse 時，不顯示 spouse
本地提供資訊框引數時，顯示本地提供的引數 | spouse。例如 "|spouse = Hillary Rodham Clinton"
本地將資訊框引數設為 FETCH_WIKIDATA 時，根據維基資料內容顯示內鍊形式的一個或多個值

另見 Module:WikidataIB 版本，支援在每個條目上用本地引數定義：不顯示的引數（黑名單）；僅從維基資料自動獲取哪些引數（白名單）。用它可以修改資訊框而不對使用資訊框的條目內容和效果產生任何修改，直至在條目中明確啟用相應引數。

3.3 例子：出生地

方式如上所述：

= 不返回任何內容
= 返回內鍊形式的維基資料中儲存的 P19（出生地）屬性，指向對應條目
= 返回 Hope，即允許資訊框使用本地自定義的值代替維基資料中的值。

3.4 例子：性別

不希望返回內鍊形式的性別，因此使用：

-

3.5 例子：出生日期

使用 dmy 格式的出生日期則使用：

-

使用 mdy 格式的出生日期則使用：

-

僅獲取出生年份：

-

獲取出生年份（BC）但希望顯示為 BCE：

-

3.6 例子：連結到一個維基資料項

使用下列程式碼檢索 QID：

-

用 wiki 語法的內鏈連結到維基資料：

-

3.7 例子：連結到另一個 wiki 頁面

連結到另一個 wiki 站點，此例為英文維基導遊：

-

測試

4.1 配偶

複製並貼上下列程式碼到任何條目並預覽（請勿儲存！）：

-

在比爾・克林頓中可以看到：

-
希拉里・克林頓

但在貝拉克・奧巴馬中：

-
米歇爾・奧巴馬
希拉里・克林頓

在理查德・伯頓中：

-
Elizabeth Taylor, Sally Burton, Sybil Christopher, Suzy Miller, Elizabeth Taylor
希拉里・克林頓

在弗朗茨・卡夫卡中則是：

-
希拉里・克林頓

4.2 出生地

複製並貼上下列程式碼到任何條目並預覽（請勿儲存！）：

-

在威廉・埃勒裡中嘗試，看到維基資料如何正確的消歧義。

4.3 測試 getValue、getRawValue 及 getDateValue

複製並貼上下列程式碼到任何條目並預覽（請勿儲存！）：

-

如果存在，這分別會返回出生地、配偶、國籍、宗教、性別、出生日期（兩種格式）、出生年份。