Exibir código-fonte para Predefinição:Referências/doc

<includeonly>{{testes outro||{{alto-risco|600000}}}}</includeonly>{{Subpágina de documentação}}
<!-- Categorias no final desta página e links para outros idiomas no Wikidata -->
== Uso ==
{{Layout de múltiplas colunas em CSS3}}
'''''Nota''': O código que insere o título da secção (== ==) já está incluído nesta [[WP:PREDEF|predefinição]], podendo assim, ser especificado o nível de secção.''

'''Sintaxe mínima:'''
* <code><nowiki>{{referências}}</nowiki></code>
'''Sintaxe completa:'''
* <code><nowiki>{{referências|título=</nowiki>''outro nome da secção''<nowiki>|nível=</nowiki>''n.º nível''<nowiki>|col=</nowiki>''n.º colunas''<nowiki>}}</nowiki></code>
ou como alternativa com o mesmo resultado da anterior:
* <code><nowiki>{{referências|</nowiki>''outro nome da secção''<nowiki>|</nowiki>''n.º nível''<nowiki>|</nowiki>''n.º colunas''<nowiki>}}</nowiki></code>
: 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 <code><nowiki>{{referências|</nowiki>''nº colunas''<nowiki>}}</nowiki></code> não funciona como esperado, pois <code>''n.º colunas''</code> será interpretado como <code>''outro nome da secção''</code> (título).

{{Documentação dos parâmetros}}

* '''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: <code><nowiki>{{referências|título=Outra secção}}</nowiki></code>, ou simplesmente <code><nowiki>{{referências|Outra secção}}</nowiki></code>. Normalmente usa-se este parâmetro para especificar "notas e referências" com <code><nowiki>{{referências|Notas e referências}}</nowiki></code>
* '''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 é <code><nowiki>{{referências|nível=3}}</nowiki></code> 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 {{tl|Reflist}} depreciada)
** '''1''': produz uma secção de referências <nowiki><h1></nowiki>, (equivalente a uma secção criada com = =)
** '''2''': produz uma secção de referências <nowiki><h2></nowiki>, (equivalente a uma secção criada com == ==)
** '''3''': produz uma secção de referências <nowiki><h3></nowiki>, (equivalente a uma secção criada com === ===)
** '''4''': produz uma secção de referências <nowiki><h4></nowiki>, (equivalente a uma secção criada com ==== ====)
* '''col=''' é possível especificar o número de colunas, através do parâmetro "col". 

: Por exemplo: <code><nowiki>{{referências|col=2}}</nowiki></code>
* '''colwidth=''' em alternativa ao parâmetro anterior, é possível especificar a largura da coluna, através do parâmetro "colwidth".
: Por exemplo: <code><nowiki>{{referências|colwidth=300px}}, {{referências|colwidth=30em}}</nowiki></code>. Isso fará com que o navegador decida automaticamente o número de colunas dependendo da resolução do monitor do leitor.
* '''scroll=''' <span style="color:red;">Obsoleto</span> (mais detalhes na seção sobre a [[#Compactação|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:
<pre>A ágil raposa marrom pulou sobre o cachorro preguiçoso.<ref name="refname1"/>
A Wikihelp é 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>
}}</pre>

* '''grupo=''' especifica um subgrupo de referências a ser listado separadamente quando é utilizada a opção "'''group'''" da marcação [[predefinição:ref|<nowiki><ref></nowiki>]]. Por exemplo, os trechos sob a marcação:
<code><blockquote><nowiki><ref group="nota"> ... <ref/> </nowiki></blockquote></code>

: serão exibidos onde houver:
<code><blockquote><nowiki>{{referências|título=Observações|grupo="nota"}}</nowiki></blockquote></code>

Dessa forma fica fácil a separação entre notas, citações ou qualquer outra divisória.
{{VT|Wikihelp:Livro de estilo/Referências e notas de rodapé#Separação de lista de referências e notas explanatórias|l1=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''' [<span style="color:#0645AD">editar</span>] que aparece do lado direito do título da secção, usando a predefinição [[Predefinição:Esconder link para editar seçã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.
{{revisão}}
Veja o que diz a página ''Wikihelp:Livro de estilo/Notas de rodapé'', na secção [[Wikihelp:Livro de estilo/Notas de rodapé#Desvantagens e melhoramentos futuros|Desvantagens e melhoramentos futuros]]:

{{Início destaque}}
'' '''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.''
{{Fim destaque}}
'''Nota''': Até 5 de fevereiro de 2010, esta predefinição era conhecida como {{tl|ref-section}} e, anteriormente, era usada a {{tl|reflist}} em conjunto com o título da seção. Embora ainda sejam válidas estão [[:Categoria:!Predefinições depreciadas|depreciadas]],
sendo recomendado que sejam mudadas para {{tl|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 [[Wikihelp:Esplanada/propostas/Compactar a lista de refs (20set2011)|esta discussão]].

Caso prefira que a lista de referências seja compactada, pode ativar a função/gadget em [[Especial:Preferências#mw-prefsection-gadgets|Preferências]], veja o item com a seguinte descrição:
: <code>[ ]</code> {{int: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 ==
* [[bugzilla:51260|Bug 51260]] - Estender a tag <code><nowiki><references /></nowiki></code> com recursos da {{[[:en:Template:reflist|reflist]]}}
* [[Wikihelp:Livro de estilo/Notas de rodapé]]
* [[Predefinição:Notas]]
* [[Predefinição:Notas e referências]]

<includeonly>
{{testes outro||<!-- Categorias aqui e links para outros idiomas no Wikidata -->
[[Categoria:!Predefinições para referências]]
}}</includeonly>