Módulo:Wikidata/doc

Esta é uma subpágina de documentação para o Módulo:Wikidata.
Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte do módulo original.

Métodos

Este módulo "Wikidata" tem os seguintes métodos, que permitem chamar um script para devolver um valor para qualquer propriedade do Wikidata ao fornecer o ID da propriedade como o primeiro parâmetro:

getValue: Devolve valore com links wiki, se for aplicável. Todos os outros valores vão ser mostrados similarmente a {{#propriedade:}}, excepto se existirem valores com rank preferido, depois só eles são mostrados. Ao invés de formatStatements de ru:Модуль:Wikidata, getValue ainda não consegue recolher qualquer referências (ver en:Module talk:Wikidata#Why the references from Wikidata get dropped?).
getRawValue: Devolve valores de propriedade não ligados e números como separador de milhares. Também devolve valores numéricos básicos da propriedade o qual é quantidade. Todos os outros valores vão ser mostrados similarmente a {{#propriedade:}}, incluindo valores normais, mesmo se valores preferidos existirem.
getDateValue: Método especial para devolver datas formatadas. O formato padrão da data é [dia mês ano]; um terceiro parâmetro opcional pode ser adicionado para outros formatos de data: para [mês dia, ano], adiciona "mdy"; para [mês ano], adiciona "my"; para só o ano, adicione "y". Um outro parâmetro opcional, que é o quarto, como "a. C.", pode ser adicionado para sobrepor o valor por padrão "a.C" que é sufixo para data a.C..
getImages: Devolve todas as imagens de uma propriedade particular, e.g. imagem (P18), Gene Atlas Image (P692), etc. Parâmetros são | propertyID | value / FETCH_WIKIDATA / nil | separator (default=space) | size (default=220px). O texto devolvido vai estar no formato [[Ficheiro:Ficheiro | tamanho]] para cada imagem com tamanho seleccionável e separador (que pode eventualmente ser html). Se a propriedade fornecida não for do tipo "commonsMedia", ele vai devolver uma cadeia de texto vazio.
getUnits Isto toma a propertyID que é a quantidade como o primeiro parâmetro, e devolve o nome de unidades que a propriedade está a usar na página atual. Ele devolve uma cadeia vazia se a propriedade não for do tipo quantidade ou se o valor não for definido. O segundo parâmetro pode ser usado para sobrepor devolver dados do Wikidata, se for outra coisa diferente de "FETCH_WIKIDATA".
getUnitID Is toma a propertyID que é uma quantidade como o primeiro parâmetro, e devolve o QID das unidades que a propriedade está a usar na página atual. Ele devolve uma cadeia vazia se a propriedade não for do tipo quantidade ou o valor não está definido. O segundo parâmetro pode ser usados para sobrepor buscar dados do Wikidata, se for outra coisa diferente de "FETCH_WIKIDATA".

Valores qualificadores Wikidata (se estiver presentes) podem ser devolvidos seguindo os seguinte métodos:

getQualifierValue: devolve apenas os valores com wiki-link, se for aplicável.
getRawQualifierValue: devolve valores que não tem link
getQualifierDateValue: devolve datas formatadas

Se a propriedade não está definida na Wikidata para o artigo que invoca esta código, depois uma cadeia de texto vazia ("") é devolvida.

Outros métodos:

pageId: devolve o id (Q…) do Wikidata da página atual ou nada se a página não estiver ligada ao Wikidata
getTAValue: devolve os valores TA98 (Terminologia Anatomica first edition 1998) para a propriedade P1323. Ele não aceita parâmetros e constrói a sua saída como uma lista, com cada valor ligado a um recurso externo. Isto é um exemplar para escrever chamadas que precisam de devolver ligações externas.
ViewSomething: devolve qualquer coisa nos dados estruturados, incluindo etiquetas, descrições, referências e links interwiki. Ver [1]
getSiteLink: devolve o nome da página em um argumento wiki dado (como a ptwikiquote para a Wikiquote em Português).
Dump: espia os dados estruturados. Ele usa os mesmos argumentos que ViewSomething. Experimente apenas previsualizar para ver os resultados. Isso ajuda imenso a desenvolver scripts Lua que acedam aos dados. Se ele for usado sem argumentos, ele descarrega tudo incluindo as etiquetas, descrições, referências e links interwiki. Ver [2]
getImageLegend: devolve uma legenda da imagem (imagem é a propriedade P18; a legenda da imagem é a propriedade P2096).
Faz a chamada como {{#invoke:Wikidata |getImageLegend | <PARAMETER> | lang=<ISO-639code> |id=<QID>}}

Devolve PARÂMETRO, a menos que seja igual a "FETCH_WIKIDATA", de Item QID (chamada cara). Se o QID for omitido ou vazio, o artigo corrente é usado (não é uma chamada cara). Se lang for omitido, ele usa a língua local, de outra modo ele usa o código de língua ISO-639.

A etiqueta é devolvida da primeira imagem com rank 'preferido'; ou da primeira imagem com rank 'normal' se nenhuma imagem tem rank preferido.
getValueShortName: devolve os mesmo dados que getValue, mas utiliza a propriedade nome curto como a etiqueta, se estiver disponível. Se preferir isto permite que se faça links com pipes para usar etiquetas curtas. Se o nome não for definido para este item, a etiqueta normal é usada.

Acesso arbitrário

Desde 16 de Setembro de 2015, é agora possível buscar dados de outros artigos usando o seu QID. A seguinte chamada:

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

vai fazer o mesmo que getValue, mas aceita um parâmetro extra, o qual é o QID do item Wikidata que você quer obter o valor de propriedade de. Por exemplo:

{{#invoke:Wikidata|getValueFromID|Q151973|P26|FETCH_WIKIDATA}}

vai devolver uma lista de valores com link para  'esposo' (P26) de 'Richard Burton' (Q151973) de qualquer lado da Wikipédia Portuguesa.
Isso quer dizer que ambientes de testes pode ser configurados no espaço de usuário, mas lembre-se que essas chamadas são classificadas como caras, por isso por favor use-as o menos possível.

Parâmetro


    
editar

Para casos generalizados (getValue), dois parâmetros sem nome são fornecidos. O primeiro é o ID da propriedade que é devolvida (e.g. P19 para data de nascimento ou P26 para esposo). O segundo pode ser null, "FETCH_WIKIDATA", ou qualquer outra cadeia de texto, o qual se transforma no valor devolvido.
Para casos generalizados sem link (getRawValue), dois parâmetros sem nome são fornecidos. O primeiro é o ID da propriedade que é devolvida (e.g. P21 para género). O segundo pode ser null, "FETCH_WIKIDATA", ou qualquer outra cadeia de texto, o qual se transforma no valor devolvido.
Para o caso generalizado (getDateValue), três parâmetro são fornecidos. O primeiro é o ID da propriedade que é devolvida (e.g. P569 para data de nascimento). O segundo pode se null, "FETCH_WIKIDATA", ou qualquer outra cadeia de texto, o qual se transforma no valor devolvido. O terceiro é o formato da data que deve ser devolvido em, ou dmy, mdy, my, ou y.

Por favor note que os parâmetros em minúsculas já não são suportados nas chamadas do wikibase: p123, por isso verifique que usa maiúsculas, como P123, é usado se ocorrerem problemas.

Uso


    
editar

Exemplo: esposo (P26)


    
editar

{{#invoke:Wikidata|getValue|P26|}} = devolve nada, por isso suprime a visualização de esposo dentro de uma infocaixa.
{{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}} = devolve os valore(s) ligados à propriedade P26 (esposo) guardado na wikidata para o artigo correspondente (e.g. para artigo Bill Clinton, ele devolve Hillary Clinton)
{{#invoke:Wikidata|getValue|P26|[[Hillary Rodham Clinton]]}} = devolve Hillary Rodham Clinton, permitindo que uma infocaixa use um valor local em vez do valor guardado no Wikidata.

Exemplo na predefinição Infocaixa


    
editar

Dentro de uma definição infocaixa, ele pode ser chamado assim:

| data55 = {{#invoke:Wikidata|getValue|P26|{{{esposo|FETCH_WIKIDATA}}} }}

que causa a infocaixa a:

não mostrar esposo se o parâmetro da infocaixa |esposo está definido em branco (como "| esposo ="}
mostra o valor ligado(s) da Wikidata se o parâmetro infocaixa |esposo não for fornecido
mostra o parâmetro local da infocaixa |esposo se ele for especificado (e.g. "|esposo = Hillary Rodham Clinton")

Opcionalmente, ele podia ser chamado como:

| data55 = {{#invoke:Wikidata|getValue|P26|{{{esposo|}}} }}

o qual causa a infocaixa a:

não mostrar esposo se o parâmetro |esposo está definido em branco (como "| esposo ="}
não mostrar esposo se o parâmetro da infocaixa |esposo não está fornecido
mostra o parâmetro local da infocaixa |esposo se ele for fornecido (e.g. "|esposo = Hillary Rodham Clinton")
mostra os valores com ligação da Wikidata se o parâmetro da infocaixa é definido localmente para FETCH_WIKIDATA

Ver Módulo:WikidataIB para uma modificação que permite campos, numa base por artigo, ser definido como blacklist, para que nunca seja visualizado. Ele permite ao editor definir, numa base por artigo, quais campos podem ser automaticamente obtidos da Wikidata quando os parâmetros locais são fornecidos; o padrão é nenhum, permitindo que uma infocaixa possa ser modificada para aceitar a Wikidata sem qualquer alteração nos artigos que usam a infocaixa até a funcionalidade ser ligada no artigo.

Exemplo:data de nascimento


    
editar

Isto trabalha da mesma maneira que a chamada acima:

{{#invoke:Wikidata|getValue|P19|}} = devolve nada, por isso suprime a visualização de data de nascimento na infocaixa
{{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}} = devolver os valores de ligação da propriedade P19 (local de nascimento) guardado no wikidata para os artigos correspondentes (e.g. para artigo Bill Clinton, ele devolve Hope (Arkansas))
{{#invoke:Wikidata|getValue|P19|[[Hope (Arkansas)|Hope]]}} = devolve Hope, permitindo que a infocaixa use o valor local em vez do valor guardado no Wikidata.

Exemplo:género


    
editar

Nós não queremos o valor devolvido com ligação, assim usamos:

- {{#invoke:Wikidata|getRawValue|P21|FETCH_WIKIDATA}}

Exemplo:data de nascimento


    
editar

Nós queremos a data de nascimento em formato dmy, nós usamos:

- {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|dmy}}

Se nós quisermos a data de nascimento em formato mdy, nós usamos:

- {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|mdy}}

Se nós desejamos o ano de nascimento, nós usamos:

- {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}

Se nós desejamos o ano de nascimento que pode ser a.C., mas deve-se ler "a. C.", nós usamos:

- {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y|a. C.}}

Exemplo: Ligação para item do Wikidata


    
editar

Use o seguinte código para simplesmente obter o Q-ID:

- {{#invoke:Wikidata|pageId}}

Ligando ao Wikidata usando o markup usual Wiki:

- [[d:{{#invoke:Wikidata|pageId}}|Nome do Link]]

Exemplo: Ligando a outra página wiki


    
editar

Use código como este para fazer um link a outra wiki. A Wikivoyage em Português é o exemplo:

- [[voy:{{#invoke:Wikidata|getSiteLink|ptwikivoyage}}|Nome do Link]]

Testes


    
editar

Testar esposa


    
editar

Copia e cola o seguinte para qualquer artigo e faz a previsualização (por favor não o salve!):

* - {{#invoke:Wikidata|getValue|P26|}}
* - {{#invoke:Wikidata|getValue|P26|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P26|[[Hillary Rodham Clinton]]}}

Em Bill Clinton você deve conseguir:

-
- Hillary Clinton
- Hillary Rodham Clinton

em Barack Obama deve conseguir:

-
- Michelle Obama
- Hillary Rodham Clinton

em Richard Burton deve conseguir:

-
- Elizabeth Taylor, Sally Burton, Sybil Christopher, Suzy Miller, Elizabeth Taylor
- Hillary Rodham Clinton

Em Franz Kafka deve conseguir:

-
-
- Hillary Rodham Clinton

Testar local de nascimento


    
editar

Copia e cola o seguinte para qualquer artigo e faz a previsualização (por favor não o salve!):

* - {{#invoke:Wikidata|getValue|P19|}}
* - {{#invoke:Wikidata|getValue|P19|FETCH_WIKIDATA}}
* - {{#invoke:Wikidata|getValue|P19|[[Newport]]}}

Tenta William Ellery e verifica que a chamada Wikidata faz a desambiguação.

Testando getValue, getRawValue e getDateValue


    
editar

Copia e cola o seguinte para qualquer artigo e faz a previsualização (por favor não o salve!):

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

Isto deve devolver valores do Wikidata para local nascimento, esposo, nacionalidade, religião, genêro, data de nascimento (duas vezes) e ano de nascimento, se eles existirem. A dn é primeiro em formato dmy e depois em mdy.

Testando datas a.C/a. C.


    
editar

Copia e cola o seguinte para qualquer artigo e faz a previsualização (por favor não o salve!):

* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y}}
* - {{#invoke:Wikidata|getDateValue|P569|FETCH_WIKIDATA|y|a. C.}}

Isto deve devolver 65 a.C e 65 a. C., respectivamente.
Outra documentação:

Wikipédia:Lua
en:Module talk:Wikidata