Mudanças

Ir para navegação Ir para pesquisar

Predefinição:Info/doc

18 103 bytes adicionados, 02h16min de 15 de dezembro de 2019
Criação da Documentação da Predefinição Info.
<includeonly>{{testes outro||{{Alto risco| 528000 }}}}</includeonly>
{{subpágina de documentação}}
{{Info
|cabeçalho={{{cabeçalho}}}
|título={{{título}}}
|subtítulo={{{subtítulo}}}
|subtítulo2={{{subtítulo2}}}
|imagem=Exemple.jpg
|imagem-tamanho=255px
|tópico1={{{tópico1}}}
|rótulo1={{{rótulo1}}}
|dados1={{{dados1}}}
|rodapé={{{rodapé}}}
|nome={{{nome|Predefinição:Info}}}
}}
A meta-predefinição '''Info''' é um modelo padrão utilizado para a construção de caixas de informação (''infocaixas'') temáticas. Permite a adaptação para diversos estilos e formatos. Não deve ser utilizada diretamente nos artigos.

=== Uso ===
A informação visualizada pode ser personalizada de maneira similar à {{tl|Navbox}}. Cada linha na tabela pode ser um tópico, um par rótulo/dados, ou ainda apenas uma célula de dados. Estes dados podem ser de qualquer natureza, como textos, imagens, tabelas, ou até mesmo outras predefinições. O formato básico é apresentado logo abaixo, e outros exemplos práticos são mostradas na seção correspondente.

{| style="background-color:transparent; overflow:auto;"
|- style="vertical-align:text-top;"
|Agrupados por função
<pre style="overflow:auto;">
{{Info
<!-- Identificação -->
| cabeçalho = Cabeçalho externo
| título = Título externo
| pictograma = Adiciona uma imagem ao lado do título
| tamanho-pictograma = Altera o tamanho do pictograma
| pictograma-ligação = Adiciona a ligação para o Commons do pictograma
| pictograma-legenda = Adiciona uma legenda ao pictograma
| opacidade = Opacidade do pictograma
| margem-superior = Define a distância da margem superior da posição do pictograma
| subtítulo = Subtítulo opcional
| subtítulo2 = Segundo subtítulo opcional
| imagem = Imagem principal
| imagem-tamanho = Largura da imagem
| legenda = Legenda da imagem
| imagem1 = Imagem secundária
| imagem_tamanho1 = Largura da imagem secundária
| imagem_legenda1 = Legenda da imagem secundária
| imagem2 = Imagem terciária
| imagem_tamanho2 = Largura da imagem terciária
| imagem_legenda2 = Legenda da imagem terciária
<!--- Estilos CSS --->
| classe = Classe geral da infocaixa
| estilo = Estilo geral da infocaixa
| cabeçalho-classe = Classe do cabeçalho
| cabeçalho-estilo = Estilo do cabeçalho
| título-classe = Classe do título
| título-estilo = Estilo do título
| tópico-estilo = Estilo de todos os tópicos
| rótulo-estilo = Estilo de todos os rótulos
| dados-estilo = Estilo de todos os dados
| rodapé-estilo = Estilo do rodapé
<!--- Informações --->
| tópico1 = Tópico opcional da linha 1
| rótulo1 = Rótulo opcional da linha 1
| dados1 = Informação da linha 1
| tópico2 = Tópico opcional da linha 2
| rótulo2 = Rótulo opcional da linha 2
| dados2 = Informação da linha 2
| tópico(n) = Tópico opcional da linha n
| rótulo(n) = Rótulo opcional da linha n
| dados(n) = Informação da linha n
| rodapé = Informação do rodapé
| nome = Link da barra de navegação
}}
</pre>
|&nbsp;
|Agrupados por categorias
<pre style="overflow:auto;">
{{Info

<!-- Infocaixa-->
| classe = Classe geral infocaixa
| estilo = Estilo geral infocaixa
| imagem = Imagem principal
| imagem-tamanho = Largura da imagem
| legenda = Legenda da imagem
| imagem1 = Imagem secundária
| imagem_tamanho1 = Largura da imagem secundária
| imagem_legenda1 = Legenda da imagem secundária
| imagem2 = Imagem terciária
| imagem_tamanho2 = Largura da imagem terciária
| imagem_legenda2 = Legenda da imagem terciária

<!-- Títulos -->
| cabeçalho = Cabeçalho externo
| cabeçalho-classe = Classe do cabeçalho
| cabeçalho-estilo = Estilo do cabeçalho

| título = Título externo
| título-classe = Classe do título
| título-estilo = Estilo do título
| subtítulo = Subtítulo opcional
| subtítulo2 = Segundo subtítulo opcional

<!-- Pictograma -->
| pictograma = Adiciona uma imagem ao lado do título
| tamanho-pictograma = Altera o tamanho do pictograma
| pictograma-ligação = Adiciona a ligação para o Commons do pictograma
| pictograma-legenda = Adiciona uma legenda ao pictograma
| opacidade = Opacidade do pictograma
| margem-superior = Define a distância da margem superior da posição do pictograma

<!--- Informações --->
| tópico-estilo = Estilo geral tópicos
| tópico(n) = Tópico opcional linha n
| rótulo-estilo = Estilo geral rótulos
| rótulo(n) = Rótulo opcional linha n
| dados-estilo = Estilo geral dados
| dados(n) = Informação da linha n

| rodapé-estilo = Estilo do rodapé
| rodapé = Informação do rodapé
| nome = Link de navegação

|latd = |latm = |lats = |latNS = Valores de latitude
|longd = |longm = |longs = |longEW = Valores de longitude
|coord_sufixo = Sufixo a suar na chamada de {{tl|Coor dms}}

}}</pre>
|}

