3 167
edições
Mudanças
Criação da documentação do Módulo Info/wd
<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:<nome ou simbolo da unidade>||força uma unidade específica||<code>P2048:ft</code>||1063 ft
|-
|:unidade:<nome ou simbolo da unidade>:link||força uma unidade e coloca link||<code>P2048:ft:link</code>||1063 [[Pé (unidade)|ft]]
|-
|:converter:<nome ou simbolo da unidade>||adiciona a conversão para outra unidade||<code>P2048:converter:ft</code>||324 m (1063 ft)
|-
|:link:converter:<nome ou simbolo da unidade>:link||o mesmo com link nas unidades||<code>P2048:link:converter:ft:link</code>||324 [[metro|m]] (1063 [[Pé (unidade)|ft]])
|-
|:alg:<algarismos significativos>||altera o número de algarismos significativos (o padrão é 4)||<code>P2048:alg:2</code>||320 m
|-
|:link:converter:<nome ou simbolo da unidade>:alg:<algarismos significativos>:link||todas as funções acima||<code>P2048:link:converter:ft:alg:6:link</code>||324 [[metro|m]] (1062.99 [[Pé (unidade)|ft]])
|-
|:mais:<número ou propriedade>||soma||<code>P2048:mais:10</code>||334
|-
|:menos:<número ou propriedade>||subtrai||<code>P2048:menos:20</code>||304
|-
|:vezes:<número ou propriedade>||multiplica||<code>P2048:vezes:1000</code>||334000
|-
|:dividido:<número ou propriedade>||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¶ms=12_34_56_S_12_34_56_W_scale:300000 12° 34' 56" S 12° 34' 56" 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"|
|}
* #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>
{{#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:<nome ou simbolo da unidade>||força uma unidade específica||<code>P2048:ft</code>||1063 ft
|-
|:unidade:<nome ou simbolo da unidade>:link||força uma unidade e coloca link||<code>P2048:ft:link</code>||1063 [[Pé (unidade)|ft]]
|-
|:converter:<nome ou simbolo da unidade>||adiciona a conversão para outra unidade||<code>P2048:converter:ft</code>||324 m (1063 ft)
|-
|:link:converter:<nome ou simbolo da unidade>:link||o mesmo com link nas unidades||<code>P2048:link:converter:ft:link</code>||324 [[metro|m]] (1063 [[Pé (unidade)|ft]])
|-
|:alg:<algarismos significativos>||altera o número de algarismos significativos (o padrão é 4)||<code>P2048:alg:2</code>||320 m
|-
|:link:converter:<nome ou simbolo da unidade>:alg:<algarismos significativos>:link||todas as funções acima||<code>P2048:link:converter:ft:alg:6:link</code>||324 [[metro|m]] (1062.99 [[Pé (unidade)|ft]])
|-
|:mais:<número ou propriedade>||soma||<code>P2048:mais:10</code>||334
|-
|:menos:<número ou propriedade>||subtrai||<code>P2048:menos:20</code>||304
|-
|:vezes:<número ou propriedade>||multiplica||<code>P2048:vezes:1000</code>||334000
|-
|:dividido:<número ou propriedade>||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¶ms=12_34_56_S_12_34_56_W_scale:300000 12° 34' 56" S 12° 34' 56" 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"|
|}
* #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>