Ajuda:Infocaixa

WP:INFOCAIXA

Uma caixa de informação ou infocaixa (em inglês: infobox) é uma predefinição MediaWiki de uma tabela com formato fixo colocada no canto superior direito do artigo e, visa apresentar um resumo com aspectos relevantes e comuns (fatos e estatísticas) sobre o tema, facilitando a consulta de artigos relacionados. O aspecto geral de uma infocaixa é baseada na taxocaixa (caixa de informação taxonômica) que os editores desenvolveram para expressar visualmente classificações científicas dos organismos.

O uso de infocaixas não é obrigatório e nem proibido em qualquer artigo. Quando utilizá-las, qual a ser utilizada e quais seções são incluídas, são determinadas através da discussão e consenso entre os editores do artigo.

Objetivo

As predefinições de caixas de informação contêm fatos e estatísticas comuns ao artigo. Por exemplo: todos os animais possuem uma classificação científica (espécie, família, etc), também estado de conservação (risco de extinção). Adicionando uma {{taxocaixa}} ao artigo torna-se fácil encontrar tais informações e compará-las com outros artigos.

Infocaixas são como fichas ou barras laterais em artigos de revista. Elas rapidamente mostram pontos importantes em um formato fácil de ler. Entretanto, elas não são tabelas "estatísticas", devem somente resumir informações que estão presentes no texto principal porque pode não ser possível para muitos leitores visualizar a infocaixa. Particularmente, as infocaixas podem ocultar longas colunas inseridas em tabelas expansíveis, o que significa que leitores usando tecnologias assistivas podem perder totalmente sua funcionalidade.

O que deve haver na infocaixa?

Atalho

WP:SIMINFO

Em geral, a informação contida em uma infocaixa deve ser:

Comparável. Se diversos assuntos diferentes compartilham um atributo em comum (por exemplo, pessoas com nome e data de aniversário), então é útil compará-las em diferentes páginas. Isto significa que sempre que possível o material deve ser apresentado em um formato padrão.
Concisa. Infocaixas devem ser uma ferramenta para rapidamente consultar fatos ou informações. Longos textos ou estatísticas muito detalhadas devem fazer parte do texto do artigo.
Relevantes para o artigo. Um problema comum é a inclusão de material irrelevante que de outra forma não seria incluído no corpo do artigo: por exemplo, tipo sanguíneo de um personagem fictício pode ser referenciado em uma biografia, mas não é especialmente útil para entender o artigo. Infocaixas não devem ser usadas para detalhar informações triviais que de outra forma seriam removidas do artigo. Além disso, como dito acima, alguns usuários podem não ter acesso ao conteúdo da infocaixa e portanto não terão acesso a essas informações.
Citadas em algum lugar no corpo do artigo. As infocaixas, assim como a introdução do artigo, devem conter uma visão geral do artigo que é ampliada e apoiada pelas fontes confiáveis no corpo do artigo. No entanto, se necessário (por exemplo, quando o artigo está incompleto), é adequado incluir referências nas infocaixas.

O que não deve haver na infocaixa?

Atalhos

De um modo geral, as informações na infocaixa não devem ser ou conter:

Extensas. Devem ser evitados textos extensos ou com muitos detalhes, que devem pertencer ao corpo do artigo. Não utilize vírgulas para separar itens numa lista: prefira quebrar a linha, utilizando <br> ou {{Lista sem marcas}} para listas curtas, e {{Lista minimizável}} para listas extensas.^[1] Os itens devem ser grafados com inicial minúscula, quando forem substantivos comuns, mesmo sendo os primeiros da lista. Iniciais maiúsculas devem ser usadas apenas para substantivos próprios.^[2]
Detalhes triviais. Um problema comum é incluir material na infocaixa, que é trivial e que eventualmente não seria incluído no corpo do artigo: por exemplo, o tipo de sangue de um personagem fictício é um detalhe que pode ser referenciado de passagem em uma obra, mas não é particularmente útil para a compreesão do assunto. As infocaixas não devem conter detalhes que são muito triviais para incluir no corpo do artigo (existem algumas exceções, como propriedades químicas, por exemplo).
Bandeiras. Ícones de bandeiras em geral não devem ser usados nas infocaixas de biografias, mesmo para um país, nacionalidade ou campo equivalente,^[3] bem como nas infocaixas de times e clubes desportivos.^[4] Para outros casos de uso de ícones em infocaixas, ver Livro de estilo/Ícones.