==== Parâmetros imagem e imagem-tamanho ====
A imagem pode ser indicada de duas formas:
* Usando <code><nowiki>[[Ficheiro:nome do ficheiro da imagem|outros parâmetros]]</nowiki></code>. Nesta situação, imagem-tamanho é ignorado e a largura deve ser indicada em <code><nowiki>[[Ficheiro:...</nowiki></code>.
* Indicando apenas o nome do ficheiro da imagem. Neste caso, é usada imagem-tamanho caso exista (não esquecer do sufixo, tipicamente "px"). Se imagem-tamanho for omissa, é usado "200px".

=== Campos opcionais ===
Uma linha que possua um ''rótulo'' mas nenhum ''dado'' não é mostrada. Desta forma é possível a criação de infocaixas com conteúdo opcional. Para isso, utilize um parâmetro que tenha como padrão (''default'') uma sequência vazia:
<source lang=mirc>
|rótulo5 = População
|dados5 = {{{população|}}}
</source>
Desta forma, caso o editor não defina ou deixe vazio o parâmetro ''população'', a linha correspondente da infocaixa não será mostrada.

Para campos mais complexos com conteúdo pré-adicionado que deve estar presente ainda que o parâmetro não tenha sido definido, recomenda-se encapsular toda a expressão dentro de uma declaração "#if", para que todo o conjunto desapareça quando o parâmetro não tiver sido fornecido:
<source lang=mirc>
|rótulo6 = Massa
|dados6 = {{#if:{{{massa|}}} |{{{massa}}} kg|não informado}}
</source>

Este exemplo significa literalmente: ''se o parâmetro <code>massa</code> foi fornecido, mostre-o, seguido por <code>kg</code>, caso contrário, mostre o texto <code>não informado</code>.'' Mais informações sobre a declaração #if podem ser encontradas no [[mw:Help:Extension:ParserFunctions/pt-br|MediaWiki Help]] {{pt}}.

É possível tornar um ''tópico'' opcional usando o mesmo recurso. Caso seja preciso que ele apareça somente se um ou mais campos de ''dados'' forem preenchidos, pode-se utilizar o seguinte modelo como ponto de partida:
<source lang=mirc style="overflow:auto;">
{{Info
|título = Exemplo de tópico opcional
|tópico1 = {{#if:{{{item_um|}}}{{{item_dois|}}}{{{item_três|}}} |Tópico facultativo}}
|rótulo1 = Item um
|dados1 = {{{item_um|}}}
|rótulo2 = Item dois
|dados2 = {{{item_dois|}}}
|rótulo3 = Item três
|dados3 = {{{item_três|}}}
}}
</source>
O ''tópico1'' será mostrado somente se ''item_um'', ''item_dois'' ou ''item_três'' for definido. Se nenhum deles for fornecido, a tópico não será mostrado.

=== Pictograma ===
Instruções de como utilizar uma imagem como pictograma ao lado do título da infocaixa.
{| class="wikitable"
!Campo !!Descrição !!Exemplo
|-
|<pre>|pictograma=</pre> ||Nome do ficheiro do pictograma ou imagem a ser usada ||Usando a imagem [[:Ficheiro:Picto_infobox_anime_and_manga.png]]<br />
<pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|opacidade=0.7}}
</pre><br />
{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|opacidade=0.7}}
|-
|<pre>|tamanho-pictograma=</pre> ||Tamanho do pictograma, por padrão o tamanho é "33x33px" não é necessário incluir o "px" ||<pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|pictograma-ligação=</pre> ||Define se a imagem do pictograma mostra a ligação com o [[:c:Página principal|Commons]]. Se não preenchido faz a ligação com o ficheiro. ||'''Sem ligação'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|opacidade=0.7
|margem-superior=-12px}}
{{-}}
----
'''Com ligação'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|pictograma-legenda=</pre> ||Cria uma captação (texto que aparece quando se para o cursor na imagem) para a imagem. Por padrão nenhum. ||<pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|pictograma-legenda= Wikihelp Tan
|opacidade=0.7
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=
|pictograma-legenda= Wikipe Tan
|opacidade=0.7
|margem-superior=-12px}}
|-
|<pre>|opacidade=</pre> ||Opacidade da imagem. Por padrão o valor de transparência é "0.4" mas pode se adicionar valores entre 0.1 e 1, sendo 0.1 mais transparente e 1 o padrão da imagem. ||'''Com opacidade em "0.1"'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.1
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.1
|margem-superior=-12px}}
{{-}}
----
'''Com opacidade em "1"'''<br /><pre>{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=1
|margem-superior=-12px}}
</pre><br />{{Info
|título = Exemplo
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=1
|margem-superior=-12px}}
|-
|<pre>|margem-superior=</pre> ||Distância da parte superior da caixa de título, por padrão o valor é -10px. Quanto mais negativo o valor mais próximo do topo da caixa o pictograma ficará. Isso serve para quando o titulo da caixa for muito comprido alinhar a imagem do pictograma com o texto||'''Com margem superior em "-30px"'''<br /><pre>{{Info
|título = Exemplo se este texto ficar muito comprido como no do artigo Sukhoi PAK FA
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.3
|margem-superior=-30px}}
</pre><br />{{Info
|título = Exemplo se este texto ficar muito comprido como no do artigo [[Sukhoi PAK FA]]
|pictograma = Picto_infobox_anime_and_manga.png
|tamanho-pictograma= 43x43
|pictograma-ligação=1
|pictograma-legenda= Wikipe Tan
|opacidade=0.6
|margem-superior=-30px}}
|}

=== Organização ===
Recomenda-se que as caixas de informação construídas a partir da metapredefinição {{tl|Info}} utilizem o sistema de subpáginas. Assim, são agrupadas por temas ou áreas do conhecimento, de maneira hierarquica, todas as caixas de informação relacionadas entre si:<br><br>
{{chart/start|style=background-color:transparent;}}
{{chart| |INFO |-|v|-|GRUPO|-|-|-|ITEM | | |INFO='''{{tl|Info}}'''<br><small>&nbsp;Meta-predefinição&nbsp;</small>
|GRUPO=&nbsp;{{tld|Info/'''[[:Categoria:!Predefinições por tema|tema]]'''}}&nbsp;<br><small>Predefinição geral</small>
|ITEM={{tld|Info/tema/'''[[Ojeto|item]]'''}}<br><small>Predefinição específica</small>}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart| | | | | |)|-|GRUP1|-|v|-|ITEM1| | |GRUP1={{tld|Info/tema'''''A'''''}}
|ITEM1=&nbsp;{{tld|Info/tema'''''A'''''/item'''''1'''''}}&nbsp;}}
{{chart| | | | | |!| | | | | |!| | | | | | }}
{{chart| | | | | |!| | | | | |)|-|ITEM2| | |ITEM2={{tld|Info/tema'''''A'''''/item'''''2'''''}}}}
{{chart| | | | | |!| | | | | |!| | | | | | }}
{{chart|boxstyle=border-style: dotted;| | | | | |!| | | | | |L|~|ITEM3| | |ITEM3={{tld|Info/tema'''''A'''''/item'''''N'''''}}}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart| | | | | |)|-|GRUP2|-|V| | | | | | |GRUP2={{tld|Info/tema'''''B'''''}}}}
{{chart| | | | | |!| | | | | | | | | | | | }}
{{chart|boxstyle=border-style: dotted;| | | | | |D|~|GRUP3| | | | | | | | |GRUP3={{tld|Info/tema'''''X'''''}}}}
{{chart| | | | | | | | | | | | | | | | | | }}
{{chart/end}}
Esta abordagem, além de promover a uniformidade da nomenclatura das predefinições, facilita a navegação e a consulta, por parte do editor, de todas as caixas de informação disponíveis sobre um determinado assunto.

=== Exemplos ===
{{Info
| estilo = width: 18em;
| cabeçalho = Cabeçalho (externo)
| título = Título (interno)
| imagem = example.png
| imagem-tamanho = 50px
| legenda = ''Legenda da imagem''
| tópico-estilo = background-color:#F4BF92;
| dados1 = ''Texto sem rótulo e sem tópico''
| tópico2 = Tópico definido
| dados2 = ''Texto sem rótulo''
| tópico3 = Tópico definido
| rótulo3 = '''Rótulo definido'''
| dados3 = ''Texto com rótulo''
| rodapé = Informação mostrada no rodapé
}}
<pre style="overflow:auto;">
{{Info
| estilo = width: 18em;
| cabeçalho = Cabeçalho (externo)
| título = Título (interno)
| imagem = example.png
| imagem-tamanho = 50px
| legenda = ''Legenda da imagem''
| tópico-estilo = background-color:#F4BF92;
| dados1 = ''Texto sem rótulo e sem tópico''
| tópico2 = Tópico definido
| dados2 = ''Texto sem rótulo''
| tópico3 = Tópico definido
| rótulo3 = '''Rótulo definido'''
| dados3 = ''Texto com rótulo''
| rodapé = Informação mostrada no rodapé
}}
</pre>

== Sintaxe ==
{| class="sortable wikitable" style="margin:auto"
! parâmetro
! opcional
! descrição
|-
| '''classe'''
| {{tab-sim}}
| Tem infobox_v2 por valor padrão.
|-
| '''espaço_entre_células'''
| {{tab-sim}}
| Obsoleto (corresponde ao antigo atributo "cellspacing" que é inválido em [[HTML5]])
|-
| '''espaço_conteúdo-borda_das_células'''
| {{tab-sim}}
| Obsoleto (corresponde ao antigo atributo "cellpadding" que é inválido em HTML5)
|-
| '''largura-borda'''
| {{tab-sim}}
|
|-
| '''estilo'''
| {{tab-sim}}
| Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em [[b:Edição de tabelas wiki]].
|-
| '''largura'''
| {{tab-sim}}
|
|-
| '''cabeçalho'''
| {{tab-sim}}
|
|-
| '''cabeçalho-classe'''
| {{tab-sim}}
|
|-
| '''cabeçalho-estilo'''
| {{tab-sim}}
| Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em [[b:Edição de tabelas wiki]].
|-
| '''título'''
| {{tab-sim}}
|
|-
| '''título-classe'''
| {{tab-sim}}
| Ver as opções disponíveis para o campo em {{tl|Info/topo}}.
|-
| '''título-estilo'''
| {{tab-sim}}
|
|-
| '''hCard'''
| {{tab-sim}}
|
|-
| '''subtítulo'''
| {{tab-sim}}
|
|-
| '''subtítulo-estilo'''
| {{tab-sim}}
|
|-
| '''ocultarsubtítulo'''
| {{tab-sim}}
|
|-
| '''subtítulo-classe'''
| {{tab-sim}}
|
|-
| '''subtítulo2'''
| {{tab-sim}}
|
|-
| '''subtítulo2-estilo'''
| {{tab-sim}}
|
|-
| '''ocultarsubtítulo2'''
| {{tab-sim}}
|
|-
| '''subtítulo2-classe'''
| {{tab-sim}}
|
|-
| '''imagem'''
| {{tab-sim}}
|
|-
| '''imagem-estilo'''
| {{tab-sim}}
|
|-
| '''imagem-tamanho'''
| {{tab-sim}}
|
|-
| '''legenda'''
| {{tab-sim}}
|
|-
| '''legenda-estilo'''
| {{tab-sim}}
|
|-
| '''tópico-estilo'''
| {{tab-sim}}
|
|-
| '''rótulo-estilo'''
| {{tab-sim}}
|
|-
| '''dados-estilo'''
| {{tab-sim}}
|
|-
| '''classe-linhaX'''
| {{tab-sim}}
|
|-
| '''ocultarX'''
| {{tab-sim}}
|
|-
| '''tópicoX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''tópicoX-estilo'''
| {{tab-sim}}
|
|-
| '''dadosX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''dadosX-estilo'''
| {{tab-sim}}
|
|-
| '''rótuloX'''
| {{tab-sim}}
| X pode ser preenchido com um número até 229.
|-
| '''rótuloX-estilo'''
| {{tab-sim}}
|
|-
| '''rodapé'''
| {{tab-sim}}
|
|-
| '''rodapé-estilo'''
| {{tab-sim}}
|
|-
| '''nome'''
| {{tab-sim}}
|
|-
| '''nome-estilo'''
| {{tab-sim}}
|
|-
| '''noedit'''
| {{tab-sim}}
|
|-
| '''latd''', '''latm''', '''lats''', '''latNS''', '''longd''', '''longm''', '''longs''', '''longEW''' e '''coord_sufixo'''
| {{tab-sim}}
| Coloca as coordenadas no canto superior direito da página com {{tl|Coor dms}}; o coord_sufixo determina o sufixo enviado para aquela predef; se for omitido é usado type:landmark. Se latd não for indicado, todos os outros são ignorados.
|-
|}

<includeonly>
{{testes outro||
[[Categoria:!Predefinições para caixas de informação| ]]
}}
</includeonly>

Menu de navegação