Ajuda: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
[editar | editar código-fonte]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?
[editar | editar código-fonte]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?
[editar | editar código-fonte]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
[editar | editar código-fonte]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
[editar | editar código-fonte]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
[editar | editar código-fonte]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
[editar | editar código-fonte]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
[editar | editar código-fonte]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:
Implementando
[editar | editar código-fonte]
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
[editar | editar código-fonte]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 | -> 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}}} |
Ver também
[editar | editar código-fonte]- 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
- ↑ 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