Exibir código-fonte para Módulo:Info/wd/doc

<section begin=header />
{{#ifeq:{{#invoke:String|find|{{FULLPAGENAME}}|Testes}}|0|<includeonly>{{alto-risco| 30000}}</includeonly>{{Module rating|p}}}}<!-- if pagename does not contain sandbox -->
<section end=header />

== Descrição ==
Este módulo gera os campos do [[Módulo:Info]] que pedem dados do [[Wikidata]]. Algumas fuções podem ser usadas de forma idependente para exibir os dados fora da infobox.

== Uso ==
Dentro dos campos da infobox é preciso colocar o prefixo <code>#wd:</code> ou <code>#WD:</code> seguido da propriedade que deve ser preenchida.

Por exemplo <code>#wd:P17</code> vai buscar a propriedade P17 (país) no item da página no Wikidata. Cada campo pode ter mais de uma propriedade, por exemplo <code>#wd:P569 P19</code> vai gerar a P569 (data de nascimento) seguido da P19 (local de nascimento).

Este módulo pode também ser usado fora da infobox com a função ''dados'' para obter uma propriedade, por exemplo <code><nowiki>{{#invoke:Info/wd|dados|P17}}</nowiki></code>, ou a função ''expandir'' para obter uma ou mais propriedades.

=== Grupos condicionais ===
Quando o campo tem mais de uma propriedade pode ser usados grupos condicionais delimitados por <code>{ }</code> (chaves simples), o que estiver dentro das chaves só será exibido se uma propriedade dentro desse grupo foi obtida da Wikidata. Por exemplo se em uma página P569 é "1 de janeiro de 1959" e não existir a P19, então <code>#wd:P569 em P19</code> vai retornar "1 de janeiro de 1959 em" e <code>#wd:P569{ em P19}</code> vai retornar "1 de janeiro de 1959", pois o "em" está dentro do grupo em que nenhuma propriedade foi obtida.

=== Funções especiais ===
Para diferentes tipos de dados existem diferentes funções especiais que podem ser usadas para modificar o valor obtido do Wikidata.

==== Itens da Wikidata ====
Quando a propriedade é um item do Wikidata é possível usar a função ''':link''' para gerar um link se aquele item for ligado a uma página da wIRChelp. Se P17 for Alemanha, <code>P17</code> retorna Alemanha e <code>P17:link</code> retorna [[Alemanha]].

==== Números com unidades ====
Os números com unidades usam os dados do [[Módulo:Unidades]] para colocar links e fazer conversões.

{|class="wikitable"
|+Funções com unidades
|-
!Sintaxe||descrição||colspan=2|Exemplo com P2048 = 324 m
|-
|:link||coloca link na unidade||<code>P2048:link</code>||325 [[metro|m]]
|-
|:unidade:&lt;nome ou simbolo da unidade&gt;||força uma unidade específica||<code>P2048:ft</code>||1063 ft
|-
|:unidade:&lt;nome ou simbolo da unidade&gt;:link||força uma unidade e coloca link||<code>P2048:ft:link</code>||1063 [[Pé (unidade)|ft]]
|-
|:converter:&lt;nome ou simbolo da unidade&gt;||adiciona a conversão para outra unidade||<code>P2048:converter:ft</code>||324 m (1063 ft)
|-
|:link:converter:&lt;nome ou simbolo da unidade&gt;:link||o mesmo com link nas unidades||<code>P2048:link:converter:ft:link</code>||324 [[metro|m]] (1063 [[Pé (unidade)|ft]])
|-
|:alg:&lt;algarismos significativos&gt;||altera o número de algarismos significativos (o padrão é 4)||<code>P2048:alg:2</code>||320 m
|-
|:link:converter:&lt;nome ou simbolo da unidade&gt;:alg:&lt;algarismos significativos&gt;:link||todas as funções acima||<code>P2048:link:converter:ft:alg:6:link</code>||324 [[metro|m]] (1062.99 [[Pé (unidade)|ft]])
|-
|:mais:&lt;número ou propriedade&gt;||soma||<code>P2048:mais:10</code>||334
|-
|:menos:&lt;número ou propriedade&gt;||subtrai||<code>P2048:menos:20</code>||304
|-
|:vezes:&lt;número ou propriedade&gt;||multiplica||<code>P2048:vezes:1000</code>||334000
|-
|:dividido:&lt;número ou propriedade&gt;||divide||<code>P2048:dividido:P123</code> (sendo P123 = 20)||16,2
|}

==== Coordenadas ====
As coordenadas tem também a função ''':link''' que faz com que as coordenadas tenham um link para o geohack como é usual em coordenadas geográficas na wIRChelp. Após o :link podem haver pares de argumentos que serão passados para o link como [[mw:GeoHack#params|parâmetros do geohack]]. Por exemplo, se as coordenadas forem 12° 34' 56" S 12° 34' 56" O, <code>P625:link:scale:300000</code> retorna <span class="plainlinks" style="white-space:nowrap" title="Mapas, fotos aéreas e outros dados para este local">[//tools.wmflabs.org/geohack/geohack.php?language=pt&pagename=T%C3%ADtulo+da+p%C3%A1gina&params=12_34_56_S_12_34_56_W_scale:300000 12°&nbsp;34'&nbsp;56"&nbsp;S 12°&nbsp;34'&nbsp;56"&nbsp;O]</span>.

=== Qualificadores ===
Além do formato '''#wd:P1''' também são aceitos outros formatos que pegam outros dados das propriedades do item no Wikidata:
* '''#wd:P1:P2''' → pega o qualificador P2 da propriedade P1.
* '''#wd:P1:P2:Q2''' → pega o valor da propriedade P1 onde o valor do qualificador P2 é igual a Q2.
* '''#wd:P1:Q1:P2''' → pega o valor do qualificador P2 da propriedade P1 onde o valor de P1 é Q1.

Exemplo:
{|style="border:1px solid #C8CCD1; border-collapse:collapse; background-color:#FFFFFF"
|-
|rowspan=4 style="background-color:#EAECF0; vertical-align:top; padding:10px"|Exemplo (P123)
|style="padding:10px 10px 0 10px"|Valor A (Q456)
|
|-
|style="border-bottom:1px solid #EAECF0; padding:10px"|<small>Qualificador (P789)</small>
|style="border-bottom:1px solid #EAECF0; padding:10px"|Valor X (Q2468)
|-
|style="padding:10px 10px 0 10px"|Valor B (Q654)
|
|-
|style="padding:10px"|<small>Qualificador (P789)</small>
|style="padding:10px"|Valor Y (Q8642)
|-
|colspan=3 style="background-color:#EAECF0"|&nbsp;
|}
* #wd:P123 → Valor A
* #wd:P123:P789 → Valor X
* #wd:P123:P789:Q8642 → Valor B
* #wd:P123:Q654:P789 → Valor Y

Exemplo em [[d:Q243]] (Torre Eiffel):
* #wd:P2048 → 324 m (altura)
* #wd:P2048:P1013 → altura máxima (critério usado (P1013) para a altura (P2048))
* #wd:P2048:P1013:Q31271474 → 300 m (altura (P2048) onde o critério usado (P1013) é a altura arquitetônica (Q31271474))
* #wd:P127:Q90:P580 → 1889 (data de início (P580) em que Paris (P90) é o proprietário (P127))

=== Testes ===
Este módulo também pode ser invocado diretamente para testes, com a função dados para retornar somente um propriedade, por exemplo <code><nowiki>{{#invoke:Info/wd|dados|P6:link}}</nowiki></code>, ou com a função expandir para retornar mais de uma unidade da forma como seria processado no campo da infobox, por exemplo <code><nowiki>{{#invoke:Info/wd|expandir|P569{ em P19} }}</nowiki></code>. Adicione <code>|debug</code> após a propriedade para obter mensagens de debug.

Este módulo não deve ser invocado dessa forma ao preencher a infobox, pois isso impediria que a infobox identifique que o dado veio do Wikidata e contabilize como dado do Wikidata para categorizações de contagem de campos.

== Ver também ==
* [[Módulo:Info]]
* [[Módulo:Infobox/Wikidata]]
* [[Módulo:WikidataIB]]
* [[Módulo:Wikidata]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|Testes||
[[Categoria:!Módulos]]
[[Categoria:!Metamódulos Lua]]
}}</includeonly>