コンテンツにスキップ

英文维基 | 中文维基 | 日文维基 | 草榴社区

モジュール:WikidataIB/doc

WikidataIB
開発元 英語版ウィキペディア[1]
初版 2016年5月16日 (8年前) (2016-05-16)[2]
最新版
随時更新
最新評価版
随時更新 / sandbox
リポジトリ en.wikipedia.org/wiki/Module:WikidataIB
プログラミング
言語
Lua
プラットフォーム 各国語版ウィキペディア
対応言語 日本語
サポート状況 開発中
種別 モジュール
ライセンス CC BY-SA 3.0 Unported
公式サイト en.wikipedia.org/wiki/Module:WikidataIB
テンプレートを表示

モジュール:WikidataIBは、ウィキデータに格納されたデータをInfoboxで利用する判断をInfobox設計者から記事執筆者に移行する機構を実装するために設計されたモジュールです[1]

モジュールは英語版ウィキペディアでLua言語を用いて開発されています。オリジナル実装・新しい機能の使い方・詳しい使い方は英語版オリジナルモジュール(en:Module:WikidataIB)を参照してください。

モジュールとテストケース
モジュール テストケース
メイン モジュール:WikidataIB モジュール‐ノート:WikidataIB/testing
サンドボックス モジュール:WikidataIB/sandbox差分 モジュール‐ノート:WikidataIB/sandbox/testing差分

関数

[編集]

2018年4月現在[注釈 1]、モジュールはInfoboxで利用するための以下の関数を提供します。

  1. getValue
    getSourcedValue - 廃止:getValueで代用
  2. getPreferredValue
  3. getNormalValue
  4. getCoords
  5. getQualifierValue

廃止されたgetSourcedValue関数は、getValue関数を引数|onlysourced=trueで利用した動作と重複するものとして削除されました。

以下のユーティリティ関数も提供します。

  1. getLink
  2. getLabel
  3. getAT
  4. getDescription
  5. formatDate
  6. checkBlacklist
  7. emptyor

共通仕様

[編集]

引数の真偽値は、真はtrue/yes/1、偽はfalse/no/0で指定します。ヌル文字はデフォルト値として扱われます。その他の全ての値は真として扱われてますが、可読性のためtrue/falseやyes/noを指定することが推奨されます。

