Módulo:WikidataIB/doc

Este módulo foi projetado especificamente para implementar um mecanismo que move o controle de se os valores do Wikidata são usados em uma infobox do programador da predefinição no nível de design da infobox para o editor no nível de artigo. Ele só deve ser usado dentro de uma infobox, ou de dentro de uma predefinição.

Uso

O módulo provê essas chamadas especificamente para o uso em infoboxes no presente:

1. getValue
2. getPreferredValue chamada principal, usada para obter o valor(es) de uma dada propriedade
3. getQualifierValue - dado: (1) uma propriedade; (2) seu valor; (3) o IDpropriedade do qualificador, retorna valores que igualam
4. getValueByQual obtém o valor de uma propriedade que tem um qualificador com um dado valor de entidade
5. getValueByLang obtém o valor de uma propriedade que tem um qualificador P407 ("linguagem de trabalho ou nome") cujo valor tem o código de linguagem dado
6. getValueByRefSource obtém o valor de uma propriedade que tem uma referência "indicada em" (P248) cujo valor tem o ID-entidade indicado
7. getPropOfProp se o(S) Valor (s) do prop1 são do tipo "wikibase-item" então ele retorna o(S) Valor (s) do prp2 de cada um desses itens wikibase
8. getAwardCat se o item tem valores de P166 (prêmio recebido), em seguida, ele examina cada um dos prêmios para P2517 (categoria de destinatários do prêmio) e retorna a categoria correspondente, com o item P734 (nome de família) como chave de ordenação, ou nenhum tipo de chave se não existir nenhum nome de família
9. getIntersectCat para cada valor do prop1 ele obtém a categoria principal do valor e então cada valor do prop2, então ele retorna todas as categorias que representam a interseção dessas propriedades
10. getSumOfParts verifica a propriedade 'tem parte' (P527) para valores correspondentes a uma lista, se os valores correspondentes tiverem um qualificador 'quantidade' (P1114), essas quantidades são somadas e devolvidas (mas o zero devolve zero)
11. getCoords - obtém as coordenadas e passa-as através do modelo:Coord

A chamada obsoleta getSourcedValue foi removida, pois agora é redundante para getValue que pode fazer o mesmo trabalho usando o parâmetro |onlysourced=true (que está definido por padrão). A chamada obsoleta getPreferredValue ainda é mantida, mas deve substituída por getValue|rank=best.

Existem também essas chamadas úteis:

1. getLink se houver um link do site para um artigo no Wiki local, ele retorna um link para o artigo com a etiqueta Wikidata como o texto apresentado. Se não houver nenhum link do site, ele retorna o rótulo como texto simples. Se não houver nenhuma etiqueta na língua local, devolve o ID da entidade
2. getAT (Article Title) Se houver um link do site para um artigo no Wiki local, ele retorna o link do site como texto simples, caso contrário nada
3. getSiteLink obtém o link de texto simples para um artigo num determinado wiki
4. getLabel devolve a etiqueta Wikidata para a língua local como texto simples. Se não houver nenhuma etiqueta na língua local, devolve o ID da entidade
5. getAllLabels obtém o conjunto de legendas e formata-o para mostrar como wikitext
6. labelorid devolve a legenda com toda o wikitexto removido, ou o ID da entidade se não houver legenda
7. getDescription devolve a descrição do artigo para a entidade Wikidata se o parâmetro local for "Wikidata".
8. getAllDescriptions obtém o conjunto de descrições e formata-o para mostrar como wikitext
9. getAliases devolve os pseudónimos da entidade na língua actual ou dada
10. getAllAliases obtém o conjunto de nomes alternativos e formata-o para mostrar como wikitext
11. pageId devolve o id da página Wikidata ligada (ID de entidade, número Q) da página actual
12. formatDate leva uma datetime do formato usual de mw.wikibase.entidade: formatpropertytyvalues e formata-o de acordo com os parâmetros df (formato de data) e a.C.
13. formatNumber formata um número de acordo com o código da língua fornecida
14. checkBlacklist devolve true se o campo "não" estiver na lista negra (isto é, permitido))
15. emptyor devolve zero se o parâmetro for apenas pontuação, espaços em branco ou marcas de html, caso contrário devolve o argumento inalterado
16. getLang devolve o código da língua MediaWiki ou o nome completo da língua do conteúdo actual
17. getItemLangCode procura por país (P17), depois pela língua oficial desse país (P37), e devolve o código da língua (P424)
18. findLanguage devolve (1) a língua indicada se for válida; ou (2) a língua definida do utilizador; ou (3) a língua do wiki actual
19. getQid devolve (1) o ID da entidade, se for fornecido; ou (2) O ID da entidade do "tópico principal da categoria (P 301)"; ou (3) O ID da entidade associado à página actual; ou (4) nada
20. followQid dada uma lista de propriedades, procura por cada propriedade por sua vez e devolve o ID da entidade do primeiro valor correspondente (opcionalmente, devolve todos os IDs da entidade que correspondem)
21. getGlobe devolve o ID de entidade do globo usado em P625 (localização das coordenadas), ou zero se não existir um
22. getCommonsLink retorna um dos seguintes, por ordem de preferência: o link do site Commons do item linked Wikidata; o sitelink Commons da principal categoria do tópico linked Wikidata item;
23. siteID retorna a raiz do globalSiteID, por exemplo "en" para "enwiki", "enwikisource", "en-gb", etc.
24. projID mesmo que siteID
25. location pesquisa a partir da localização atual para cima ao longo da cadeia de locais de nível superior, retornando cada um até chegar a um país
26. examine devolve um dump formatado da propriedade dada
27. url2 toma um parâmetro que é um url apropriado e o formata para uso em um infobox; Aceita a sua própria saída como entrada
28. getWebsite obtém o sítio Web Oficial (P856) e formata-o para utilização numa caixa de infocomment
29. checkvalue procura através de uma propriedade para um dado ID de entidade como o seu valor e devolve esse ID de entidade, se for encontrado; caso contrário, nada
30. checkValidity devolve se o primeiro parâmetro sem nome representa um ID de entidade válido
31. showNoLinks mostra os títulos dos artigos que não devem ser ligados

Exemplo de chamadas:

{{#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> |qual=<ALL/DATES/P999> |list=<ubl/hlist/prose> |linked=<yes/no> |<local parameter>}}

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

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

{{#invoke:WikidataIB |getValueByQual |<PropertyID> |qualID=<qualifier property ID to match> |qvalue=<QID of target value for the qualifier property> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}

{{#invoke:WikidataIB |getValueByLang |<PropertyID> |lang=<language code to match> |name=<fieldname> |suppressfields=<list of fields which will never display> |fetchwikidata=<list of fields to fetch values from Wikidata> |onlysourced=<yes/no>}}

Parameters to getValue

Nome	Alias	Função	Padrão
(primeiro sem nome)	1	O ID da propriedade cujos valores são devolvidos. Necessário.
(segundo sem nome)	2	Um valor fornecido localmente que, se não estiver vazio, será devolvido em preferência ao valor no Wikidata.	vazio
qid		O número Q (ID da entidade) da entidade a que a propriedade pertence. Se não for fornecido ou vazio, é por omissão o item associado Wikidata da página actual-usamw.wikibase.getEntityIdForCurrentPage().	Id do item para a página atual
eid		Uma alternativa para qid. Excepto para eid, todos os parâmetros para o getValue tratam o zero e o texto vazio o mesmo. Então, ajuste |x= dá o mesmo resultado que omitir o parâmetro. No entanto, para fornecer alguma compatibilidade com outros módulos, utilizando  Nota: Para eid, veja [[]]. devolve sempre um texto vazio, omitindo eid permite qid funcione normalmente.	Id do item para a página atual
rank		[Insensível à capitalização] quando definido como best, devolve os valores preferidos se estiverem presentes, caso contrário devolve os valores normais. Quando definido como best devolve os valores preferidos. Quando configurado para normal, devolve os valores normais. Quando configurado para deprecated devolve valores desactualizados. Qualquer valor de parâmetro começando com "b" é "best"; começando com "p" é "prefered"; começando com "n" é "normal"; começando com "d" é obsoleto. Vários valores são permitidos: "p n d" retornaria todas as fileiras. O "best" sobrepõe-se às outras bandeiras. Outros valores são ignorados e se não for solicitada nenhuma classificação, preferidos e normais são devolvidos.	preferred e normal
qual		A lista separada de pontuação de IDs de propriedades de qualificadores que tem que ser devolvidos em parênteses depois da propriedade. Configuracao qual=ALL devolve todos os qualificadores. Configuração qual=DATES devolve data inicial (P580) e data final (P582) com separador de data.	none
qualsonly	qo	Um booleano que permite a exibição de apenas o(s) qualificador (es), sem o valor da propriedade ou parênteses. Valores no, false e 0 são todos falsos; qualquer outra é true.	false
qualsonly	qo	Um booleano que permite a exibição de apenas o(s) qualificador (es), sem o valor da propriedade ou parênteses. Valores no, false e 0 são todos falsos; qualquer outra é true.	false
fetchwikidata	fwd	Lista de campos para buscar valores de. ALL buscas todos os campos. Um valor de NONE ou vazio ou omitir o parâmetro não busca campos.	none
suppressfields	spf	Lista de campos que nunca irão aparecer. Isso mesmo forçará um valor local no campo a não exibir.	none
name		Nome do campo. Quando informa a info caixa, este é o nome que fetchwikidata e suppressfields vai reconhecer. Requirido se fetchwikidata ou suppressfields é específicado (excepto quando fetchwikidata=ALL).	nil
onlysourced	osd	Um booleano que irá filtrar os valores do Wikidata que não são obtidos ou que só são obtidos na Wikipédia. Valores no, false e 0 são todos false; qualquer outro é true.	true
df		Formato de data: pode ser dma (dia antes de mês) ou mda (mês antes de dia) ou a (apenas ano).	dmy
qdf		Qualificadores de formato de data. Se omitido, revere para parâmetro padrão df, ou "y" ou "a" se df também é omitido.	valor de df ou "y" ou "a"
bc		Formato de sufixos a.C. ou d.C. (BC/BCE) para datas.	BCE
plaindate	pd	Texto para modificar a formatação das datas. A configuração "true"/"yes"/"1" desactiva a adição de "circunstâncias de fontes" (P 1480) e quaisquer ligações. Definir "adj" faz o mesmo, mas usa a forma adjetiva da data.	false
linked		Um booleano que permite o link para uma página local através de seu link do site no Wikidata. Valores no, false e 0 são todos false; qualquer outro é true.	true
displaytext	dt	Um texto que se sobrepõe ao texto apresentado de um item ligado, se não estiver vazio.	empty
shortname	sn	Um booleano que permite o uso de Nome curto (p 1813) em vez de etiqueta para um item ligado. Valores no, false e 0 são todos false; quaquer outro é true.	false
uselabel	uselbl	Um booleano que força a exibição do rótulo em vez do link do site desambiguado para um item ligado. As etiquetas são muito mais propensas ao vandalismo que os links do site. Valores no, false e 0 são todos false; qualquer outro é true.	false
wdlinks	wdl	Um booleano que permite a exibição de links para Wikidata quando nenhum artigo local existe. Valores no, false e 0 são todos false; qualquer outro é true.	false
unitabbr	uabbr	Um booleano que permite a exibição de abreviações de unidade para unidades comuns. Valores no, false e 0 são todos false; qualquer outro é true.	false
convert	conv	Um booleano que permite a passagem de quantidades para Predefinição:Cvt. Valores no, false e 0são todos false; qualquer outro é true.	false
showunits	su	Um booleano que permite a exibição de unidades para quantidades. Valores no, false e 0são todos false; qualquer outro é true.	true
scale		Uma cadeia de texto que configura a escala de formato das quantidades. Valores são: "a"=automático; "0"=sem escala; "3"=milhar; "6"=milhão; "9"=bilhãi; "12"=trilhão.	0

• getValue pode também pegar um parâmetro |qid= que é o ID do Wikidata para o artigo. Isto não será normalmente usado, mas está disponível para teste, embora faça a chamada cara.
• A propriedade a ser retornada é passada na primeira propriedade não nomeada.
• O nome do campo que a função é chamada é passada no parâmetro |name=, que é primeiramente checado em uma blacklist de campos que não devem ser mostradas nunca, (i.e. a chamada retorna nil em todas as circunstâncias). Se o campo não está na blacklist, é então checado contra uma whitelist. Se o nome do campo concorda, a chamada retornará qualquer valor fornecido localmente se é fornecido como segundo parâmetro não nomeado, ou o valor do Wikidata caso contrário.
• O nome é compulsório quando a blacklist ou a whitelist é usada, então o módulo retorna nil se não é fornecido.
• A blacklist é passada no parâmetro |suppressfields=
• A whitelist é passada no parâmetro |fetchwikidata=

A função getValue aceitará um parâmetro booleano |onlysourced= que irá suprimir retornos dos valores do Wikidata que estão sem fontes ou somente referenciados a Wikipédia. A ausência do parâmetro, um parâmetro |onlysourced vazio e uma string vazia ("") têm como default para verdadeiro (i.e. somente os valores referenciados são retornados). Os valores no, false e 0 são tratados como falsos (i.e. todos os valores são retornados); qualquer outro valor é verdadeiro (embora |onlysourced=yes seja recomendado para legibilidade).

A função getValue aceitará um parâmetro booleano noicon que suprimirá o ícone "edite no Wikidata" para quando o valor retornado for processado futuramente pela infobox (e.g. uma url). A ausência do parâmetro ou um parâmetro |noicon vazio default para falso (i.e. o parâmetro é adicionado). A string vazia ("") e os valores no, false e 0 são tratados como falsos; qualquer outro valor é verdadeiro (embora |noicon=true seja recomendado para legibilidade).

Em ordem de lidar com o requerimento para datas em my, dmy ou y, getValue aceita um parâmetro |df= que pode pegar valores "dmy", "my" ou "y" - default é "dmy".

Se um artigo exigir o sufixo a.C., getValue retornará a data com esse sufixo;

Em uma invocação do módulo para extrair datas, getValue aceita um parâmetro |idioma= que pode receber o valor "pt" para formatar a data de acordo com o português europeu (única diferença se dá nas datas envolvendo o primeiro dia do mês. Por exemplo: 1º de maio de 2017 (em português brasileiro) e 1 de maio de 2017 (em português europeu)).

• A propriedade a ser retornada é passada na primeira propriedade não nomeada.

A função getValue aceitará um especificador de uso de unidade de medida (ao invés da unidade por extenso) na terceira propriedade não nomeada. A unidade de medida será exibida somente se o valor passado for unidade

Função getPreferredValue

A função getPreferredValue trabalha exatamente como getValue, tomando os mesmos parâmetros, mas se qualquer um dos valores para a propriedade tem um rank set preferido, ela retornará esses valores.

Exemplo

Obtendo o(s) nome(s) da criador (P170) de Corisca e Sátiro (Q29016906):

• {{#invoke:WikidataIB |getValue |P170 |fetchwikidata=ALL |qid=Q29016906 |onlysourced=no}} → Artemisia Gentileschi, Diana Rosa, Massimo Stanzione 
• {{#invoke:WikidataIB |getPreferredValue |P170 |fetchwikidata=ALL |qid=Q29016906 |onlysourced=no}} → Artemisia Gentileschi 

Função getSourcedValue

• getSourcedValue trabalha exatamente como getValue, mas somente retorna valores que tenham referência a algo mais do que a Wikipedia. Não há garantias de fontes confiáveis, mas ajuda separar o joio do trigo.

Exemplo de getSourcedValue

De Richard Burton (Q151973):

Burton correntemente tem quatro valores para ocupação (P106) no Wikidata:

• ator de cinema (Q10800557) (referenciado a Dutch Wikipedia);
• ator (Q33999) (referenciado a http://www.nytimes.com/1983/05/09/theater/theater-private-lives-burton-and-miss-taylor.html);
• diarista (Q18939491) (referenciado a Wikipédia);
• ator de teatro (Q2259451) (não referenciado).

Usando getValue em Richard Burton:

• {{#invoke:WikidataIB |getValue |P106 |name=occupation |fetchwikidata=ALL}} -> ator de cinema, diarista, ator de teatro, ator, diretor de cinema 

Usando getSourcedValue em Richard Burton:

• {{#invoke:WikidataIB |getSourcedValue |P106 |name=occupation |fetchwikidata=ALL}} ->

Função getCoords

• getCoords pode também pegar um parâmetro |qid= que é o ID do Wikidata para o artigo. Isto não será normalmente usado, mas está disponível para testes, embora faça a chamada cara.
• As coordenadas do Wikidata são passadas a Predefinição:Coord que retorna o display como se fosse chamado manualmente.
• O nome do campo que a função é chamada é passada no parâmetro |name, que é primeiramente checado em uma blacklist de campos que não devem ser mostradas nunca, (i.e. a chamada retorna nil em todas as circunstâncias). Se o campo não está na blacklist, é então checado contra uma whitelist. Se o nome do campo concorda, a chamada retornará qualquer valor fornecido localmente se é fornecido como segundo parâmetro não nomeado, ou o valor do Wikidata caso contrário.
• O nome é compulsório quando a blacklist ou a whitelist é usada, então o módulo retorna nil se não é fornecido.
• A blacklist é passada no parâmetro |suppressfields=
• A whitelist é passada no parâmetro |fetchwikidata=

Função getQualifierValue

O getQualifierValue é para usar quando queremos concordar o valor de um qualificador. Nós precisamos saber a propriedade e o valor da propriedade que a qualifica. Os parâmetros são:

• A propriedade ID passada no parâmetro não nomeado (ou |1)
• O valor alvo para esta propriedade em |pval
• O ID qualificador para o valor alvo em |qual
• O nome do campo onde é chamada para implementar "whitelisting" e "blacklisting" da propriedade nele
• A lista de campos para concordância ("whitelist") em |fetchwikidata= - aceita |fetchwikidata=ALL para concordar todos os campos
• Lista opcional de campos para não serem exibidos ("blacklist") em |suppressfields=
• booleano opcional para especificar se apenas valores referenciados da propriedade são retornados (default para "no") em |onlysourced=
• Item ID opcional para acesso arbitrário (chamada carísssima!) em |qid=

Exemplo de getQualifierValue

Em Telescópio do Polo Sul (Q1513315) existe uma propriedade evento notável (P793), que tem um valor construção civil (Q385378). Tem dois qualificadores, data inicial (P580) e data final (P582). Para obter a data de início:

• {{#invoke:WikidataIB |getQualifierValue |P793 |pval=Q385378 |qual=P580 |name=xyz |fetchwikidata=ALL }}

Em Telescópio do Polo Sul retorna:

• novembro de 2006 

Função getLink

getLink retorna o rótulo para um Qid ligado a wiki para o artigo local (se o artigo existe).

Função getLabel

getLabel retorna o rótulo para uma Qid. Se o rótulo não existe, retorna o Qid. Note que este é o rótulo dado para a entrada no Wikidata na mesma linguagem da corrende Wikipédia, se o rótulo existe.

• {{#invoke:WikidataIB |getLabel |Q29016906}} → Corisca e Sátiro
• {{#invoke:WikidataIB |getLabel |Q3621491}} → arqueólogo

Função getAT

getAT retorna o título do artigo para uma Qid. Se o título do artigo não existe, não retorna nada. Note que este é o título do artigo na corrente Wikipedia, se o interwiki existe na entrada Wikidata.

• {{#invoke:WikidataIB |getAT |Q29016906}} →
• {{#invoke:WikidataIB |getAT |Q3621491}} →

Função formatDate*

formatDate aceita uma data no formato usual de mw.wikibase.entity:formatPropertyValues, como "1 de agosto de 30 a.C." como parâmetro 1 e o formata de acordo com os parâmetros df e bc.

• {{#invoke:WikidataIB |formatDate | 1 de agosto de 30 | bc=BC |df=dmy}} → 1 de agosto de 30
• {{#invoke:WikidataIB |formatDate | 1 de agosto de 20 | bc=BCE |df=mdy}} → 1 de agosto de 30
• df = "dmy" / "mdy" / "y" - default é "dmy"
• bc = "BC" / "BCE" - default é "BCE"

* Não está funcionando normalmente

Adendo sobre o idioma de retorno

Por padrão, os rótulos retornados pelo módulo serão retornados por default na variante brasileira do português. Caso um editor deseje que o rótulo seja retornado em português europeu (essas são, infelizmente, as duas únicas variantes implementadas no Wikidata), ao utilizar qualquer uma das funções apresentadas, basta adicionar |idioma=pt ou |idioma=pt-ao (neste caso, os rótulos serão retornados em português europeu, e as datas serão retornadas no formato angolano) nos parâmetros da função.

Ver também

• Módulo:Wikidata, lidando com o Wikidata de forma mais básica