Predefinição:Info/doc

{{{cabeçalho}}}

{{{título}}}
{{{subtítulo}}}
{{{subtítulo2}}}
Predefinição:Info
{{{tópico1}}}
{{{rótulo1}}}	{{{dados1}}}
{{{rodapé}}}

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 à {{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.

Agrupados por função {{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 }}

Agrupados por categorias {{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}} }}

Parâmetros imagem e imagem-tamanho

A imagem pode ser indicada de duas formas:

• Usando [[Ficheiro:nome do ficheiro da imagem|outros parâmetros]]. Nesta situação, imagem-tamanho é ignorado e a largura deve ser indicada em [[Ficheiro:....
• 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:

|rótulo5 = População
|dados5  = {{{população|}}}

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:

|rótulo6 = Massa
|dados6  = {{#if:{{{massa|}}} |{{{massa}}} kg|não informado}}

Este exemplo significa literalmente: se o parâmetro massa foi fornecido, mostre-o, seguido por kg, caso contrário, mostre o texto não informado. Mais informações sobre a declaração #if podem ser encontradas no MediaWiki Help (em português).

É 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:

{{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|}}}
}}

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.

Campo	Descrição	Exemplo
|pictograma=	Nome do ficheiro do pictograma ou imagem a ser usada	Usando a imagem Ficheiro:Picto_infobox_anime_and_manga.png {{Info |título = Exemplo |pictograma = Picto_infobox_anime_and_manga.png |opacidade=0.7}} Exemplo
|tamanho-pictograma=	Tamanho do pictograma, por padrão o tamanho é "33x33px" não é necessário incluir o "px"	{{Info |título = Exemplo |pictograma = Picto_infobox_anime_and_manga.png |tamanho-pictograma= 43x43 |opacidade=0.7 |margem-superior=-12px}} Exemplo
|pictograma-ligação=	Define se a imagem do pictograma mostra a ligação com o Commons. Se não preenchido faz a ligação com o ficheiro.	Sem ligação {{Info |título = Exemplo |pictograma = Picto_infobox_anime_and_manga.png |tamanho-pictograma= 43x43 |pictograma-ligação=1 |opacidade=0.7 |margem-superior=-12px}} Exemplo Com ligação {{Info |título = Exemplo |pictograma = Picto_infobox_anime_and_manga.png |tamanho-pictograma= 43x43 |pictograma-ligação= |opacidade=0.7 |margem-superior=-12px}} Exemplo
|pictograma-legenda=	Cria uma captação (texto que aparece quando se para o cursor na imagem) para a imagem. Por padrão nenhum.	{{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}} Exemplo
|opacidade=	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" {{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}} Exemplo Com opacidade em "1" {{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}} Exemplo
|margem-superior=	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" {{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}} Exemplo se este texto ficar muito comprido como no do artigo Sukhoi PAK FA

Organização

Recomenda-se que as caixas de informação construídas a partir da metapredefinição {{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:

{{Info}}  Meta-predefinição

{{Info/tema}}  Predefinição geral

{{Info/tema/item}} Predefinição específica

{{Info/temaA}}

{{Info/temaA/item1}}

{{Info/temaA/item2}}

{{Info/temaA/itemN}}

{{Info/temaB}}

{{Info/temaX}}

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

Cabeçalho (externo)

Título (interno)
Info/doc Legenda da imagem
Texto sem rótulo e sem tópico
Tópico definido
Texto sem rótulo
Tópico definido
Rótulo definido	Texto com rótulo
Informação mostrada no rodapé

{{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é
}}

Sintaxe

parâmetro	opcional	descrição
classe	Sim	Tem infobox_v2 por valor padrão.
espaço_entre_células	Sim	Obsoleto (corresponde ao antigo atributo "cellspacing" que é inválido em HTML5)
espaço_conteúdo-borda_das_células	Sim	Obsoleto (corresponde ao antigo atributo "cellpadding" que é inválido em HTML5)
largura-borda	Sim
estilo	Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
largura	Sim
cabeçalho	Sim
cabeçalho-classe	Sim
cabeçalho-estilo	Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
título	Sim
título-classe	Sim	Ver as opções disponíveis para o campo em {{Info/topo}}.
título-estilo	Sim
hCard	Sim
subtítulo	Sim
subtítulo-estilo	Sim
ocultarsubtítulo	Sim
subtítulo-classe	Sim
subtítulo2	Sim
subtítulo2-estilo	Sim
ocultarsubtítulo2	Sim
subtítulo2-classe	Sim
imagem	Sim
imagem-estilo	Sim
imagem-tamanho	Sim
legenda	Sim
legenda-estilo	Sim
tópico-estilo	Sim
rótulo-estilo	Sim
dados-estilo	Sim
classe-linhaX	Sim
ocultarX	Sim
tópicoX	Sim	X pode ser preenchido com um número até 229.
tópicoX-estilo	Sim
dadosX	Sim	X pode ser preenchido com um número até 229.
dadosX-estilo	Sim
rótuloX	Sim	X pode ser preenchido com um número até 229.
rótuloX-estilo	Sim
rodapé	Sim
rodapé-estilo	Sim
nome	Sim
nome-estilo	Sim
noedit	Sim
latd, latm, lats, latNS, longd, longm, longs, longEW e coord_sufixo	Sim	Coloca as coordenadas no canto superior direito da página com {{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.