모듈:Wikidata/doc

Module

방법들

모듈 "Wikidata"에는 다음 메서드가 포함되어 있습니다.이 메서드에서는 첫 번째 파라미터로 속성 ID를 지정함으로써 호출 스크립트가 Wikidata에서 속성 값을 취득할 수 있습니다.

  • getValue: Wiki 링크된 값을 반환합니다(해당하는 경우).다른 모든 값은 다음과 같이 출력됩니다.{{#property:}}단, 우선 순위 값이 존재하는 경우는 이들 값만 반환됩니다.와는 달리formatStatementsw:ru부터:Wikidata,getValue는 아직 참조를 픽업하지 않습니다(w:en:모듈 토크:Wikidata/Archive 1#Wikidata에서 참조가 삭제되는 이유)
  • getRawValue: 연결되지 않은 속성 값과 천 구분 기호를 사용하여 숫자를 반환합니다.또한 속성의 일반 숫자 값(수량)도 반환합니다.다른 모든 값은 다음과 같이 출력됩니다.{{#property:}}(기본값이 존재하는 경우에도 정상값 포함)
  • getDateValue: 포맷된 날짜를 반환하는 특별한 방법입니다.기본 날짜 형식은 [day month year]입니다.옵션의 세 번째 파라미터는 [month day, year]의 경우 "mdy"를 추가할 수 있습니다.[month year]의 경우 "my"를 추가합니다.연도의 경우만 "y"를 추가합니다.날짜 BC에 접미사가 붙은 기본 "BCE"를 재정의하기 위해 네 번째 옵션 매개 변수를 추가할 수 있습니다.
  • getImages: 특정 속성의 모든 이미지(예: 이미지(P18), Gene Atlas 이미지(P692))파라미터는 propertyID value / FETCH_WIKIDATA / nil separator (default=space) size (default=220px)반환되는 텍스트는 [[File:]] 형식입니다.선택 가능한 크기와 구분자(html)를 가진 각 이미지에 대해 파일 이름 크기]를 지정합니다."Commons Media" 유형이 아닌 속성이 제공된 경우 빈 텍스트를 반환합니다.
  • getUnits이 작업은 속성을 사용합니다.첫 번째 매개 변수로 수량이며 현재 페이지에서 속성이 사용 중인 단위 이름을 반환합니다.속성이 수량 유형이 아니거나 값이 설정되지 않은 경우 빈 상태로 반환됩니다.두 번째 파라미터는 "FETCH_WIKIDATA"가 아닌 경우 Wikidata에서 가져오기를 재정의하기 위해 사용할 수 있습니다.
  • getUnitID이 작업은 속성을 사용합니다.첫 번째 파라미터로 수량이며 속성이 현재 페이지에서 사용하고 있는 유닛의 QID를 반환합니다.속성이 수량 유형이 아니거나 값이 설정되지 않은 경우 빈 상태로 반환됩니다.두 번째 파라미터는 "FETCH_WIKIDATA"가 아닌 경우 Wikidata에서 가져오기를 재정의하기 위해 사용할 수 있습니다.

Wikidata 한정자 값(있는 경우)은 다음 방법으로 검색할 수 있습니다.

  • getQualifierValue: 해당하는 경우 Wiki 링크된 값만 반환합니다.
  • getRawQualifierValue: 링크되지 않은 값을 반환합니다.
  • getQualifierDateValue: 포맷된 날짜를 반환합니다.

이 코드를 호출하는 문서에 대한 속성이 Wikidata에 정의되지 않은 경우 빈 문자열("")이 반환됩니다.

기타 방법:

  • pageId: 현재 페이지의 Wikidata ID(Q…)를 반환합니다. 페이지가 Wikidata에 연결되어 있지 않으면 아무것도 반환하지 않습니다.다른 페이지의 Wikidata ID를 가져오려면 {{#invoke:ResolveEntityId 페이지}}.
  • getTAValue: 속성 P1323에 대한 TA98(Termologia Anatomica first edition 1998) 값을 가져옵니다.매개 변수를 사용하지 않고 각 값이 외부 리소스에 링크된 목록으로 출력을 구성합니다.이것은 외부 링크를 반환할 필요가 있는 콜의 기입의 예시입니다.
  • ViewSomething: 라벨, 설명, 레퍼런스, 인터위키 링크 등 구조화된 데이터 내의 모든 것을 가져옵니다.「1」을 참조
  • getSiteLink: 인수 Wiki에서 지정된 페이지의 이름을 가져옵니다(영어 Wikipedia의 경우 "enwikiquote", 아랍어 Wikipedia의 경우 "arwiki" 등).
  • Dump:{{#invoke:Wikidata Dump claims}}는 구조화된 데이터를 감시합니다.ViewSomething과 동일한 인수를 사용합니다.결과를 보려면 미리 보기에서만 이 작업을 시도하십시오.이를 통해 데이터에 액세스하는 Lua 스크립트를 개발하는 데 많은 도움이 됩니다.인수 없이 사용하면 라벨, 설명, 참조 및 인터위키 링크를 포함한 모든 정보가 덤프됩니다.래퍼 템플릿이 있습니다. {{Dump}}을(를) 참조하십시오.
  • getImageLegend: 이미지 범례를 반환합니다(이미지는 속성 P18, 이미지 범례는 속성 P2096).
    로서 호출{{#invoke:Wikidata getImageLegend <PARAMETER> lang=<ISO-639code> id=<QID>}}
    항목 QID(비싼 호출)에서 "FETCH_WIKIDATA"와 동일한 경우를 제외하고 매개 변수를 반환합니다.QID가 생략되거나 공백인 경우 현재 문서가 사용됩니다(고가의 콜이 아님).lang을 생략하면 로컬 Wiki 언어가 사용되며, 그렇지 않으면 제공된 ISO-639 언어 코드가 사용됩니다.
    라벨은 '우선' 순위의 첫 번째 이미지에서 반환됩니다.이미지에 선호 순위가 없는 경우 '보통' 순위의 첫 번째 이미지에서 반환됩니다.
  • getValueShortName: getValue와 동일한 데이터를 반환하지만 속성 단축명을 라벨로 사용합니다(사용 가능한 경우).이를 통해 파이핑된 링크는 필요에 따라 더 짧은 라벨을 사용할 수 있습니다.항목에 단축 이름이 설정되지 않은 경우 일반 레이블이 사용됩니다.

임의 액세스

2015년 9월 16일부터 다른 기사의 QID를 사용하여 데이터를 가져올 수 있게 되었습니다.다음 콜:

  • {{#invoke:Wikidata getValueFromID <QID> <Property> FETCH_WIKIDATA}}

는 getValue와 동일하게 동작하지만 속성값을 취득하는 Wikidata 항목의 QID인 추가 파라미터를 사용합니다.예를 들어 다음과 같습니다.

  • {{#invoke:Wikidata getValueFromID {{Get QID Richard Burton (actor) }} P26 FETCH_WIKIDATA}}

는, 리다이렉트 페이지 타이틀의 리처드 버튼(배우)(Wikidata 라벨의 리처드 버튼(Q151973)에 대응)로부터, 영어 위키피디아내의 임의의 장소에서 「배우」(P26)의 링크치 리스트를 취득합니다.

즉, 테스트 환경이 사용자 공간에 설정될 수 있지만, 이러한 콜은 고액으로 분류되므로 가능한 한 사용을 삼가해 주십시오.

파라미터

  • Generalized Case(getValue)의 경우 이름 없는 파라미터 2개가 제공됩니다.첫 번째는 취득할 재산의 ID입니다(예: 출생지의 경우 P19, 배우자의 경우 P26).두 번째는 null, "FETCH_WIKIDATA" 또는 반환된 값이 되는 기타 문자열입니다.
  • 일반화된 링크되지 않은 케이스(getRawValue)의 경우 이름 없는 파라미터 2개가 제공됩니다.첫 번째는 검색할 자산의 ID이다(예: 성별의 경우 P21).두 번째는 null, "FETCH_WIKIDATA" 또는 반환된 값이 되는 기타 문자열입니다.
  • Generalized date case(getDateValue)의 경우 이름 없는 파라미터 3개가 제공됩니다.첫 번째는 취득할 자산의 ID입니다(생년월일의 경우 P569 등).두 번째는 null, "FETCH_WIKIDATA" 또는 반환된 값이 되는 기타 문자열입니다.세 번째는 dmy, mdy, my 또는 y 중 하나의 형식으로 날짜를 반환하는 형식입니다.

소문자 파라미터는 Wikibase 콜 p123에서 지원되지 않으므로 문제가 발생할 경우 P123과 같이 대문자가 사용되는지 확인하십시오.

사용.

예: 배우자(P26)

  • {{#invoke:Wikidata getValue P26 }}=는 아무것도 반환하지 않으므로 정보 상자에 배우자를 표시하지 않습니다.
  • {{#invoke:Wikidata getValue P26 FETCH_WIKIDATA}}=는 해당 기사에 대해 위키데이터에 저장된 속성 P26(1900)의 링크된 값을 반환합니다(예: 기사 Bill Clinton의 경우 Hillary Clinton을 반환합니다).
  • {{#invoke:Wikidata getValue P26 [[Hillary Rodham Clinton]]}}=는 정보 상자에서 Wikidata에 저장된 값이 아닌 로컬 값을 사용할 수 있도록 Hillary Rodham Clinton을 반환합니다.

정보 상자 템플릿의 예

infobox 정의 내에서는 다음과 같이 불릴 수 있습니다.

  • data55 = {{#invoke:Wikidata getValue P26 {{{spouse FETCH_WIKIDATA}}} }}

그 때문에, 인포 박스는 다음과 같이 됩니다.

  1. 정보 상자 매개 변수인 경우 배우자를 표시하지 않음 spouse공백으로 설정되어 있습니다(예:" spouse =")
  2. infobox 파라미터의 경우 Wikidata에서 링크된 값 표시 spouse제공되지 않음
  3. 로컬 정보 상자 매개 변수 표시 spouse(예:" spouse = Hillary Rodham Clinton")

옵션으로, 다음과 같이 호출할 수 있습니다.

  • data55 = {{#invoke:Wikidata getValue P26 {{{spouse }}} }}

그 때문에, 인포 박스는 다음과 같이 됩니다.

  1. 정보 상자 매개 변수인 경우 배우자를 표시하지 않음 spouse공백으로 설정되어 있습니다(예:" spouse ="}
  2. 정보 상자 매개 변수인 경우 배우자를 표시하지 않음 spouse제공되지 않음
  3. 로컬 정보 상자 매개 변수 표시 spouse(예:" spouse = Hillary Rodham Clinton")
  4. 정보 상자 매개 변수가 로컬로 FETH_WIKIDATA로 설정된 경우 Wikidata에서 링크된 값 표시

'모듈'위키데이터IB는 필드를 기사별로 블랙리스트에 올릴 수 있도록 수정하여 표시되지 않도록 합니다.또한 편집자는 로컬 매개 변수가 제공될 때 Wikidata에서 자동으로 가져올 필드를 문서 단위로 지정할 수 있습니다. 기본값은 none 이며, 문서에서 기능이 활성화될 때까지 문서를 변경하지 않고 Wikidata를 받아들이도록 정보 상자를 수정할 수 있습니다.

예: 출생지

이것은, 상기의 콜과 같은 방법으로 동작합니다.

  • {{#invoke:Wikidata getValue P19 }}=는 아무것도 반환하지 않으므로 정보 상자에 출생지를 표시하지 않습니다.
  • {{#invoke:Wikidata getValue P19 FETCH_WIKIDATA}}=는 해당 문서에 대해 위키데이터에 저장된 자산 P19(출생지)의 링크된 값을 반환합니다(예: 기사 Bill Clinton의 경우 아칸소주 Hope를 반환합니다).
  • {{#invoke:Wikidata getValue P19 [[Hope, Arkansas Hope]]}}=는 정보 상자에서 Wikidata에 저장된 값이 아닌 로컬 값을 사용할 수 있도록 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}}

출생 연도가 BCE이지만 BCE라고 읽어야 하는 경우 다음을 사용합니다.

  • -{{#invoke:Wikidata getDateValue P569 FETCH_WIKIDATA y BCE}}

예: Wikidata 항목에 링크

Q-ID 를 취득하려면 , 다음의 코드를 사용합니다.

  • -{{#invoke:Wikidata pageId}}

Wikidata에 링크할 때 일반적인 Wiki 마크업을 사용했습니다.

  • -[[d:{{#invoke:Wikidata pageId}} Name of Link]]

예: 다른 Wiki 페이지 링크

다른 Wiki에 링크하려면 이 코드를 사용합니다.이 예에서는 영어 Wikivoyage를 참조해 주세요.

  • -[[voy:{{#invoke:Wikidata getSiteLink enwikivoyage}} Name of Link]]


테스트

시험 배우자

다음 항목을 복사하여 문서에 붙여넣고 미리 봅니다(저장하지 마십시오). 

 * - {{##filename:Wikidata getValue P26 }} * - {{# 호출:Wikidata getValue P26 FETCH_WIKIDATA}* - {{# 호출:Wikidata get Value P26 [힐러리 로드햄 클린턴]}}

Bill Clinton에서는 다음을 얻을 수 있습니다.


Barack Obama에서는 다음을 얻을 수 있습니다.


Richard Burton에서는 다음을 얻을 수 있습니다.


프란츠 카프카에서는 다음을 얻을 수 있습니다.

출생지 테스트

다음 항목을 복사하여 문서에 붙여넣고 미리 봅니다(저장하지 마십시오). 

 * - {{##filename:Wikidata getValue P19 }} * - {{# 호출:Wikidata getValue P19 FETCH_WIKIDATA}* - {{# 호출:Wikidata getValue P19 [Newport]}}

William Ellery 를 사용해, Wikidata 콜이 올바르게 불명확하게 되어 있는 것을 확인합니다.

getValue, getRawValue 및 getDateValue 테스트 중

다음 항목을 복사하여 문서에 붙여넣고 미리 봅니다(저장하지 마십시오). 

* - {{##filename:Wikidata getValue P19 FETCH_WIKIDATA}* - {{# 호출:Wikidata getValue P26 FETCH_WIKIDATA}* - {{# 호출:Wikidata getValue P27 FETCH_WIKIDATA}* - {{# 호출:Wikidata getValue P140 FETCH_WIKIDATA}* - {{# 호출:Wikidata getRawValue P21 FETCH_WIKIDATA}* - {{# 호출:Wikidata getDateValue P569 FETCH_WIKIDATA dmy}* - {{# 호출:Wikidata getDateValue P569 FETCH_WIKIDATA mdy}* - {{# 호출:Wikidata getDateValue P569 FETCH_WIKIDATA y}

이것은 출생지, 배우자, 시민권, 종교, 성별, 생년월일(2회) 및 생년월일(존재하는 경우)에 대한 위키데이터 값을 반환해야 한다.DOB는 처음에 dmy 형식이고, 다음으로 mdy 형식입니다.

테스트일 BCE/BCE

Horace #도 참조해 주세요(저장하지 말아 주세요)와 같은 기사의 짧은 섹션에 다음 항목을 복사하여 붙여넣습니다. 

* - {{##filename:Wikidata getDateValue P569 FETCH_WIKIDATA y}* - {{# 호출:Wikidata getDateValue P569 FETCH_WIKIDATA y BCE}

이것은 각각 기원전 65년과 기원전 65년을 반환할 것이다.

「 」를 참조해 주세요.