3 167
edições
Mudanças
Ir para navegação
Ir para pesquisar
Criação da documentação da Predefinição Valor Wikidata
{{Subpágina de documentação}}
<!-- Categorias no final desta página e links para outros idiomas no Wikidata -->
{{MóduloWikidata|Esta|predefinição}}
{{lua|Módulo:Interface Wikidata}}
== Descrição ==
Esta predefinição mostra o valor de uma propriedade dada do elemento [[Wikidata]] de acordo com a etiqueta do artigo e língua.
{{warning|O uso desta predefinição é desaconselhado no corpo dos artigos do espaço principal.}}
Este predefinição serve essencialmente nas predefinições de info caixa, para mostrar o valor de uma propriedade de dados presente no Wikidata quando nenhum valor não está informado em parâmetro do artigo da info caixa. Um valor passado via o parâmetro da info caixa é sempre mostrado, sobretudo em caso que, para uma razão ou outra, não se deseja do valor proporcionado por Wikidata.
{{notícia|Ver também: [[wIRChelp:Wikidata]] e [[d:Wikidata:Glossary/pt]]
A cada artigo, por exemplo [[Nice]], está unido a um elemento no Wikidata nomeado ''Q'' seguido de um número, por exemplo ''[[d:Q33959|Q33959]]''. Estes elementos comportam ''afirmações'' sobre o assunto do artigo, constituídas de uma propriedade, como por exemplo ''[[d:Property:P17|P17]]'' « país », e de um valor (para ''[[d:Q33959|Q33959]]'' « Nice », é ''[[d:Q142|Q142]]'' « França »). A cada propriedade tem um papel bem definido, em nosso exemplo de localizar em que Estado se encontra o assunto do artigo. Este predefinição permite mostrar o valor associado, numa afirmação relativa ao artigo, a uma propriedade de dados que está passado em parâmetro da predefinição : por exemplo no artigo [[Nice]], o valor de parâmetro da predefinição ''P17'' (propriedade « país ») permite obter o valor « França ».
Em certos casos, esta predefinição acrescenta marcadores html, ou outros elementos que não aparecem obrigatoriamente à primeira vista. É desaconselhado e utilizá-lo dentro de um link interno ou externo, ou de um predefinição que exige dados muito normais. Em caso de dúvida ao respeito, podes propor as vossas questões sobre [[Discussão Predefinição:Valor Wikidata|a página de discussão]].
}}
== Sintaxe ==
=== Parâmetros não nomeados ===
<code><nowiki>{{</nowiki>Valor Wikidata| </code>''propriedade''<code> | </code>''valor a mostrar''<code> }}</code>
* n° 1 : propriedade – que identifica (ID) da propriedade em Wikidata, por exemplo : <code>P31</code> (parâmetro obrigatório)
* n° 2 : se o valor deste parâmetro não é vazio, está anunciada em prioridade em lugar do valor da propriedade em Wikidata ; para suprimir o marcador do valor Wikidata, utilizar o valor especial do parâmetro « - » (barra) que não mostra nada (parâmetro opcional)
Utilização típica numa predefinição de info caixa : substituir <code><nowiki>{{{</nowiki></code>''nome do parâmetro''<code>|}}}</code>
por
:<code><nowiki>{{</nowiki>Valor wikidata| </code>''nome da propriedade P…''<code> | <nowiki>{{{</nowiki></code>''nome do parâmetro''<code><nowiki>|}}}</nowiki> }}</code>.
=== Parâmetros nomeados opcionais ===
É possível de precisar o encarrego com ajuda de parâmetros nomeados opcionais. A selecção aqui abaixo é muito parcial. Para uma lista completa, ver [[Módulo:Infobox/Wikidata/doc]].
* <code>showqualifiers</code> : que identifica o qualificativo (propriedade secundária que precisa o valor da propriedade principal pedida) cuja se quer mostrar o valor entre parênteses
<code>showonlyqualifier</code> : que identifica o qualificativo (propriedade secundária que precisa o valor da propriedade principal pedida) que será mostrada sózinha (sem o valor da propriedade principal)
* <code>showdate</code> : anuncia entre parêntese as datas proporcionadas pelas qualificativos [[:d:P:P585|data]], [[:d:P:P580|data de estreia]] ou [[:d:P:P582|data de final]].
* <code>qualifier</code> e <code>qualifiervalue</code> : só as declarações com este qualificativo e este valor do qualificativo ; por exemplo para mostrar os materiais que compõem o pedestal de uma estátua : <code><nowiki>{{</nowiki>Valor Wikidata |P186 </code>''(« material »)''<code> |qualifier=P518 </code>''(« parte implicada »)''<code> |qualifiervalue=Q12014132 </code>''(« pedestal »)'' <code>}}</code>
* <code>rank</code> : só as declarações com este [[m:Wikidata/Data model#Ranks of Statements|faixa]], os valores possíveis são
** <code>rank=deprecated</code> : o valor da propriedade é desaconselhado/obsoleto
** <code>rank=normal</code>
** <code>rank=preferred</code> : valor preferível da propriedade, esta faixa pode corresponder por exemplo ao valor mais recente
** <code>rank=best</code> : a melhor faixa disponível entre <code>normal</code> e <code>preferred</code>. É a opção activada por padrão.
** <code>rank=valid</code> : só <code>normal</code> e <code>preferred</code>
* <code>conjtype</code> : em caso de vários valores devolvidos, o carácter ou o a cadeia de caracteres que separam os valores (por padrão, [[MediaWiki:Comma-separator|virgula e espaço]], depois « [[MediaWiki:And|e]] » entre ambas últimas). Para não pôr as virgulas : escolher o valor <code>comma</code>. Para que o « e » final esteja substituído por « ou », o valor <code>or</code>. Todos outros valor estará inserida entre cada valor, por exemplo, <nowiki><br /></nowiki> insere uma linha entre dois valores. Para mais informação, ver a função <code>conj</code> do [[Módulo:Linguística]].
* <code>numval=''n''</code> : limitar o regresso a ''n'' valores (n=1 pode ser útil por exemplo para imagens)
* <code>link</code> o sítio para o qual os ligações têm que levar. Por padrão : wIRChelp em português. O valor « - » suprime completamente as ligações (outras opções em espera de activação).
* <code>precision</code> : a precisão máxima do marcador das datas. Valores possíveis <code>year</code>, <code>month</code>, <code>month</code> e <code>day</code>. Por padrão : depende da precisão indicada sobre Wikidata.
* <code>addcat</code> : acrescenta uma categoria que permite melhor seguir o uso da propriedade. Com frequência útil, mas talvez fonte de erros quando está utilizado a um lugar inadaptado
* <code>linkback </code> : acrescenta uma ligação para o lugar de Wikidata onde se encontra o valor.
* <code>entity </code> : utilizar outro elemento que aquele associado ao artigo (se recalcula, não tem que ser vazio).
* <code>expl=</code> : não mostrar o valor da propriedade em Wikidata que se é explicitement pedido em parâmetro n° 2 (valor do parâmetro da predefinição de info caixa) pelo valor resultado de {{tl|WD}}. Útil para dados actualizados mas cuja utilidade em cada artigo é difícil a decidir automaticamente.
== Formatos por padrão ==
O formato para mostrar um valor pode ser modificado por vários parâmetros opcionais, mas por padrão os valores são devolvidos nos formatos seguintes :
* para os dados de tipo ''elemento'' : o rótulo redigido do Wikidata e o link para o artigo wIRChelp correspondente se existe. Em caso de ausência de artigo em português, um link para a wIRChelp em inglês ou para a Wikidata estará acrescentado entre parêntese a seguir ao elemento.
* dados de tipo data : mostrado em forma parecida a {{tl|dtlink}}.
* número : formato usual português com espaço após os milhares e virgulas antes dos decimais. Se o valor contém uma unidade de medida, a abreviatura regular estará utilizada ('m' para 'metros').
* texto : por padrão maiúscula no início do texto. <code>|ucfirst=-</code> permite desativar a maiúscula no inicio.
== Exemplos ==
Sobre a página presente [[Predefinição:Valor Wikidata]] :
* para a propriedade {{WD P|31}} :
: <code><nowiki>{{</nowiki>Wikidata|P31}}</code> → {{Valor Wikidata|P31}} (valor da propriedade para o elemento Wikidata unido à página presente)
: <code><nowiki>{{</nowiki>Valor Wikidata|P31|bla bla}}}</code> → {{Valor Wikidata|P31|bla bla}} (valor proporcionado por exemplo em parâmetro de infobox num artigo, e passando antes aquela da Wikidata)
Num predefinição chamada pelo artigo [[Nice]] (associado ao elemento Wikidata {{WD Q|33959}}) :
* para a propriedade {{WD P|17}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P17}}</code> → {{Valor Wikidata|entity=Q33959|P17}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P17|link=-}}</code> → {{Valor Wikidata|entity=Q33959|P17|link=-}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P17|displayformat=raw}}</code> → {{Valor Wikidata|entity=Q33959|P17|displayformat=raw}} (identificador do elemento Wikidata {{WD Q|142}})
* para a propriedade {{WD P|856}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P856}}</code> → {{Valor Wikidata|entity=Q33959|P856}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P856|displayformat=weblink}}</code> → {{Valor Wikidata|entity=Q33959|P856|displayformat=weblink}}
Numa predefinição chamada pelo artigo [[Alemanha]] (associada ao elemento Wikidata {{WD Q|183}}) :
* para a propriedade {{WD P|36}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36}}</code> → {{Valor Wikidata|entity=Q183|P36}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|rank=valid}}</code> → {{Valor Wikidata|entity=Q183|P36|rank=valid}}
* para anunciar também o qualificativo {{WD P|580}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|showqualifiers=P580}}</code> → {{Valor Wikidata|entity=Q183|P36|showqualifiers=P580}}
* para mostrar só o qualificativo {{WD P|580}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|showonlyqualifier=P580}}</code> → {{Valor Wikidata|entity=Q183|P36|showonlyqualifier=P580}}
== Ver também ==
*{{tl|Título}}
*{{tl|Redação Wikidata}}
*{{tl|WD}}
*[[d:Wikidata:Notes/Inclusion syntax]]
<includeonly>
<!-- Categorias aqui e links para outros idiomas no Wikidata -->
{{Testes outro||
[[Categoria:!Predefinições de recuperação de dados]]
[[Categoria:!Predefinições que utilizam dados do Wikidata]]
[[Categoria:!Wikidata]]
}}</includeonly>
<!-- Categorias no final desta página e links para outros idiomas no Wikidata -->
{{MóduloWikidata|Esta|predefinição}}
{{lua|Módulo:Interface Wikidata}}
== Descrição ==
Esta predefinição mostra o valor de uma propriedade dada do elemento [[Wikidata]] de acordo com a etiqueta do artigo e língua.
{{warning|O uso desta predefinição é desaconselhado no corpo dos artigos do espaço principal.}}
Este predefinição serve essencialmente nas predefinições de info caixa, para mostrar o valor de uma propriedade de dados presente no Wikidata quando nenhum valor não está informado em parâmetro do artigo da info caixa. Um valor passado via o parâmetro da info caixa é sempre mostrado, sobretudo em caso que, para uma razão ou outra, não se deseja do valor proporcionado por Wikidata.
{{notícia|Ver também: [[wIRChelp:Wikidata]] e [[d:Wikidata:Glossary/pt]]
A cada artigo, por exemplo [[Nice]], está unido a um elemento no Wikidata nomeado ''Q'' seguido de um número, por exemplo ''[[d:Q33959|Q33959]]''. Estes elementos comportam ''afirmações'' sobre o assunto do artigo, constituídas de uma propriedade, como por exemplo ''[[d:Property:P17|P17]]'' « país », e de um valor (para ''[[d:Q33959|Q33959]]'' « Nice », é ''[[d:Q142|Q142]]'' « França »). A cada propriedade tem um papel bem definido, em nosso exemplo de localizar em que Estado se encontra o assunto do artigo. Este predefinição permite mostrar o valor associado, numa afirmação relativa ao artigo, a uma propriedade de dados que está passado em parâmetro da predefinição : por exemplo no artigo [[Nice]], o valor de parâmetro da predefinição ''P17'' (propriedade « país ») permite obter o valor « França ».
Em certos casos, esta predefinição acrescenta marcadores html, ou outros elementos que não aparecem obrigatoriamente à primeira vista. É desaconselhado e utilizá-lo dentro de um link interno ou externo, ou de um predefinição que exige dados muito normais. Em caso de dúvida ao respeito, podes propor as vossas questões sobre [[Discussão Predefinição:Valor Wikidata|a página de discussão]].
}}
== Sintaxe ==
=== Parâmetros não nomeados ===
<code><nowiki>{{</nowiki>Valor Wikidata| </code>''propriedade''<code> | </code>''valor a mostrar''<code> }}</code>
* n° 1 : propriedade – que identifica (ID) da propriedade em Wikidata, por exemplo : <code>P31</code> (parâmetro obrigatório)
* n° 2 : se o valor deste parâmetro não é vazio, está anunciada em prioridade em lugar do valor da propriedade em Wikidata ; para suprimir o marcador do valor Wikidata, utilizar o valor especial do parâmetro « - » (barra) que não mostra nada (parâmetro opcional)
Utilização típica numa predefinição de info caixa : substituir <code><nowiki>{{{</nowiki></code>''nome do parâmetro''<code>|}}}</code>
por
:<code><nowiki>{{</nowiki>Valor wikidata| </code>''nome da propriedade P…''<code> | <nowiki>{{{</nowiki></code>''nome do parâmetro''<code><nowiki>|}}}</nowiki> }}</code>.
=== Parâmetros nomeados opcionais ===
É possível de precisar o encarrego com ajuda de parâmetros nomeados opcionais. A selecção aqui abaixo é muito parcial. Para uma lista completa, ver [[Módulo:Infobox/Wikidata/doc]].
* <code>showqualifiers</code> : que identifica o qualificativo (propriedade secundária que precisa o valor da propriedade principal pedida) cuja se quer mostrar o valor entre parênteses
<code>showonlyqualifier</code> : que identifica o qualificativo (propriedade secundária que precisa o valor da propriedade principal pedida) que será mostrada sózinha (sem o valor da propriedade principal)
* <code>showdate</code> : anuncia entre parêntese as datas proporcionadas pelas qualificativos [[:d:P:P585|data]], [[:d:P:P580|data de estreia]] ou [[:d:P:P582|data de final]].
* <code>qualifier</code> e <code>qualifiervalue</code> : só as declarações com este qualificativo e este valor do qualificativo ; por exemplo para mostrar os materiais que compõem o pedestal de uma estátua : <code><nowiki>{{</nowiki>Valor Wikidata |P186 </code>''(« material »)''<code> |qualifier=P518 </code>''(« parte implicada »)''<code> |qualifiervalue=Q12014132 </code>''(« pedestal »)'' <code>}}</code>
* <code>rank</code> : só as declarações com este [[m:Wikidata/Data model#Ranks of Statements|faixa]], os valores possíveis são
** <code>rank=deprecated</code> : o valor da propriedade é desaconselhado/obsoleto
** <code>rank=normal</code>
** <code>rank=preferred</code> : valor preferível da propriedade, esta faixa pode corresponder por exemplo ao valor mais recente
** <code>rank=best</code> : a melhor faixa disponível entre <code>normal</code> e <code>preferred</code>. É a opção activada por padrão.
** <code>rank=valid</code> : só <code>normal</code> e <code>preferred</code>
* <code>conjtype</code> : em caso de vários valores devolvidos, o carácter ou o a cadeia de caracteres que separam os valores (por padrão, [[MediaWiki:Comma-separator|virgula e espaço]], depois « [[MediaWiki:And|e]] » entre ambas últimas). Para não pôr as virgulas : escolher o valor <code>comma</code>. Para que o « e » final esteja substituído por « ou », o valor <code>or</code>. Todos outros valor estará inserida entre cada valor, por exemplo, <nowiki><br /></nowiki> insere uma linha entre dois valores. Para mais informação, ver a função <code>conj</code> do [[Módulo:Linguística]].
* <code>numval=''n''</code> : limitar o regresso a ''n'' valores (n=1 pode ser útil por exemplo para imagens)
* <code>link</code> o sítio para o qual os ligações têm que levar. Por padrão : wIRChelp em português. O valor « - » suprime completamente as ligações (outras opções em espera de activação).
* <code>precision</code> : a precisão máxima do marcador das datas. Valores possíveis <code>year</code>, <code>month</code>, <code>month</code> e <code>day</code>. Por padrão : depende da precisão indicada sobre Wikidata.
* <code>addcat</code> : acrescenta uma categoria que permite melhor seguir o uso da propriedade. Com frequência útil, mas talvez fonte de erros quando está utilizado a um lugar inadaptado
* <code>linkback </code> : acrescenta uma ligação para o lugar de Wikidata onde se encontra o valor.
* <code>entity </code> : utilizar outro elemento que aquele associado ao artigo (se recalcula, não tem que ser vazio).
* <code>expl=</code> : não mostrar o valor da propriedade em Wikidata que se é explicitement pedido em parâmetro n° 2 (valor do parâmetro da predefinição de info caixa) pelo valor resultado de {{tl|WD}}. Útil para dados actualizados mas cuja utilidade em cada artigo é difícil a decidir automaticamente.
== Formatos por padrão ==
O formato para mostrar um valor pode ser modificado por vários parâmetros opcionais, mas por padrão os valores são devolvidos nos formatos seguintes :
* para os dados de tipo ''elemento'' : o rótulo redigido do Wikidata e o link para o artigo wIRChelp correspondente se existe. Em caso de ausência de artigo em português, um link para a wIRChelp em inglês ou para a Wikidata estará acrescentado entre parêntese a seguir ao elemento.
* dados de tipo data : mostrado em forma parecida a {{tl|dtlink}}.
* número : formato usual português com espaço após os milhares e virgulas antes dos decimais. Se o valor contém uma unidade de medida, a abreviatura regular estará utilizada ('m' para 'metros').
* texto : por padrão maiúscula no início do texto. <code>|ucfirst=-</code> permite desativar a maiúscula no inicio.
== Exemplos ==
Sobre a página presente [[Predefinição:Valor Wikidata]] :
* para a propriedade {{WD P|31}} :
: <code><nowiki>{{</nowiki>Wikidata|P31}}</code> → {{Valor Wikidata|P31}} (valor da propriedade para o elemento Wikidata unido à página presente)
: <code><nowiki>{{</nowiki>Valor Wikidata|P31|bla bla}}}</code> → {{Valor Wikidata|P31|bla bla}} (valor proporcionado por exemplo em parâmetro de infobox num artigo, e passando antes aquela da Wikidata)
Num predefinição chamada pelo artigo [[Nice]] (associado ao elemento Wikidata {{WD Q|33959}}) :
* para a propriedade {{WD P|17}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P17}}</code> → {{Valor Wikidata|entity=Q33959|P17}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P17|link=-}}</code> → {{Valor Wikidata|entity=Q33959|P17|link=-}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P17|displayformat=raw}}</code> → {{Valor Wikidata|entity=Q33959|P17|displayformat=raw}} (identificador do elemento Wikidata {{WD Q|142}})
* para a propriedade {{WD P|856}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P856}}</code> → {{Valor Wikidata|entity=Q33959|P856}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P856|displayformat=weblink}}</code> → {{Valor Wikidata|entity=Q33959|P856|displayformat=weblink}}
Numa predefinição chamada pelo artigo [[Alemanha]] (associada ao elemento Wikidata {{WD Q|183}}) :
* para a propriedade {{WD P|36}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36}}</code> → {{Valor Wikidata|entity=Q183|P36}}
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|rank=valid}}</code> → {{Valor Wikidata|entity=Q183|P36|rank=valid}}
* para anunciar também o qualificativo {{WD P|580}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|showqualifiers=P580}}</code> → {{Valor Wikidata|entity=Q183|P36|showqualifiers=P580}}
* para mostrar só o qualificativo {{WD P|580}} :
: <code><nowiki>{{</nowiki>Valor Wikidata|P36|showonlyqualifier=P580}}</code> → {{Valor Wikidata|entity=Q183|P36|showonlyqualifier=P580}}
== Ver também ==
*{{tl|Título}}
*{{tl|Redação Wikidata}}
*{{tl|WD}}
*[[d:Wikidata:Notes/Inclusion syntax]]
<includeonly>
<!-- Categorias aqui e links para outros idiomas no Wikidata -->
{{Testes outro||
[[Categoria:!Predefinições de recuperação de dados]]
[[Categoria:!Predefinições que utilizam dados do Wikidata]]
[[Categoria:!Wikidata]]
}}</includeonly>
