Ajuda:Infocaixa: diferenças entre revisões
Conteúdo apagado Conteúdo adicionado
bot: revertidas edições de Leite54 ( modificação suspeita : -59), para a edição 29753190 de MerlIwBot |
|||
Linha 1:
{{em tradução|:en:Help:Infobox}}
Uma '''caixa de informação''' ou '''infocaixa''' ({{lang-en|''infobox''}}) é um uma tabela de formato fixo colocada no canto superior direito do artigo e visa apresentar um resumo com aspectos relevantes e facilitar a consulta de outros artigos relacionados. O aspecto geral de uma infocaixa é baseada nas [[Wikipedia:Como ler uma caixa taxonómica|taxocaixa]] (caixa de informação taxonômica) que os editores desenvolveram para expressar visualmente classificações científicas dos organismos.
== O que as infocaixas fazem? ==
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 {{tl|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. Eles rapidamente mostram porntos importantes em um formato fácil de ler. Entretanto, eles ''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 [[Leitor de tela|tecnologias assistivas]] podem perder totalmente sua funcionalidade.
== O que deve haver na infocaixa? ==
Em geral, as informações contidas em uma infocaixa podem 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 sgnifica 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. 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 seria 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.
==Encontrando uma infocaixa apropriada==
Infocaixas são extensões do recursos de [[Wikipedia:Lista de predefinições|predefinições]] [[MediaWiki]] e como tal suas implementações são mantida em [[Wikipedia:Predefinições|predefinições]]. Há duas maneiras que os editores normalmente querem ter acesso aos detalhes subjacentes de uma infocaixa:
* Primeiro, os editores podem procurar o conjunto de todos os painéis, através da [[:Categoria:!Predefinições por tema]].
* Segundo (e mais comumente), quando um editor é inspirado por uma infocaixa em um artigo específico, ele ou ela pode mapear a infocaixa para o seu modelo de implementação no nome da Predefinição.
==Redesenhando uma infocaixas existente==
É prudente procurar a opinião de outros editores antes de iniciar a reformulação de uma infocaixa. Se suas idéias forem bem recebidas, comece prototipando seu novo estilo (veja [[#Prototipando uma infocaixa]], abaixo).
Uma vez prototipada, proponha as mudanças no [[Wikipedia:WikiProjetos|WikiProjetos]] e ganhe o [[Wikipedia:Consenso]] antes de implementar seu novo estilo.
==Criando uma nova infocaixa==
Você deve primeiro procurar uma infocaixa que se encaixe na sua necessidade examinando a categoria [[:Categoria:!Predefinições por tema|!Predefinições por tema]] ou buscando artigos que poderiam possuir tal infocaxa. Primeiramente você deve prototipá-la em sua página de usuário e procurar quais [[Wikipedia:WikiProjetos|WikiProjetos]] talvez se interessem por ela.
==Prototipando uma infocaixa==
Infocaixas podem ser rapidamente prototipadas dentro de sua própria [[Wikipedia:Página de usuário|página de usuário]]. Por exemplo, para criar uma infocaixa chamada <code>Infocaixa meu assunto</code>, o editor deve simplesmente começar um artigo de sua própria página de usuário: [[Special: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
<!-- Até ser criado o artigo...
{{The Infoboxwatch}}
Por exemplo, o artigo [[D-Terminal]] contains an infobox. Simply edit the article to determine which one:
<pre>
{{ infobox connector
...
}}
</pre>
The start of the template identifies the markup between the enclosing braces as an infobox instance. While the next word identifies the specific kind of infobox (in this case the "<code>Connector</code>" infobox), the underlying template is still located in the Template namespace under {{tl|infobox Connector}}. Note that MediaWiki properly handles differences in capitalization so that {{tl|infobox connector}} maps to the appropriate template as well.
-->
<!--Criar página..
Infoboxes prototipadas devem ser colocadas Prototyped infoboxes should be placed on the [[Wikipedia:List of infoboxes/Proposed]] sub-page when proposed and added to the appropriate sub-category when implemented.
-->
<!--
===Determinando a abordagem geral===
There are three techniques with which to construct a prototype:
#Use a [[Help:Table|table]] to construct a "static infobox", converting to a template after the editor arrives at a "final" design. See also [[Wikipedia:Thinking outside the infobox]].
#Use the MediaWiki [[m:Help:Template|template]] feature to construct the prototype using the documentation at [[mw:Help:Templates]]. While this provides the most flexibility, it is by far the most challenging approach (and is beyond the scope of this article)
#Use {{tl|infobox}} to construct the prototype. This method is the easiest and hence '''strongly recommended'''. The rest of this section assumes the designing editor chooses this approach.
===Designing===
Editors generally compose infoboxes from four types of visual elements: A title, images, sections, and fields. Since these terms are not standard, we illustrate them here:
{| class="wikitable"
! colspan="2" style="background:lightblue;width:200px;font-size:10pt" | Title
|-
| colspan="2" style="text-align:center;font-size:7pt" | [[Image:Tlaloc, Codex Rios, p.20r.JPG|noframe|200px]]<br />Image caption
|-
| colspan="2" style="background:lightblue;text-align:center;font-size:9pt" | Section<sub>A</sub>
|-
| style="font-size:9pt" | FieldName<sub>A1</sub> || style="font-size:9pt" | FieldParameter<sub>A1</sub>
|-
| style="font-size:9pt" | FieldName<sub>A2</sub> || style="font-size:9pt" | FieldParameter<sub>A2</sub>
|-
| style="font-size:9pt" | FieldName<sub>A3</sub> || style="font-size:9pt" | FieldParameter<sub>A3</sub>
|-
| colspan="2" style="background:lightblue;text-align:center;font-size:9pt" | Section<sub>B</sub>
|-
| style="font-size:9pt" | FieldName<sub>B1</sub> || style="font-size:9pt" | FieldParameter<sub>B1</sub>
|-
| style="font-size:9pt" | FieldName<sub>B2</sub> || style="font-size:9pt" | FieldParameter<sub>B2</sub>
|}
The selection and arrangement of fields is an important design decision for which [[Wikipedia:Manual of Style (infoboxes)]] gives some general advice. The part of a field that varies from article to article becomes a parameter for the newly-prototyped infobox and must be consistently expressed in two distinct places:
#In the infobox implementation itself, to indicate where the article-specific text is to be displayed
#In the infobox documentation, to indicate which article-specific information editors are to provide when using the infobox
Additionally, the editor should decide whether a field (and hence its corresponding parameter) is required or optional. The difference between the two is that a required field is always displayed; an optional field is '''not''' displayed where articles referencing the infobox omit the parameter. If the field is required, the infobox designer should consider whether a default value for the field is useful.
===Implementing===
Once an editor has decided upon the title, image, and arrangement of sections and fields, he or she is ready to map those visual elements onto the parameters of the infobox template. {{tl|infobox}} documents how to use this template. While there many different infobox parameters, the most frequently used are:
<pre>
{{ infobox
| abovestyle =
| above =
| image =
| caption =
| headerstyle =
| header1 =
| label1 =
| data1 =
| header2 =
| label2 =
| data2 =
...
| header20 =
| label20 =
| data20 =
}}
</pre>
The mapping of visual elements onto infobox parameters is straightforward:
{| class="wikitable"
! Visual element !! How to implement !! Parameters to implement !! Notes
|-
| Colored title and section bars || <code><nowiki>|abovestyle = </nowiki>background:<I>[[Web colors|color]]</I>;</code><br /><code><nowiki>|headerstyle = </nowiki>background:<I>[[Web colors|color]]</I>;</code> || None || See http://www.w3.org/TR/CSS2/propidx.html for styles other than <code>background</code>
|-
| Title || <code><nowiki>|above = {{{name|<includeonly>{{PAGENAME}}</includeonly>}}}</nowiki></code> || <code><nowiki>{{{name}}}</nowiki></code> ||
|-
| Image || <code><nowiki>|image = {{#if:{{{image|}}}|[[Image:{{{image}}}|22</nowiki>[[Em (typography)|em]]<nowiki>]]}}</nowiki></code><br /><code><nowiki>|caption = {{{caption|}}}</nowiki></code> || <code><nowiki>{{{image}}}</nowiki></code>, <code><nowiki>{{{caption}}}</nowiki></code> || Images must be specified using the [[Wikipedia:Extended image syntax]]
|-
| Section || <code><nowiki>|header</nowiki><sub>n</sub> = <I>Fixed section name</I></code> || None ||
|-
| Required field with no default value || <code><nowiki>|label</nowiki><sub>n</sub> = <I>Fixed field name</I></code><br /><code><nowiki>|data</nowiki><sub>n</sub> = <nowiki>{{{</nowiki><I>Parameter name</I><nowiki>}}}</nowiki></code> || <code><nowiki>{{{</nowiki><I>Parameter name</I><nowiki>}}}</nowiki></code> || Note that parameters are enclosed in triple braces <code><nowiki>{{{...}}}</nowiki></code>
|-
| Optional field || <code><nowiki>|label</nowiki><sub>n</sub> = <I>Fixed field name</I></code><br /><code><nowiki>|data</nowiki><sub>n</sub> = <nowiki>{{{</nowiki><I>Parameter name</I><nowiki>|}}}</nowiki></code> || <code><nowiki>{{{</nowiki><I>Parameter name</I><nowiki>}}}</nowiki></code> || Use | to specify an empty string as the default (<code><nowiki>{{{...|}}}</nowiki></code>)
|-
| Required field with a default value || <code><nowiki>|label</nowiki><sub>n</sub> = <I>Fixed field name</I></code><br /><code><nowiki>|data</nowiki><sub>n</sub> = <nowiki>{{{</nowiki><I>Parameter name</I><nowiki>|</nowiki><I>default-value</I><nowiki>}}}</nowiki></code> || <code><nowiki>{{{</nowiki><I>Parameter name</I><nowiki>}}}</nowiki></code> ||
|-
| Field conditionally displayed || <code><nowiki>|label</nowiki><sub>n</sub> = <I>Fixed field name</I></code><br /><code><nowiki>|data</nowiki><sub>n</sub> = <nowiki>{{#if:{{{</nowiki><I>Parameter name<sub>if specified</sub></I><nowiki>|}}}|{{{</nowiki><I>Parameter name<sub>then display this</sub></I><nowiki>|}}} }}</nowiki></code> || <code><nowiki>{{{</nowiki><I>Parameter name<sub>if specified</sub></I><nowiki>}}}</nowiki></code>,<br /><code><nowiki>{{{</nowiki><I>Parameter name<sub>then display this</sub></I><nowiki>}}}</nowiki></code> || General form is <code><nowiki>{{#if:</nowiki><I>test<I><nowiki>|</nowiki><I>then-text</I><nowiki>|</nowiki><I>else-text</I><nowiki>}}}</nowiki></code>
|}
When making style decisions, editors should follow the [[Wikipedia:Manual of Style (infoboxes)]] as closely as possible. Images must be specified using the [[Wikipedia:Extended image syntax]]. When specifying styles (e.g., for <code>abovestyle</code>, <code>bodystyle</code>, and <code>headerstyle</code>), http://www.w3.org/TR/CSS2/propidx.html is an excellent reference.
The vast majority of editors use only the simple features of infobox in the ways described above. However, the more intrepid editor should be aware of the more esoteric features of {{tl|infobox}}:
* Displaying the title outside the infobox (as opposed to inside the infobox)
* Displaying extra text below the title or at the bottom of the infobox (for "see also", footnotes, wikilink to "list of" article, etc.)
* Displaying a second image
* Displaying images anywhere other than the top of the infobox
* Mapping individual fields onto an appropriate [[microformat]] (See also [[Wikipedia:WikiProject Microformats]])
* Displaying the "view/edit/discuss" navigation bar for the infobox
Again, these features are documented in {{tl|info}}.
===Documenting===
The goal of documenting the newly-created infobox is to allow other editors to quickly ascertain what information they need to provide when incorporating the infobox into articles. The convention is to keep documentation in a page separate from the infobox implementation and arrange for the implementation to transclude the documentation when the infobox is displayed directly, but not when the infobox is displayed in an article.
* First, ensure {{tl|Documentation}} is appended to the template, enclosed in <code><noinclude></code> elements.<SUP>(See also [[#A skeleton infobox|below]])</SUP> Ensure there are no stray spaces between the end of template (<code>}}</code>) and <code><noinclude></code> as these, if present, will be transcluded into every article that uses the template.
<pre>
{{ infobox
...
}}<noinclude>{{documentation}}--><!-- Please add category and language links to the bottom of the /doc sub-page, not here --><!--</noinclude>
</pre>
* Next, create the documentation page as a subpage from the infobox template itself (e.g., [[Special:Mypage/Infobox mysubject/doc]]). The easiest way to do this is by following the <code>[create]</code> link from the empty {{tl|documentation}} transclusion. This will preload a skeleton documentation page which can be filled in with basic usage, links to similar templates, interwiki links, and category links (at the bottom, in the <code><nowiki><noinclude></noinclude></nowiki></code> section).
* Finally, organize the documentation into the following sections:
:* Overview
:* Parameters (their meanings and whether they are optional, have a default value, or are conditionally displayed)
:* Blank template (suitable for copy-n-pasting into articles)
:* Examples (e.g., to show the effects of conditionally-displayed parameters)
:* [[Microformat]]s (if used)
===Categorizing===
In order for other editors to find an infobox more easily, categories and interwiki links should be added to the bottom of the infobox documentation (at [[Special:Mypage/Infobox mysubject/doc]]).
Note that by convention, the infobox should be categorized using an explicit [[Help:Category#Sort order|sort key]] that drops the infobox prefix. In other words, rather than letting the category sort key default to [[Wikipedia:PAGENAME]] (in our example, "<code>Infobox mysubject</code>"), editors should explicitly supply "<code>Mysubject</code>" as the category sort key, as in <code><nowiki>[[Category:Mycategory infobox templates|Mysubject]]</nowiki></code>.
===Testing===
Editors should test prototyped infoboxes in their own userspaces. The simplest means is for the editor to place the fully-qualified page name of the template to be tested within the template braces (e.g., <code><nowiki>{{Special:Mypage/Infobox mysubject}}</nowiki></code>) on his or her own user page, [[Special:Mypage]].
Once the infobox prototype has been tested, it is ready for peer review and deployment.
===A skeleton infobox===
The following can be used as a starting point for a new infobox; simply copy-n-paste into the page designated to hold the new infobox and add or delete parameters as needed. Editors who want to take advantage of the more advanced features of infobox can copy-n-paste the comprehensive skeleton from {{tl|infobox}}.
<pre>
{{ infobox
| abovestyle =
| above =
| image =
| caption =
| headerstyle =
| header1 =
| label1 =
| data1 =
| header2 =
| label2 =
| data2 =
| header3 =
| label3 =
| data3 =
| header4 =
| label4 =
| data4 =
| header5 =
| label5 =
| data5 =
| header6 =
| label6 =
| data6 =
| header7 =
| label7 =
| data7 =
| header8 =
| label8 =
| data8 =
| header9 =
| label9 =
| data9 =
| header10 =
| label10 =
| data10 =
}}<noinclude>
{{Documentation}}
</noinclude>
</pre>
===Example {{tl|infobox}}-based infoboxes===
* {{tl|infobox Brewery}}
* {{tl|infobox Cheese}}
* {{tl|infobox Ecumenical council}}
* {{tl|infobox fictional race}}
* {{tl|infobox Holiday}}
* {{tl|infobox handball league}}
* {{tl|infobox Storage medium}}
* [[Wikipedia:How to read a cladobox]]
* [[Wikipedia:How to read a color infobox]]
* [[Wikipedia:Thinking outside the infobox]]
-->
=={{Ver também}}==
* [[:Categoria:!Predefinições de caixas de informação]]
* [[Wikipedia:Como ler uma caixa taxonómica]]
{{DEFAULTSORT:Caixa de informação}}
[[Categoria:!Guia de edição]]
[[Categoria:!Predefinições por tema]]
[[Categoria:!Recursos da Wikipédia|Caixa de informação]]
[[cs:Nápověda:Infobox]]
[[de:Hilfe:Infoboxen]]
[[dsb:Pomoc:Infokašćiki]]
[[en:Help:Infobox]]
[[eo:Helpo:Informkestoj]]
[[fa:راهنما:جعبه اطلاعات]]
[[fr:Aide:Infobox]]
[[hsb:Pomoc:Infokašćiki]]
[[io:Helpo:Infobuxo]]
[[ja:Help:Infobox]]
[[km:ជំនួយ:ប្រអប់ព័ត៌មាន]]
[[ms:Bantuan:Infobox]]
[[pl:Pomoc:Infoboks]]
[[simple:Help:Infobox]]
[[sv:Wikipedia:Faktamallar]]
[[tr:Yardım:Bilgi kutusu]]
| |||