引数の文字列は、任意の文字列・文を指定します。文字列にスペースを入れる場合は明示的にダブルクオーテーション(")で括ります。ダブルクオーテーションで明示しない場合は前後のスペースはトリミングされます。パイプ文字は{{!}}でエスケープします。

複数の値を返す関数は、複数の値をセパレータで区切って1つの文字列として返却します。デフォルトのセパレータは, です。引数で変更可能な場合があります。日本語版ウィキペディアでは区切り文字にカンマは推奨されないので(WP:YAKUMONO)、Infoboxに表示する場合には可能であれば変更するべきです。中点と読点のいずれを使うかはInfoboxの慣習に従います。

いくつかの関数は、|qid=などで他記事のアイテムIDを指定してプロパティ・修飾子の値を取得できます。通常用途で利用することはなく、試験用途では便利かもしれません。通常用途でも利用は可能ですが、不必要に高負荷です。

getValue

[編集]

関数getValueは、記事主題に関するウィキデータ エンティティから第1無名引数で指定したプロパティIDの値を取得します。

{{#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> |<local parameter>}}

フィールド名はブラックリスト・ホワイトリストの表示有無の評価に使用します。与えられたフィールド名をまず最初にブラックリストで表示有無を判断します。例えば、どんな状況でも表示しない場合に利用します。ブラックリストにフィールドがない場合、次にホワイトリストで表示有無を判断します。ホワイトリストにフィールドがある場合、記事内の実値、ウィキデータの値、2番目の無名引数を値を順に評価していずれかを返却します。ブラックリスト・ホワイトリストが使われている場合は、名前付き引数|name=は必須です。ブラックリスト・ホワイトリストが使われていて名前付き引数|name=がない場合は、関数は空文字を返却します。

取得した値は|prefix=|postfix=|linkprefix=|linkpostfix=で接頭語・接尾語の文字列を付与できます。|linkprefix=を利用しない場合、|prefix=|postfix=だけが利用されます。|linkprefix=を利用する際は4つの接頭語・接尾語が全て使用され、各値毎に付与されます。

複数の値を持つプロパティはソートせず、セパレータで区切って、1つの文字列として返却されます。ソートを指定した場合は非常に単純なアルファベットソートで並び替えを実施しますが、リンク型の値は[[ ...として並び替えします。複数の値は|sep=|list=で結合・表示形式を変更できます。|sep=は結合する際の区切り文字を指定します。|list=hlistは横リストで表示し、|list=ublは非接頭句縦リストで表示します。アクセシビリティのため、非接頭句縦リストは|sep=<br>ではなく|list=ublを利用すべきです。

Infoboxのフィールドに値の改善を誘導するウィキデータで編集アイコンを表示します。アイコンは該当のプロパティのウィキデータページにリンクしています。

取得する値は出典がない、もしくは、出典がウィキペディアのみの値を除外して、適切な出典の付与された値のみを返却します。出典の有無を問わず値を取得する場合は|onlysourced=falseを指定します。

wikibase-itemsと呼ばれるウィキペディアの記事に紐付いたアイテムは、可能であればウィキペディアの記事に対応したウィキリンクに変換して返却します。URIとなるウィキメディア・コモンズのメディア、URL、外部リンク、その他の類似する文字列を表すアイテムは、リンクに変換して返却します。その他の値型は、mwdiawikiライブラリがformatPropertyValues()を呼び出して返却します。

引数

  • 1番目の無名引数は、取得対象のプロパティIDを指定します。
  • 2番目の無名引数は、ウィキデータに値がない場合のデフォルト値を指定します。
  • |qid=は、ウィキペディア記事のアイテムIDを指定します(高負荷)。
  • |name=は、フィールドの名前を指定します。
  • |suppressfields=は、フィールド名のブラックリストを指定します。
  • |fetchwikidata=は、フィールド名のホワイトリストを指定します。キーワードALLは全フィールドを取得します。
  • |onlysourced=は、出典有無による値返却を真偽値で指定します。デフォルトはtrueです。
  • |noicon=は、値の改善を促すため編集アイコンの非表示化を真偽値で指定します。デフォルトはfalseです。
  • |df=は、年月日の値のフォーマットをdmy(日月年)、mdy(月日年)、y(年)のいずれかで指定します。デフォルトのフォーマットはdmyです。
  • |bc=は、年月日の値の接尾辞にBCもしくはBCEを必要とする値のために指定します。デフォルト値はBCEです。
  • |prefix=|postfix=は、値の接頭語・接尾語を指定します。
  • |linkprefix=|linkpostfix=は、リンク型の値の接頭語・接尾語を指定します。
  • |sorted=は、複数の値のソート有無を真偽値で指定します。デフォルトはfalseです。
  • |sep=は、複数の値を結合する際のセパレータを指定します。
  • |list=は、複数の値のリスト形式を指定します。セパレータ指定を上書きし、ウィキデータで編集アイコンを非表示にします。

ウィーン天文台 (Q532127)を対象にした例です。

  • 所有者 (P127)を取得
    • {{#invoke:WikidataIB|getValue|P127|fetchwikidata=ALL|onlysourced=no|qid=Q532127}}
  • 成立日 (P571)を年で取得
    • {{#invoke:WikidataIB|getValue|P571|fetchwikidata=ALL|onlysourced=no|df=y|qid=Q532127}}
    • → 1753年 ウィキデータを編集
  • 天文台コード (P717)を接頭語・接尾語を付与して取得
    • {{#invoke:WikidataIB|getValue|P717|fetchwikidata=ALL|onlysourced=no|prefix="before "|postfix=" after"|qid=Q532127}}
    • → before 045 after ウィキデータを編集
  • 天文台コード (P717)天文台コード一覧の節にリンクして取得
    • {{#invoke:WikidataIB|getValue|P717|fetchwikidata=ALL|onlysourced=no|prefix= |postfix=|linkprefix="天文台コード一覧#"|linkpostfix=|qid=Q532127}}
    • → [天文台コード一覧#045 045] ウィキデータを編集

getPreferredValue

[編集]

関数getPreferredValueは、関数getValueと同じ引数を扱い、同じ挙動をしますが、ウィキデータの値にpreferred rankが設定されている場合はそれらの値のみを取得します。

{{#invoke:WikidataIB |getPreferredValue |<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> |<local parameter>}}

getNormalValue

[編集]

関数getNormalValueは、関数getPreferredValueと同じ引数を扱い、同じ挙動をしますが、ウィキデータの値にnormal rankが設定されている場合はそれらの値のみを取得します。値にpreferred rankとnormal rankが混在している場合は、それぞれが個別の値を返却します。

{{#invoke:WikidataIB |getNormalValue |<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> |<local parameter>}}

getCoord

[編集]

関数getCoordは、記事主題に関するウィキデータ エンティティから位置座標 (P625)の値を取得して、値をTemplate:Coordに渡します。

{{#invoke:WikidataIB |getCoords |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |display=<path value to template:Coord> |<local parameter>}}

引数

  • |qid=は、ウィキペディア記事のアイテムIDを指定します(高負荷)。
  • |suppressfields=は、ブラックリストを指定します。
  • |fetchwikidata=は、ホワイトリストを指定します。
  • |display=は、Template:Coord|display=に渡す値を指定します。デフォルト値はinline, titleです。

getQualifierValue

[編集]

関数getQualifierValueは、記事主題に関するウィキデータ エンティティからプロパティの修飾子の値を取得します。

{{#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>}}

引数

  • 1番目の無名引数は、プロパティIDを指定します。
  • |qid=は、ウィキペディア記事のアイテムIDを指定します(高負荷)。
  • |pval=は、修飾子のプロパティIDを指定します。
  • |qual=は、修飾子IDを指定します。
  • |suppressfields=は、ブラックリストを指定します。
  • |fetchwikidata=は、ホワイトリストを指定します。
  • |onlysourced=は、出典有無による値返却を真偽値で指定します。デフォルトはtrueです。

南極点望遠鏡 (Q1513315)を対象にした例です。

[編集]

関数getLinkは、アイテムIDに紐付いたウィキペディアに記事が存在する場合にウィキリンクを取得します。

{{#invoke:WikidataIB |getLink | <Item ID> }}

取得する値はウィキデータにラベルが存在する場合はラベルにパイプし、ラベルが存在しない場合はIDにパイプします。ウィキペディアに記事が存在しない場合はラベルもしくはIDを返却します。

  • 宇宙 (Q1)のリンクを取得
    • {{#invoke:WikidataIB|getLink|Q1}}
    • 宇宙
  • 映像 (P10)のリンクを取得
    • {{#invoke:WikidataIB|getLink|P10}}
    • → 映像

getLabel

[編集]

関数getLabelは、アイテムIDのラベルもしくはIDを取得します。

{{#invoke:WikidataIB |getLabel | <Item ID> }}

  • 宇宙 (Q1)のラベルを取得
    • {{#invoke:WikidataIB|getLabel|Q1}}
    • → 宇宙
  • 映像 (P10)のラベルを取得
    • {{#invoke:WikidataIB|getLabel|P10}}
    • → 映像

getAT

[編集]

関数getATは、アイテムIDの記事のタイトルを取得します。

{{#invoke:WikidataIB |getAT | <Item ID> }}

取得する値はウィキペディア記事のタイトルです。記事が存在しないアイテムはヌル文字を返却します。

  • 宇宙 (Q1)の記事タイトルを取得
    • {{#invoke:WikidataIB|getAT|Q1}}
    • → 宇宙
  • 映像 (P10)の記事タイトルを取得
    • {{#invoke:WikidataIB|getAT|P10}}

getDescription

[編集]

関数getDescriptionは、アイテムIDの説明文を取得します。

{{#invoke:WikidataIB |getDescription | <wikidata/none/sentence for display> }}

引数

  • 1番目の無名引数は、wikidataが指定された場合はウィキデータの値を、noneが指定された場合はヌル文字を返却します。
  • |qid=は、ウィキペディア記事のアイテムIDを指定します(高負荷)。

ウィーン天文台 (Q532127)を対象にした例です。

  • 説明文を取得
    • {{#invoke:WikidataIB|getDescription|wikidata|qid=Q532127}}
    • → observatory in Austria
  • 説明文を取得しない
    • {{#invoke:WikidataIB|getDescription|none|qid=Q532127}}
  • 説明文を指定
    • {{#invoke:WikidataIB|getDescription|オーストラリアの天文台|qid=Q532127}}
    • → オーストリアの天文台

formatDate

[編集]

関数formatDateは、mw.wikibase.entity:formatPropertyValuesから取得する、1 August 30 BCEのような、日付フォーマットを第1引数に受け取り、|df=|bc=で指定したフォーマットします。

{{#invoke:WikidataIB |formatDate | <date value> |df=<dmy/mdy/y> |bc=<BC/BCE> }}

引数

  • |df=は、年月日の値のフォーマットをdmy(日月年)、mdy(月日年)、y(年)のいずれかで指定します。デフォルトのフォーマットはdmyです。
  • |bc=は、接尾辞にBCもしくはBCEを必要とする値のために指定します。デフォルト値はBCEです。

  • |bc=BCを指定
    • {{#invoke:WikidataIB|formatDate|1 August 30 BCE|bc=BC}}
    • → 1 August 30 BC
  • |df=mdy|bc=BCを指定
    • {{#invoke:WikidataIB|formatDate|1 August 30 BCE|bc=BC|df=mdy}}
    • → August 1, 30 BC

Infoboxテンプレートのコーディング

[編集]

Infoboxテンプレートでは、特に関数getValueを適切なテンプレートパラメータを転用してInfoboxフィールドのdata部で利用します。

Infoboxテンプレートのコードは従来のものと基本的構成に変わりはありません。{{Infoboxから始まり、title・image・label/data・belowなどを記述して、}}<noinclude>{{Documentation}}</noinclude>で締めます。主に異なるのはdataの値の箇所です。

data部のコード

[編集]

Infoboxのdata部は従来のInfobox構成とは異なり、ウィキデータの値を利用するために{{#invoke:WikidataIBgetValue|...を指定します。

第1無名引数には取得対象のプロパティIDを指定します。第2無名引数には従来のdata部でも記入しているテンプレートパラメータを指定します。|name=は分かり易い文字列、例えばlabelの値やその別名、を指定します。その他の引数はInfobox設計者ではなく記事執筆者が変更可能なようにテンプレートパラメータを転用します。

  • data部の基本的な例:
    • {{#invoke:WikidataIB |getValue |P000 |name=fieldname |fetchwikidata={{{fetchwikidata|}}} |onlysourced={{{onlysourced|}}} |{{{localparameter|}}} }}
  • data部のgetValue全パラメータの例:
    • {{#invoke:WikidataIB |getValue |P000 |name=fieldname |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|}}} }}

当然、任意のパラメータは、全てのフィールドに適用されるテンプレートを転用するだけでなく、特定フィールドを明示指定することができます。例えば、原則的には全てフィールドで短い単語を横リスト|list=hlistで表示し、特定フィールドで長い単語を縦リスト|list=ublで表示します。

緯度・経度

[編集]

関数getCoordsはウィキデータから値を取得してTemplate:Coordを通した結果を取得します。

|label20 = Coordinates
| data20 = {{#invoke:WikidataIB |getCoords |name=coordinates |suppressfields={{{suppressfields|}}} |fetchwikidata={{{fetchwikidata|}}} |{{{coordinates|}}} }}

出典の要否判断

[編集]

特定のフィールドで出典が付与されていることが常に必須の場合は、|onlysourced=にfalseが設定されていないことを確認してgetValueを利用します。デフォルトでは出典がない、もしくは、出典がウィキペディアのみの値は除外されているので、記事単位での確認作業は簡単になっています。好ましくはありませんが、もし出典のないデータを受け入れるのであれば|onlysourced=noを設定します。その情報の出典の要否・信頼性を自動的に判別する機構を構築することは本モジュールの目的外であり、出典の適正判断はその分野に精通した人たちがしなければならない作業です。

そのため、Infobox設計者は、全てのフィールドのdata部で|onlysourced={{{onlysourced|}}}を指定して記事単位で出典要否を記事執筆者に判断させる他に、事前に出典を求めることが難しい特定フィールドは|onlysourced=noを指定してテンプレートレベルで出典なしを許容して、記事執筆者には原則|onlysourced=の値を変更させないというテンプレート設計をする判断もあります。Infoboxテンプレートの|onlysourced=の指定で判断が揺れる場合はノート等で議論します。また、記事執筆者は、記事で新しいInfoboxテンプレートを初めて有効にした際には、必ず出典の要否・付与可否を判断すべきです。

出典を求めないことはウィキペディアの方針として原則は適切ではないですが、例えば書籍のジャンルに出典を求める必要性は疑わしいという見方があり、ウィキペディア・ウィキデータに出典がない記事・データは多数あります(参考私論:Wikipedia:空が青いということに出典は要らない)。

既存のInfoboxのアップグレード

[編集]

|fetchwikidata=は本モジュールを使ったウィキデータの連携機能に必ず必要となるため、既存の記事のInfoboxは同パラメータを組み込んだInfoboxの記述に置き換える必要があります。ただし、他の箇所を変更する必要はありません。新しいInfoboxを使用したそれぞれの記事は、ホワイトリストの|fetchwikidata=にキーワードALLもしくは利用するフィールド名のリストを指定することで、ウィキデータを利用するようになります。この時、各フィールドを表示する・しないの判断は記事編集者に委ねられます。もし表示したくないフィールドがある場合は、|suppressfields=を使って表示したくないフィールドをブラックリストに追加します。

サンプル

[編集]

簡単な実装サンプルはen:Template:Infobox book/Wikidata/Sandboxにあります。

サンプルで提示したように、Infoboxでは著者(Author)フィールドを以下のようにコーディングします。

| label2 = Author{{#if:{{{authors|}}}|s}}
| data2 = {{#invoke:WikidataIB|getValue |P50 |name=author |fetchwikidata={{{fetchwikidata|}}} |suppressfields={{{suppressfields|}}} |{{{authors|{{{author|}}}}}} }}

取得するプロパティは第1無名パラメータで、この場合は著者 (P50)です。その他のパラメータは記事内のテンプレートパラメータを転用しています。ブラックリスト・ホワイトリストがテンプレートパラメータで適切に指定されている上で、ウィキデータにデータがある場合はその情報を表示、データがない場合はテンプレートパラメータauthorの情報を表示します。

ウィキデータのラベルは一般的に小文字のため、英単語の頭文字を大文字にする場合は、Module:String2の関数sentenceを利用して先頭の文字を大文字に変換することができます。

  • {{#invoke:String2 | sentence | {{#invoke:WikidataIB |getValue |P136 |name=genre |fetchwikidata=ALL |onlysourced=false}} }}動物農場 (Q1396889)
  • → モデル小説, satirical fiction, 寓話, ディストピアン・フィクション ウィキデータを編集

実装例: 基礎情報 書籍

[編集]

文学作品のInfobox(Template:基礎情報 書籍)の実装例です[注釈 2]

テンプレートは原題・画像・著者・国・出版日・ジャンル・公式サイトをフィールドに持ちます。基本的にウィキデータの値を扱いますが、原題のみは実値に依存します。各記事は{{Infobox Book}}を使ってInfoboxを表示します。ブラックリスト・ホワイトリストでウィキデータの値を表示するフィールドを指定します。ブラックリスト・ホワイトリストを指定しない場合は従来テンプレートと同様の表示をします。

テンプレート

[編集]

Template:基礎情報 書籍/WikidataIBに記載したInfoboxテンプレートの抜粋です。

ウィキデータから画像 (P18)著者 (P50)出版日 (P577)(P17)ジャンル (P136)公式ウェブサイト (P856)の値を取得し、ウィキデータにデータがない場合は各記事の実値を表示します。原題は常に実値を表示します。試験用途のために出典有無はすべてのフィールドで無視するよう|onlysourced=falseを指定しています。

{{Infobox
| tnavbar    = 基礎情報 書籍/WikidataIB
| above = {{{name|{{{title|{{PAGENAMEBASE}}}}}}}}
| image = {{#invoke:InfoboxImage|InfoboxImage|image={{#invoke:WikidataIB|getValue|P18|name=author|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|{{{image|}}}|noicon=true}}|size={{{image_size|}}}|sizedefault=frameless|alt={{{alt|}}}}}
| label1 = 作者
| data1 = {{#invoke:WikidataIB|getValue|P50|name=author|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|sep=、|{{{author|}}}}}
| label2 = 原題
| data2 = {{{title_orig|}}}
| label3 = 出版日
| data3 = {{#invoke:WikidataIB|getValue|P577|name=published|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|sep=、|{{{published|}}}}}
| label4 = 国
| data4 = {{#invoke:WikidataIB|getValue|P17|name=country|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|sep=、|{{{country|}}}}}
| label5 = ジャンル
| data5 = {{#invoke:WikidataIB|getValue|P136|name=genre|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|sep=、|{{{genre|}}}}}
| label6 = ウェブサイト
| data6 = {{#invoke:WikidataIB|getValue|P856|name=website|fetchwikidata={{{fetchwikidata|}}}|suppressfields={{{suppressfields|}}}|onlysourced=false|{{{website|}}}}}
}}<noinclude>{{Documentation}}</noinclude>

記事

[編集]

各記事に記載するInfoboxです。幸福な王子のパラメータを参考値にしています。

ウィキデータ利用なし

[編集]

Infoboxはウィキデータを意識することなく、実値のみを表示します。

{{基礎情報 書籍/WikidataIB
| suppressfields =
| fetchwikidata  =
| name           = 幸福な王子
| title_orig     = The Happy Prince
| image          = Happy prince.jpg
| image_size     = 400px
| author         = [[オスカー・ワイルド]]
| country        = [[アイルランド]]
| genre          = [[短編小説]]
}}

ブラックリスト・ホワイトリストは利用しない場合は省略できます。

{{基礎情報 書籍/WikidataIB
| name           = 幸福な王子
| title_orig     = The Happy Prince
| image          = Happy prince.jpg
| image_size     = 400px
| image_caption  = [[ウォルター・クレイン]]による挿絵
| author         = [[オスカー・ワイルド]]
| country        = [[アイルランド]]
| genre          = [[短編小説]]
}}

ウィキデータ利用

[編集]

画像・著者・国・出版日・ジャンル・公式サイトをウィキデータの値を表示します。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = image; author; country; published; genre; website
}}

|fetchwikidata=はALLを指定することで全てのフィールドを対象にすることができます。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = ALL
}}

ウィキデータに値がない、実値しか扱わないフィールドは実値を指定して表示します。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = ALL
| title_orig     = The Happy Prince
| country        = [[アイルランド]]
}}

ジャンルのみ非表示

[編集]

任意のフィールドを|suppressfields=でフィールド名を指定することで表示を抑制できます。

画像・著者・国・出版日・公式サイトをウィキデータの値を表示し、ジャンルを非表示にします。

{{基礎情報 書籍/WikidataIB
| suppressfields = genre
| fetchwikidata  = image; author; country; published; genre; website
}}
{{基礎情報 書籍/WikidataIB
| suppressfields = genre
| fetchwikidata  = ALL
}}

ホワイトリストにgenreを含めず、かつ、実値でヌル文字を指定してもジャンルは表示されません。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = image; author; country; published; website
| genre          =
}}

|suppressfields=を指定すると、記事に実値が記述されていてもジャンルを表示しません。

{{基礎情報 書籍/WikidataIB
| suppressfields = genre
| fetchwikidata  = image; author; country; published; genre; website
| genre          = [[短編小説]]
}}

実値で上書き

[編集]

実値で明記すれば、ウィキデータに値が格納されているかどうかに関わらず、実値の「小説」を表示します。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = image; author; country; published; genre; website
| genre          = [[小説]]
}}
{{基礎情報 書籍/WikidataIB
| fetchwikidata  = ALL
| genre          = [[小説]]
}}

ジャンルを取得しない

[編集]

ジャンルをウィキデータから取得せず、画像・著者・国・出版日・公式サイトのみ取得して表示します。

{{基礎情報 書籍/WikidataIB
| suppressfields = 
| fetchwikidata  = image; author; country; published; website
}}

ホワイトリストで指定しない場合、実値が指定されていれば表示します。

{{基礎情報 書籍/WikidataIB
| fetchwikidata  = image; author; country; published; website
| genre          = [[短編小説]]
}}

類似ツール

[編集]

モジュールはInfoboxテンプレートの中でのみ利用することを想定しており、他種のテンプレートや記事内で利用することは想定されていません。そのような場所でウィキデータのデータを用いる場合は他のツールを利用すべきです。

脚注

[編集]

注釈

[編集]
  1. ^ doc翻訳時点、実装ではより多くの関数が存在する可能性があります。
  2. ^ 実用性はなく、実際のテンプレートとの互換性はありません。

出典

[編集]