Predefinição:Referências

Documentação da predefinição

A documentação que segue é transcluída de Predefinição:Referências/doc. (editar | histórico | vigiar)

Uso

Nota: ao contrário de outras predefinições como a {{Ver também}} que tem de ser usada com secção: =={{Ver também}}== esta predefinição não deve ser usada da mesma forma. A secção já está incluída nesta predefinição e pode 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}}

Ter em conta que esta alternativa só admite os parâmetros após o primeiro, caso existam os anteriores. 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.

Descrição dos parâmetros

• título= a predefinição usa o nome de secção "Referências". Se quiser usar outro nome de secção, use o parâmetro "título": {{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", veja: {{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 browser decida automaticamente o número de colunas dependendo da resolução do ecrã 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>
}}

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 é mostrado sob o cabeçalho "Referências", mas está contido dentro do artigo. Para editar o formato das referências de um artigo, é necessário procurá-las uma a uma no artigo, em lugar 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, mais antigamente, era usada a {{reflist}} em conjunto com o título da seção. Embora ainda sejam válidas, é preferível que sejam mudadas para {{referências}}.

Compactação

Caso prefira que a lista de referências seja compactada, pode ativar o gadget da Wikipédia que tem 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, de modo que nenhuma informação seja perdida. Caso deseje que as referências não tenham barra de rolagem, basta desativar o gadget.

Obs: 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.

Ver também

• Wikipedia:Livro de estilo/Notas de rodapé
• Predefinição:Notas