Predefinição:Referências

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Uso

Suporte dos navegadores para o layout
de múltiplas colunas em CSS3

Internet Explorer	Firefox	Safari	Chrome	Opera
≤ 9	≤ 1.0	≤ 2	—	≤ 11.0
10 (2012)	≥ 1.5 (2005)	≥ 3 (2007)	≥ 1 (2008)	≥ 11.1 (2011)

Nota: O código que insere o título da secção (== ==) já está incluído nesta predefinição, podendo assim, ser especificado o nível de secção.

Sintaxe mínima:

• {{referências}}

Sintaxe completa:

• {{referências|título=outro nome da secção|nível=n.º nível|col=n.º colunas}}

ou como alternativa com o mesmo resultado da anterior:

• {{referências|outro nome da secção|n.º nível|n.º colunas}}

Ressaltamos que esta alternativa só admite os parâmetros posteriores se existirem primeiro os parâmetros anteriores, na ordem original. Ou seja, o código {{referências|nº colunas}} não funciona como esperado, pois n.º colunas será interpretado como outro nome da secção (título).

Cabeçalho de TemplateData

As informações a seguir (editar) são definidas com TemplateData. Isso possibilita o seu uso pelo Editor Visual e por outras ferramentas.

Produz o título da seção de referências e impede que seja editável

Parâmetros da predefinição

Parâmetro		Descrição	Tipo	Estado
Título da seção	título 1	Texto usado no título da seção (uma opção comum é "notas e referências"). Padrão Referências	String	opcional
Nível	nível 2	Nível do título da seção (uma opção comum é "3"). Padrão 2	String	opcional
Conteúdo adicional	extra	Conteúdo a ser apresentado depois do título da secção, mas antes das referências. Por exemplo, caixas flutuantes como a {{correlatos}}	Conteúdo	opcional
Número de colunas	col 3	Quantidade de colunas em que as referências serão organizadas Padrão 1	Número	obsoleto
Estilo	estilo 5	Código CSS a ser aplicado ao elemento <div> que fica em torno da seção de referências	String	opcional
Larguras das colunas	colwidth	Largura das colunas em que as referências serão organizadas	String	obsoleto
Grupo	grupo	Nome do grupo	String	opcional
Referências	refs	Lista de referências, cada uma das quais iniciada com <ref> e finalizada com </ref>	Conteúdo	opcional
Barra de rolagem	scroll	Antes de tornar-se obsoleto, restringia a altura da seção a no máximo 300px, e exibia uma barra de rolagem quando necessário	String	obsoleto

• título= a predefinição usa automaticamente o nome de secção "Referências". Se quiser usar outro nome de secção, use o parâmetro "título".

Por exemplo: {{referências|título=Outra secção}}, ou simplesmente {{referências|Outra secção}}. Normalmente usa-se este parâmetro para especificar "notas e referências" com {{referências|Notas e referências}}

• nível= a predefinição usa o nível h2 (== ==) para exibição do nome da secção. Se quiser outro nível, use o parâmetro "nível". Quando se especifica este parâmetro, o mais utilizado é {{referências|nível=3}} uma vez que esta predefinição é de nível 2 por padrão e normalmente quando se especifica outro nível é o seguinte de nível 3. Os valores que pode assumir são:
  • 0: produz apenas o bloco de referências (como a {{Reflist}} depreciada)
  • 1: produz uma secção de referências <h1>, (equivalente a uma secção criada com = =)
  • 2: produz uma secção de referências <h2>, (equivalente a uma secção criada com == ==)
  • 3: produz uma secção de referências <h3>, (equivalente a uma secção criada com === ===)
  • 4: produz uma secção de referências <h4>, (equivalente a uma secção criada com ==== ====)
• col= é possível especificar o número de colunas, através do parâmetro "col".

Por exemplo: {{referências|col=2}}

• colwidth= em alternativa ao parâmetro anterior, é possível especificar a largura da coluna, através do parâmetro "colwidth".

Por exemplo: {{referências|colwidth=300px}}, {{referências|colwidth=30em}}. Isso fará com que o navegador decida automaticamente o número de colunas dependendo da resolução do monitor do leitor.

• scroll= Obsoleto (mais detalhes na seção sobre a compactação das referências)
• refs= Lista com a definição das referências. Caso as descrição das referências não seja fornecida ao longo do texto, elas deverão ser especificadas dentro desse campo. Exemplo:

A ágil raposa marrom pulou sobre o cachorro preguiçoso.<ref name="refname1"/>
A Wikipédia é uma enciclopédia livre.<ref name="refname2"/>
Este é um tempo de exemplo sobre notas de rodapé e referências.<ref name="refname3"/>

{{referências|refs=
<ref name="refname1">Esta é a referência 1.</ref>
<ref name="refname2">Esta é a referência 2.</ref>
<ref name="refname3">Esta é a referência 3.</ref>
}}

• grupo= especifica um subgrupo de referências a ser listado separadamente quando é utilizada a opção "group" da marcação <ref>. Por exemplo, os trechos sob a marcação:

<ref group="nota"> ... <ref/>

serão exibidos onde houver:

{{referências|título=Observações|grupo="nota"}}

Dessa forma fica fácil a separação entre notas, citações ou qualquer outra divisória.

Ver também: Referências e notas de rodapé/Separação de lista de referências e notas explanatórias

Descrição

Esta predefinição produz uma secção de referências sem botão de editar secção [editar] que aparece do lado direito do título da secção, usando a predefinição Esconder link para editar seção.

Isto só é útil quando os conteúdos da secção de referências não são editáveis a partir dessa secção, por estarem inseridos ao longo do texto.

Veja o que diz a página Wikipedia:Livro de estilo/Notas de rodapé, na secção Desvantagens e melhoramentos futuros:

Atenção: O conteúdo da secção de referências é exibido sob o cabeçalho "Referências", isto é, todas as referências presente no artigo são exibidas juntas sob o cabeçalho "Referências" apesar de contido separadas em vários parágrafos do artigo. Para editar o formato de alguma referência de um artigo, é necessário procurá-las uma a uma no artigo, ao invés de editar todas ao mesmo tempo na seção de referências.

Nota: Até 5 de fevereiro de 2010, esta predefinição era conhecida como {{ref-section}} e, anteriormente, era usada a {{reflist}} em conjunto com o título da seção. Embora ainda sejam válidas estão depreciadas, sendo recomendado que sejam mudadas para {{referências}}.

Compactação

Nota: antigamente era necessário colocar o parâmetro extra "scroll" em cada artigo para que as referências fossem compactadas. Isso foi alterado após esta discussão.

Caso prefira que a lista de referências seja compactada, pode ativar a função/gadget em Preferências, veja o item com a seguinte descrição:

[ ] ⧼Gadget-Compactar refs⧽

Uma vez ativado, ele fará com que as referências ocupem no máximo 300 px de altura, e que sejam acompanhadas de uma barra de rolagem quando necessário. A versão impressa apresentará todos os dados normalmente, sem a barra de rolagem, sem perda de informação. Caso deseje que as referências não tenham barra de rolagem, basta desativar a função.

Ver também

• Bug 51260 - Estender a tag <references /> com recursos da {{reflist}}
• Wikipédia:Livro de estilo/Notas de rodapé
• Predefinição:Notas
• Predefinição:Notas e referências
• Predefinição:Formatar referências