Predefinição:Wikidata/doc

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

Esta predefinição é usada em muitas páginas e as alterações em seu conteúdo serão amplamente notadas.
Por favor, teste as alterações na subpágina de testes desta predefinição, em sua subpágina da predefinição de testes ou na subpágina de testes em seu espaço usuário. Considere discutir mudanças na página de discussão antes de implementá-las.

Esta predefinição usa Lua:

Módulo:Wd

Esta predefinição predefinição foi desenvolvida para buscar dados do Wikidata com ou sem um link ao artigo de Wikipedia conectado e com muitas outras características.

Uso[editar código-fonte]

A estrutura geral de um chamada a esta predefinição predefinição é como segue. Nota que a estrutura básica consta de ordens posicionais, campos e argumentos, o qual todos têm uma posição fixa.

{{wikidata |command1|flag1a|flag1b|flag1c |command2|flag2a|flag2b|flag2c |flag0a|flag0b|flag0c |arg1|arg2|arg3}}

Utilize {{Background color|#cddae3|comandos diferentes para conseguir classes diferentes de valores do Wikidata. Ao menos um comando tem que ser dado e podem sem dados múltiplos comando e serem combinadas a uma chamada como é mostrada acima (em qualquer comando, também é possível mais de duas), mas isto só aplica aos comandos da ordem da classe de claim; as chamadas que contêm uma ordem da a classe geral não pode conter qualquer outro comando. A cada comando pode ser seguida por qualquer número de command flags, os quais são opcionais e pode alterar para afinar a produção gerada por aquele comando.

Os comando e seus campos podem ser seguidas por qualquer número de campos de configuração, os quais são também opcionais e afetam a seleção de dados e o comportamento em geral da predefinição. A chamada está fechado com os argumento posicionais, os quais podem ser requeridos segundo a ordem dada(s). Alguns argumentos nomeados (m.q. nome-pares de valor) também podem existir, bem como um conjunto de campos nomeados para uso avançado que pode ser utilizado para mudar a maneira que busca os valores estão fundidos juntos à produção.

Esta predefinição foi desenhado para proporcionar as necessidades básicas para buscar dados do Wikidata, mas muito pode ser conseguido através de combinações diferentes de chamadas. Para comodidade, tais combinações poderiam ser envolvidas em predefinições novas que servem uma necessidade concreta. Ver também a seção em casos de uso comum abaixo para alguns exemplos de blocos "tijolos para construção". Assim mesmo, a funcionalidade disto predefinição pode ser estendida por criar predefinições de wrapper que usam o comando main proporcionada por {{module other|este módulo|Módulo:Wd o qual está a ser usada por esta predefinição (tal como faz a {{WikidataOI}}).

Casos de uso comum[editar código-fonte]

Abaixo segue uma lista de casos de uso comum. No futuro, por conveniência ordens de atalho podem ser implementadas que são equivalentes a estas chamadas.

Chamada Caso de uso

{{wikidata|rótulo|raw}}

Retorna o elemento do Q-identificador do Wikidata ligado à página atual (p. ex. "Q55").

{{#if:{{wikidata|rótulo|raw}}

|...}}

Faz um controle para determinar se a página atual tem um elemento Wikidata.

Nota que esta declaração confia num valor regressado que é ou vazio ou não-vazio e que o campo raw é importante de incluir. Sem esta bandeira, a etiqueta regular de um elemento podia ser devolvida a qual poderia estar vazia, dando um resultado não requerido. Se a bandeira está dada por outro lado, então um identificador-Q não vazio é sempre devolvido se um elemento existe e um valor vazio se um elemento não existe.

Comando[editar código-fonte]

Os comando (command1, command2, ...) Determina quais tipos de valores são devolvido. Uma chamada só pode conter comando de uma única classe.

Classe claim[editar código-fonte]

Os comando de classe de reclamação (claim) podem ser combinadas, significando que comandos múltiplos dos tipos diferentes desta classe podem ser dados de uma vez (ver acima para uso).

Combine múltiplos comandos numa chamada para fazer isto predefinição, em vez de fazer chamadas múltiplas a isto predefinição com um comando cada, para ser seguro que todo os dados devolvidos pertencem à cada chamada (ver também os exemplos abaixo).

Tipo	Ordem	Regressos	Uso básico	Descrição
I	`property`	primeira igualdade^[a]	`{{wikidata\|property\|P1}}`	Devolve a propriedade pedida – ou uma lista de propriedades – desde a atual entidade-item ou uma entidade dada. Este comando só pode ser dado uma vez numa chamada.
I	`propriedades`	all matches	`{{wikidata\|properties\|P1}}`

II	`qualifier`	primeira iguladade^[b]	`{{wikidata\|qualifier\|P1\|P2}}`	Devolve o qualificador pedido – ou uma lista de qualificadores – de uma dada propriedade ou a atual item-entidade de uma entidade dada. Diferentemente dos outros comandos claim, este comando pode ser dado múltiplas vezes para buscar diferentes qualificadores numa chamada.
II	`qualifiers`	all matches	`{{wikidata\|qualifiers\|P1\|P2}}`

III	`reference`	first match^[b]	`{{wikidata\|reference\|P1}}`	Devolve uma referência – ou uma lista de referências – desde a propriedade dada da atual item-entidade ou uma dada entidade.^[c] Este comando podem ser dados apenas uma vez numa chamada.
III	`referências`	all matches	`{{wikidata\|referências\|P1}}`

↑ Devolve só um valor singular em vez de múltiplos (se claims múltiplos ou textos são iguais). O valor devolvido é o primeiro valor dos valores best-ranked claims. ↑ ^a ^b Devolve só um valor em vez de vários valores para cada claim igual. Para buscar pelo menos um valor no total no caso do comando `property` não é tambén utilizada, adicionalmente utilize a `single` configuration flag. ↑ Só referências que são válidas de acordo com Wikidata guideline on sources são devolvidas (m.q. aquelas que tem pelo menos uma propriedade Predefinição:Wpl ou Predefinição:Wpl).

Referências de exemplo[editar código-fonte]

TemplateData[editar código-fonte]

Este modelo busca dados da base de conhecimento centralizada Wikidata. Para editar o dado, clique em "Elemento Wikidata" na info caixa à esquerda.

Parâmetros da predefinição
Parâmetro		Descrição	Tipo	Estado
Não foram especificados parâmetros

[1] Devolve só um valor singular em vez de múltiplos (se claims múltiplos ou textos são iguais). O valor devolvido é o primeiro valor dos valores best-ranked claims.

[fm-2] Devolve só um valor em vez de vários valores para cada claim igual. Para buscar pelo menos um valor no total no caso do comando property não é tambén utilizada, adicionalmente utilize a single configuration flag.

[3] Só referências que são válidas de acordo com Wikidata guideline on sources são devolvidas (m.q. aquelas que tem pelo menos uma propriedade Predefinição:Wpl ou Predefinição:Wpl).

[a]

[b]

[c]