Encontrar uma infocaixa apropriada

Infocaixas são extensões dos recursos de predefinições MediaWiki e como tal suas implementações são mantidas em predefinições. Há duas maneiras para os editores normalmente terem acesso aos detalhes subjacentes de uma infocaixa:

Mais comumente, o editor busca uma infocaixa em um artigo com um tema relacionado ao artigo ao qual deseja editar.
Alternativamente, o editor pode procurar no conjunto de todas as infocaixas através da categoria que reúne todas elas, cuja árvore está posta abaixo.

Obs.: o trecho seguinte está "compactado" de modo a despoluir visualmente o contexto da página toda.

Criar uma nova infocaixa

Você deve primeiro procurar uma infocaixa já existente que se encaixe na sua necessidade seguindo os passos da seção anterior. Caso não encontre, mesmo consultando outros editores e possíveis WikiProjetos interessados, preferencialmente você deve testar sua criação em Wikipédia:Página de testes. Como padronização, as infocaixas devem ser construídas com a predefinição {{Info}}.

Prototipar uma infocaixa

Infocaixas podem ser rapidamente prototipadas dentro de sua própria página de usuário. Por exemplo, para criar uma infocaixa chamada Infocaixa meu assunto, o editor deve simplesmente começar um artigo em sua página de usuário: Especial:Minha página/Info/meu assunto. Os passos gerais de prototipagem são:

Determinar a abordagem geral da implementação
Projetar a infocaixa
Aplicar a infocaixa
Documentar, para outros editores, como usar a infocaixa
Categorizar a infocaixa para torná-la mais facilmente disponível a outros editores
Testar a infocaixa

Determinando a abordagem geral

Existem três técnicas para se prototipar uma infocaixa:

Use uma tabela para elaborar uma "info caixa estática", convertendo para predefinição depois de atingir o objetivo final.
Use Wikipédia:Predefinições e Ajuda:Predefinições.
Use {{Info}} para prototipar a infocaixa. Este é o método mais fácil e portanto o mais recomendado. O restante desta seção considera que o editor tenha escolhido esta última opção.

Projetando

Os editores geralmente compõem infocaixas a partir de quatro tipos de elementos visuais: título, imagens, seções e campos. Como esses termos não são padrão, nós os ilustramos aqui:

Título
Legenda da imagem
Seção_A
NomeDoCampo_A1	ParâmetroDoCampo_A1
NomeDoCampo_A2	ParâmetroDoCampo_A2
NomeDoCampo_A3	ParâmetroDoCampo_A3
Seção_B
NomeDoCampo_B1	ParâmetroDoCampo_B1
NomeDoCampo_B2	ParâmetroDoCampo_B2

Implementando

