Predefinição:Referências/doc

De WikiINRICRISTOpedia
< Predefinição:Referências
Revisão de 12h42min de 8 de agosto de 2020 por In7cr7pe7 (discussão | contribs) (uma edição)
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para navegação Ir para pesquisar

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âmetroDescriçãoTipoEstado
Título da seçãotítulo 1

Texto usado no título da seção (uma opção comum é "notas e referências").

Padrão
Referências
Stringopcional
Nívelnível 2

Nível do título da seção (uma opção comum é "3").

Padrão
2
Stringopcional
Conteúdo adicionalextra

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údoopcional
Número de colunascol 3

Quantidade de colunas em que as referências serão organizadas

Padrão
1
Númeroobsoleto
Estiloestilo 5

Código CSS a ser aplicado ao elemento <div> que fica em torno da seção de referências

Stringopcional
Larguras das colunascolwidth

Largura das colunas em que as referências serão organizadas

Stringobsoleto
Grupogrupo

Nome do grupo

Stringopcional
Referênciasrefs

Lista de referências, cada uma das quais iniciada com <ref> e finalizada com </ref>

Conteúdoopcional
Barra de rolagemscroll

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

Stringobsoleto
  • 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.

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