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

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

{{VT|Predefinição:Linha|Módulo:Infobox|Módulo:Interface Wikidata}}
== Descrição ==
Este módulo gera infoboxes semelhante à {{lp|Info}}

== Uso ==
O módulo funciona de modo semelhante à {{lp|Info}} e em muitos casos vai funcionar da mesma forma ao trocar a linha
<pre>{{Info</pre>
por
<pre>{{#invoke:Info|base</pre>

O preenchimento dos campos pode ser igual ao da {{lp|Info}} (usando rótulo1, dados1, rótulo2, dados2, etc), porém este módulo oferece uma opção mais simples de preenchimento:

{{#invoke:Info|base
| cor      = 6.3
| título   = Título
| rodapé   = Rodapé
| #tópico  : Tópico 1
| Rótulo A : dados A
| Rótulo B : dados B
| Rótulo C : {{{campo C|}}}
| : dados D sem rótulo
| #tópico  : Tópico 2
| Rótulo E : dados E
}}
<pre style="display:table">{{#invoke:Info|base
| cor      = 6.3
| título   = Título
| rodapé   = Rodapé
| #tópico  : Tópico 1
| Rótulo A : dados A
| Rótulo B : dados B
| Rótulo B : #wd:17
| Rótulo C : {{{campo C|}}}
| Rótulo C : #wd:P123
| : dados D sem rótulo
| #tópico  : Tópico 2
| Rótulo E : dados E
}}
</pre>
Nessa forma de preenchimento os rótulos e dados são inseridos na mesma linha, o que torna a criação da infobox mais rápida, e como não existe números nos campos é mais fácil trocar a ordem dos campos e inserir novos campos em qualquer posição.

Quando existem dois rótulos iguais, como o "Rótulo C" no exemplo acima, será criado somente um campo com esse rótulo, usando o primeiro campo que possuir dados, o "#wd:P123" é a forma como uma propriedade do Wikidata é usada, como não existe essa propriedade para esta página o campo não é preenchido.

=== Wikidata ===
Se os dados estiverem no formato #wd:P&lt;número da propriedade&gt;, os dados dessa propriedade serão obtidos do Wikidata, por exemplo <code>|país: #wd:P17</code> vai gerar o rótulo "país" e pegar o nome do país no Wikidata. Para colocar ligação interna coloque ":link" depois da propriedade, por exemplo <code>#wd:P17:link</code>. Outras funções também estão disponíveis para modificar o valor obtido do Wikidata, veja a documentação do [[Módulo:Info/wd]] para detalhes.

Todo campo que estiver usando dados do Wikidata tem a classe de estilo "dadoswd", isso é útil para visualizar quais campos usam dados do Wikidata e quais usam dados locais, para isso edite [[Especial:Minha página/common.css|o seu common.css]] e adicione algum estilo para diferenciar os campos do Wikidata dos campos locais. O exemplo abaixo coloca um borda roxa a direita do campo:
<syntaxhighlight lang="css">
/* Exibir borda roxa ao lado dos campos da infobox que usam dados do Wikidata */
.dadoswd {
    border-right: 1px solid #CC99FF
}
</syntaxhighlight>
{|style="font-size: 90%; line-height: 1.2em; float:right; clear:right; margin:0 0 .5em 1em; width: 20em; border: 1px solid #C7C7C7; padding: 2px; background-color: #FAFAFA"
|-
!colspan=2 style="height:45px; vertical-align:middle; text-align:center; font-size:120%; font-weight:bolder; line-height:1.3em; position:relative;background-color:#E3E3E3"|Diferenciar campos do Wikidata
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold;"|Rótulo1
|style="vertical-align:top; text-align:left; font-weight:bold;"|dado preenchido localmente
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold;"|Rótulo2
|style="vertical-align:top; text-align:left; font-weight:bold; border-right: 1px solid #CC99FF"|dado obtido do Wikidata
|}
O código acima em seu common.css produz o efeito ao lado nas infoboxes com dados do Wikidata. O efeito é sutil mas suficiente para diferenciar visualmente qual campo usa dados do Wikidata, para marcar a diferença de forma mais forte use cores mais fortes, bordas mais espessas ou qualquer outro estilo que quiser, só você verá o estilo que configurar no seu common.css.

=== Cor e estilos ===
Este módulo segue o [[wIRChelp:Padrão visual|padrão visual]], nenhuma classe de estilo ou estilos em linha podem ser adicionados, isso garante a acessibilidade das informações e garante uma consistência visual. Somente a cor pode ser alterada usando as cores padrões.

Para usar cores preencha o parâmetro <code>|cor=</code> com uma das cores do padrão visual ou os respectivos números na tabela de cores abaixo, essa cor será usada como fundo do título, as cores mais claras da mesma matiz serão automaticamente usadas no fundo dos tópicos (primeira mais clara) e rótulos (segunda mais clara).
{|style="font-size: 90%; line-height: 1.2em; float:right; clear:right; margin:0 0 .5em 1em; width: 20em; border: 1px solid #C7C7C7; padding: 2px; background-color: #FAFAFA"
|-
!colspan=2 style="height:45px; vertical-align:middle; text-align:center; font-size:120%; font-weight:bolder; line-height:1.3em; position:relative; background-color:#BDFFBD"|Cor 9.3
|-
|colspan=2 style="vertical-align: top; text-align: center"|dados sem rótulo
|-
|colspan=2 style="text-align:center; font-weight:bold; background-color:#DEFFDE"|Tópico
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold;"|Rótulo1
|style="vertical-align:top; text-align:left; font-weight:bold;"|dados
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold;"|Rótulo2
|style="vertical-align:top; text-align:left; font-weight:bold;"|dados
|-
|colspan=2 style="text-align:center; background-color:#DEFFDE"|Rodapé
|}
{|style="font-size: 90%; line-height: 1.2em; float:right; clear:right; margin:0 0 .5em 1em; width: 20em; border: 1px solid #C7C7C7; padding: 2px; background-color: #FAFAFA"
|-
!colspan=2 style="height:45px; vertical-align:middle; text-align:center; font-size:120%; font-weight:bolder; line-height:1.3em; position:relative; background-color:#B00058; color:#FFFFFF"|Cor 2.1
|-
|colspan=2 style="vertical-align: top; text-align: center"|dados sem rótulo
|-
|colspan=2 style="text-align:center; font-weight:bold; background-color:#FFABD5"|Tópico
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold; background-color:#FFD5EA"|Rótulo1
|style="vertical-align:top; text-align:left; font-weight:bold;"|dados
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold; background-color:#FFD5EA"|Rótulo2
|style="vertical-align:top; text-align:left; font-weight:bold;"|dados
|-
|colspan=2 style="text-align:center; background-color:#FFABD5"|Rodapé
|}
{|class="wikitable" style="font-weight:bold"
|-
!Tom escuro!!Tom médio!!Tom claro!!Tom mais claro
|-
|style="background-color:#B60000; color:white"|1.1||style="background-color:#FFAFAF"|1.2
|style="background-color:#FFD7D7"|1.3||style="background-color:#FFEBEB"|1.4
|-
|style="background-color:#B00058; color:white"|2.1||style="background-color:#FFABD5"|2.2
|style="background-color:#FFD5EA"|2.3||style="background-color:#FFEAF5"|2.4
|-
|style="background-color:#840084; color:white"|3.1||style="background-color:#FFA4FF"|3.2
|style="background-color:#FFD2FF"|3.3||style="background-color:#FFE9FF"|3.4
|-
|style="background-color:#5800B1; color:white"|4.1||style="background-color:#DAB5FF"|4.2
|style="background-color:#EDDAFF"|4.3||style="background-color:#F6EDFF"|4.4
|-
|style="background-color:#2020C9; color:white"|5.1||style="background-color:#BFBFFF"|5.2
|style="background-color:#DFDFFF"|5.3||style="background-color:#EFEFFF"|5.4
|-
|style="background-color:#0057AF; color:white"|6.1||style="background-color:#93C9FF"|6.2
|style="background-color:#C9E4FF"|6.3||style="background-color:#E4F2FF"|6.4
|-
|style="background-color:#00626F; color:white"|7.1||style="background-color:#11E4FF"|7.2
|style="background-color:#88F2FF"|7.3||style="background-color:#C4F9FF"|7.4
|-
|style="background-color:#00654E; color:white"|8.1||style="background-color:#27FFCF"|8.2
|style="background-color:#93FFE7"|8.3||style="background-color:#C9FFF3"|8.4
|-
|style="background-color:#006800; color:white"|9.1||style="background-color:#7BFF7B"|9.2
|style="background-color:#BDFFBD"|9.3||style="background-color:#DEFFDE"|9.4
|-
|style="background-color:#4A6000; color:white"|10.1||style="background-color:#CFFF27"|10.2
|style="background-color:#E7FF93"|10.3||style="background-color:#F3FFC9"|10.4
|-
|style="background-color:#655900; color:white"|11.1||style="background-color:#FFE411"|11.2
|style="background-color:#FFF288"|11.3||style="background-color:#FFF9C4"|11.4
|-
|style="background-color:#8C4600; color:white"|12.1||style="background-color:#FFB56B"|12.2
|style="background-color:#FFDAB5"|12.3||style="background-color:#FFEDDA"|12.4
|-
|style="background-color:#585858; color:white"|13.1||style="background-color:#C7C7C7"|13.2
|style="background-color:#E3E3E3"|13.3||style="background-color:#F1F1F1"|13.4
|}

=== Pictograma ===
Pictogramas podem ser colocados no título da infobox com o parâmetro pictograma:
{|style="font-size: 90%; line-height: 1.2em; float:right; clear:right; margin:0 0 .5em 1em; width: 20em; border: 1px solid #C7C7C7; padding: 2px; background-color: #FAFAFA"
|-
!colspan=2 style="height:45px; vertical-align:middle; text-align:center; font-size:120%; font-weight:bolder; line-height:1.3em; position:relative; background-color:#FFDAB5"|<div style="position:absolute; top:0; right:0; opacity:1">[[Ficheiro:Picto infobox map.png|x45px]]</div>Título
|-
|colspan=2 style="text-align:center; font-weight:bold; background-color:#FFEDDA"|Tópico
|-
|scope="row" style="vertical-align:top; text-align:left; font-weight:bold;"|Rótulo
|style="vertical-align:top; text-align:left; font-weight:bold;"|dados
|}
<pre style="display:table">{{#invoke:Info|base
|título     = Título
|cor        = 12.3
|pictograma = Picto infobox map.png
|#tópico    : Tópico
|rótulo     : dados
}}
</pre>

=== Imagem e legenda ===
A imagem pode ser inserida usando o rótulo #imagem e a legenda com o rótulo #legenda como no exemplo abaixo.
{{#invoke:Info|base
|título   = Imagem e legenda
|#imagem  : Flatirons Winter Sunrise edit.jpg
|#legenda : esta é a legenda da imagem
}}
<pre style="display:table"><nowiki>{{#invoke:Info|base
|título   = Imagem e legenda
|#imagem  : Flatirons Winter Sunrise edit.jpg
|#legenda : esta é a legenda da imagem
}}</nowiki></pre>

A imagem inserida pode estar no formato "exemplo.jpg" ou no formato "<nowiki>[[Ficheiro:exemplo.jpg|220px]]</nowiki>", caso esteja no segundo formato o módulo irá usar somente o nome da imagem, qualquer argumento como o tamanho será ignorado, o tamanho exibido será sempre 200px.

A legenda pode ser usada após uma imagem ou após qualquer outro campo, mesmo que a legenda esteja preenchida ela só será exibida se o campo acima contiver dados, e ela terá o texto menor <span style="font-size: 90%">(90%)</span>, então não é preciso usar &lt;small&gt;.

=== Fusão de infoboxes ===
É possível inserir uma infobox dentro da outra simplesmente colocando-a dentro de um campo como no exemplo abaixo.
{{#invoke:Info|base
|título   = Infobox principal
|Rótulo A : dados A
|Rótulo B : dados B
{{#invoke:Info|base
|título = Infobox secundária (este título não aparece)
|#tópico : Tópico da segunda infobox
|Rótulo 2A : dados 2A
|Rótulo 2B : dados 2B
}}
{{#invoke:Info|base
|título = Infobox secundária (este título não aparece)
|#tópico : Tópico da terceira infobox
|Rótulo 3A : dados 3A
|Rótulo 3B : dados 3B
}}
|Rótulo C : dados C
}}
<pre style="display:table">{{#invoke:Info|base
|título   = Infobox principal
|Rótulo A : dados A
|Rótulo B : dados B
{{#invoke:Info|base
|título = Infobox secundária (este título não aparece)
|#tópico : Tópico da segunda infobox
|Rótulo 2A : dados 2A
|Rótulo 2B : dados 2B
}}
{{#invoke:Info|base
|título = Infobox secundária (este título não aparece)
|#tópico : Tópico da terceira infobox
|Rótulo 3A : dados 3A
|Rótulo 3B : dados 3B
}}
|Rótulo C : dados C
}}
</pre>

Ao incluir uma infobox dentro de outra lembre de usar infoboxes com a mesma cor e preste atenção aos campos que usam o Wikidata, pois mesmo que uma informação não for preenchida localmente ela pode ser preenchida com dados do Wikidata e fazer com que duas infoboxes fundidas tenham campos repetidos.

=== Contagem de campos ===
O número de campos das infoboxes são contados e por padrão a página é categorizada quando [[:Categoria:!Infoboxes com nenhum campo|não tem nenhum campo]], [[:Categoria:!Infoboxes com 1 campo|tem apenas 1 campo]], [[:Categoria:!Infoboxes com 2 campos|tem apenas 2 campos]] e quando [[:Categoria:!Infoboxes em que todos campos são do Wikidata|todos os campos são obtidos do Wikidata]]. Essa categorização ajuda a encontrar infoboxes que precisam de mais dados.

A contagem tambem pode ser modificada através dos parâmetros 'contar campos' e 'contar wikidata':
* <code>|contar campos=sim</code> vai fazer a categorização ocorrer sempre, até 9 campos será usada a categoria '!Artigos com N campos' com N sendo o número de campos, infoboxes com 10 ou mais serão categorizadas na [[:Categoria:!Infoboxes com 10 ou mais campos]].
* <code>|contar campos=não</code> vai desativar a contagem inclusive para 0, 1 e 2 campos.
* <code>|contar campos=X a Y</code> vai fazer a categorização ocorrer no intervalo X a Y, por exemplo <code>|contar campos=0 a 5</code> vai categorizar quando o número de campos estiver entre 0 e 5. O número 10 ou qualquer número maior que 10 será considerado 10 ou mais.
* <code>|contar wikidata=sim</code> vai fazer a categorização específica para campos do Wikidata, até 9 campos será usada a categoria '!Artigos com N campos do Wikidata' com N sendo o número de campos que usam dados do Wikidata, infoboxes com 10 ou mais serão categorizadas na [[:Categoria:!Infoboxes com 10 ou mais campos do Wikidata]].
* <code>|contar wikidata=não</code> vai desativar a categorização na [[:Categoria:!Infoboxes em que todos campos são do Wikidata]]
* <code>|contar wikidata=X a Y</code> vai fazer a categorização específica para campos do Wikidata ocorrer no intervalo X a Y, por exemplo <code>|contar campos=0 a 5</code> vai categorizar quando o número de campos que usam dados do Wikidata estiver entre 0 e 5. O número 10 ou qualquer número maior que 10 será considerado 10 ou mais.

=== Extensões ===
O módulo pode ser estendido com um submódulo para adicionar funções especiais. Para usar por exemplo a extensão [[Módulo:Info/local]] use <code><nowiki>{{#invoke:Info|local</nowiki></code> em vez de usar o <code><nowiki>{{#invoke:Info|base</nowiki></code>.

Os submódulos devem retornar uma tabela, por exemplo ''ext'', na qual deve haver uma tabela ''ext.especial'' com as funções especiais, por exemplo para que o rótulo '#nome' chame a função ''ext.especial['nome']''. E se existir a função ''ext.extra'', ela será chamada após o processamento dos campos, o que for retornado será colocado após a infobox.

=== Campo debug ===
Para facilitar a identificação de erros durante o preenchimento da infobox ou erros no funcionamento do módulo, o campo 'debug' pode ser usado de diferentes formas:
{|class="wikitable"
|-
!Campo||resultado
|-
|<code><nowiki>|</nowiki> debug = vazio</code>||Exibe todos os campos que não foram preenchidos
|-
|<code><nowiki>|</nowiki> debug = campos</code>||Exibe o processamento dos campos no rodapé
|-
|<code><nowiki>|</nowiki> debug = erros</code>||Exibe erros durante o processamento no rodapé
|-
|<code><nowiki>|</nowiki> debug = wikidata</code>||Exibe processamento dos campos do Wikidata no rodapé
|}

== Ver também ==
* {{lp|Info}}
*[[Módulo:Info/wd]]
*[[Módulo:Info/local]]
*[[Módulo:Info/biografia]]
*[[Módulo:Infobox]]
*[[Módulo:Infobox/Wikidata]]
*[[Módulo:WikidataIB]]
*[[Módulo:Wikidata]]

<section begin=module_components_table />

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

}}</includeonly>