Depois que um editor decide o título, a imagem e a organização das seções e dos campos, deve mapear esses elementos visuais de acordo com o modelo de caixa de informações documentados na predefinição{{info/doc#Sintaxe}}. Embora existam muitas informações/parâmetros diferentes de acordo com o tema, os mais utilizados são:

{{Info
| cabeçalho          = Cabeçalho externo
| título             = Título externo
| margem-superior    = Define a distância da margem superior da posição do pictograma
| subtítulo          = Subtítulo opcional
| imagem             = Imagem principal
| imagem-tamanho     = Largura da imagem
| legenda            = Legenda da imagem 
| 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é
| 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 
}}

O mapeamento dos elementos visuais/parâmetros de uma infobox é simples:

parâmetro	opcional	descrição
style="background: #ddffdd" class="table-yes" \|Sim	Tem infobox_v2 por valor padrão.
style="background: #ddffdd" class="table-yes" \|Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	Ver as opções disponíveis para o campo em {{Info/topo}}.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim

Exibindo dados do Wikidata

Para adicionar uma propriedade específica proveniente do Wikidata, a maneira mais simples é utilizando a função (parser function) #property: - modo de uso:{{#property:<nome ou número da propriedade>}}. Por exemplo, para exibir uma imagem adicionada no Wikidata referente ao artigo, adicione na predefinição da infocaixa o código a seguir:

| imagem = {{#property:imagem}}

Pode-se usar a #property junto com a função #if para estabelecer prioridade entre o valor Wikidata e o valor preenchido localmente na infocaixa. Por exemplo, o código a seguir somente exibirá um valor do Wikidata quando o parâmetro código_língua não for digitado pelo editor ao adicionar a infocaixa no artigo:

{{#if:{{{código_língua|}}}|{{{código_língua}}}|{{#property:P424}}}}

ou

{{{código_língua|{{#property:P424}}}}}

É possível exibir a #property somente se ela estiver presente no Wikidata com a função #ifexist:

Por exemplo, para exibir a categorial principal da Wikipédia do artigo misturador (Q654117):

{{#ifexist:{{#property:P910}}|{{#property:P910}}}}

Para exibir a mesma propriedade com link, use o código abaixo:

{{#ifexist:{{#property:P910}}|[[:{{#property:P910}}|Categoria principal]]}}

Podemos também usar o módulo WikidataIB, usando o #invoke:WikidataIB como por exemplo, para exibir o nome dos criadores (property:P170) da pintura Corisca e Sátiro (qid:Q29016906):

{{#invoke:WikidataIB |getValue |P170 |fetchwikidata=ALL |qid=Q29016906 |onlysourced=no}} -> Artemisia Gentileschi, Diana Rosa, Massimo Stanzione

O exemplo anterior, agora usandoWikidataIB com #ifexist: . Obs: no exemplo abaixo o qid não é obrigatório, ele irá automaticamente no Wikidata busca o elemento relacionado ao artigo onde a infocaixa foi adicionada...

{{#ifexist:{{#property:P170|}} |{{#invoke:WikidataIB |getPreferredValue |P170 |name=criador |qid={{{qid|}}} |sep="<br>" |sorted=yes |fetchwikidata={{{buscarwikidata|ALL}}} |onlysourced={{{só_referenciados|no}}}}}}}

Ver também

Ajuda:ParserFunctions - códigos avançados para utilizar em certas predefinições
Ajuda:Palavras mágicas
Categoria:!Predefinições de caixas de informação
Wikipédia:Como ler uma caixa taxonómica
Wikipédia:Informação nas infocaixas de química
Wikipédia:Lua - guia da linguagem de programação de script para uso na Wikipédia
Wikipédia:Projetos/Padronização/Infocaixas
Predefinição:Info
Módulo:Info
Inclusion syntax v0.3

Referências

↑ Decidido em consenso na discussão Separação de informação.
↑ Decidido em consenso na discussão Maiúscula ou minúscula nos campos das infocaixas em geral?.
↑ Decidido em consenso na discussão Uso de predefinições de bandeiras nas infocaixas de biografias
↑ Decidido em consenso na discussão Eliminar as bandeirinhas nas info caixas de times e clubes desportivos

[1] Decidido em consenso na discussão Separação de informação.

[2] Decidido em consenso na discussão Maiúscula ou minúscula nos campos das infocaixas em geral?.

[3] Decidido em consenso na discussão Uso de predefinições de bandeiras nas infocaixas de biografias

[4] Decidido em consenso na discussão Eliminar as bandeirinhas nas info caixas de times e clubes desportivos

[1]

[2]

[3]

[4]

parâmetro	opcional	descrição
style="background: #ddffdd" class="table-yes" \|Sim	Tem infobox_v2 por valor padrão.
style="background: #ddffdd" class="table-yes" \|Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	Pode ser preenchido com estilo CSS. É possível aplicar parte do que consta em b:Edição de tabelas wiki.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	Ver as opções disponíveis para o campo em {{Info/topo}}.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim	X pode ser preenchido com um número até 229.
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim
style="background: #ddffdd" class="table-yes" \|Sim