Plantilla:Referències

De Viquipèdia
Dreceres ràpides: navegació, cerca
Icona de documentació de mòdul Documentació de la plantilla[mostra] [modifica] [historial] [refresca]

Aquesta plantilla per a citar referències proporciona el format i l'organització de citacions bibliogràfiques i notes a peu de pàgina. Incorpora l'etiqueta <references /> que mostra la llista de referències definides per etiquetes <ref>. Afegeix facilitats per mida de text reduïda, columnes, agrupacions i referències definides en una llista.

Sintaxi

Format simple: afegiu com a primera de les seccions finals addicionals

== Referències ==
{{referències}}

Format avançat amb paràmetres opcionals:

  • Primer paràmetre sense nom (opcional), defineix les columnes, per defecte 1:
    • Nombre de columnes; número que especifica la quantitat de columnes en les que es mostrarà el text. Per exemple {{referències|2}}. O bé,
    • Amplada de columnes; unitat de mesura tipogràfica, com ara em, que especifica l'amplada de les columnes per la llista de referències. Per exemple: {{referències|30em}}.
  • amplada: alternativa al paràmetre anterior per determinar específicament l'amplada de columnes. És incompatible amb el paràmetre tanca explicat més avall.
  • refs: utilitzat amb referències amb nom donat proporciona una llista de referències citades en el text. Per exemple {{referències|refs=<ref name=nom>...</ref>}} proporciona la referència citada en el text com <ref name=nom />, a més de les altres referències definides en el mateix text.
  • group: identifica una agrupació de referències a mostrar amb el mateix nom donat en les citacions al text. Per exemple, {{referències|group=grup}} mostra totes les referències citades com <ref group=grup>.
  • tanca: és un paràmetre no definit, usat per convenció per forçar l'analitzador que tanqui totes les referències anteriors per a que no les torni a mostrar si s'utilitza la mateixa plantilla més endavant.

Utilització

Referències definides en el text i llistades a peu de pàgina
Text font Mostra
Lorem ipsum.<ref>Font, data de consulta, etc.</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

==Referències==
{{referències}}
Lorem ipsum.[1]

Lorem ipsum dolor sit amet.[2]

Referències
  1. Font, data de consulta, etc.
  2. Font, data de consulta, etc.
Referències citades en el text i definides a peu de pàgina
Text font Mostra
Lorem ipsum.<ref name="text curt"/>
Lorem ipsum dolor sit amet.<ref name="text llarg"/>

==Referències==
{{referències|refs=
<ref name="text curt">Font, data de consulta, etc.</ref>
<ref name="text llarg">Font, data de consulta, etc.</ref>
}}
Lorem ipsum.[1]

Lorem ipsum dolor sit amet.[2]

Referències
  1. Font, data de consulta, etc.
  2. Font, data de consulta, etc.

Mida del text

La mida del text està reduïda al 90% per la majoria de navegadors, però apareixerà al 100% en Internet Explorer i possiblement en altres navegadors. Vegeu una mostra de diferents mides de text i la captura de pantalla amb diferents navegadors.

Columnes

Per defecte la plantilla mostra la llista en una única columna.

Utilitzant {{referències|2}} crearà una llista de referències a dues columnes, {{referències|3}} a tres columnes, etc. Escolliu el nombre de columnes més apropiat per l'amplada mitjana de les referències de la pàgina.

Utilitzant {{referències|30em}} crearà columnes amb un mínim de 30em d'amplada, permetent al navegador que seleccioni el nombre de columnes més adequat per l'amplada total. Alternativament es pot utilitzar {{referències|amplada=30em}}. Escolliu una amplada apropiada per l'amplada mitjana de les referències de la pàgina.

No tots els navegadors poden formatar el text en columnes. Vegeu més avall.

Exemple:

Llista de referències en columnes
Text font Mostra
Lorem ipsum.<ref>Font, data de consulta, etc.</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

==Referències==
{{referències|2}}
Lorem ipsum.[1]

Lorem ipsum dolor sit amet.[2]

Referències
  1. Font, data de consulta, etc.
  2. Font, data de consulta, etc.

Usos múltiples

Si {{referències}} s'utilitza múltiples vegades sense paràmetres en la mateixa pàgina cada vegada inclourà totes les referències definides prèviament. Per forçar a l'analitzador que tanqui les referències prèvies cal incloure algun paràmetre en cada ús de {{referències}}. Per evitar usos forçats de paràmetres la convenció és utilitzar el paràmetre no definit {{referències|tanca}}.

Referències agrupades

Les referències es poden separar per grups, per exemple separant notes explicatives, taula de referències i d'altres.

El format general per citar la referència és:

<ref group="grup">

I per llista la referència:

{{referències|group="grup"}}

on grup és l'identificador de l'agrupació, com "notes", "nb", ...

Referències agrupades
Text font Mostra
Lorem ipsum.<ref group="nb">Una nota explicativa</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

==Notes==
{{referències|group="nb"}}

==Referències==
{{referències}}
Lorem ipsum.[nb 1]

Lorem ipsum dolor sit amet.[1]

Notes
  1. Una nota explicativa
Referències
  1. Font, data de consulta, etc.

Notes tècniques

Les columnes múltiples són generades utilitzant CCS3 que encara està en desenvolupament, i no està disponible en tots els navegadors.

Navegadors que generen columnes amb CSS3:

  • Navegadors basats en Gecko, com el Mozilla Firefox. Les versions anteriors tenien un bug que creava enllaços trencats en columnes múltiples. Actualitzeu a l'última versió si és necessari.
  • Navegadors basats en WebKit, com Google Chrome i Safari. Les versions Webkit anteriors a 533 tenen un bug resolt en les versions Safari 5.x (7533.17) i Chrome 5.0 o posteriors.

Navegadors que no generen columnes:

La plantilla utilitza una mida de text definida a MediaWiki:Common.css: div.references { font-size: 90%; }

Utilitza les plantilles {{column-count}} i {{column-width}} per definir aquestes propietats respectives.

Personalització

Podeu modificar el vostre CSS personal per canviar la presentació de la llista de referències.

Mida de lletra

La mida de lletra en totes les llistes de referències està posada al 90% de la mida estàndard. Per canviar-la, afegiu:

ol.references,
div.reflist,
div.refbegin {
  font-size: 90%;
}

canviant el 90% a la mida desitjada.

Columns

Per deshabilitar les columnes, afegiu:

.references-column-count, .references-column-width {
  column-count: 1 !important;
  column-width: auto !important;
  -moz-column-count: 1 !important;
  -moz-column-width: auto !important;
  -webkit-column-count: 1 !important;
  -webkit-column-width: auto !important;
}

Igualment, per mostrar totes les referències amb un número determinat de columnes podeu posar-lo en lloc d'1.

Separador de columnes

Per afegir línies de separació entre columnes, afegiu:

.references-column-count, .references-column-width {
  column-rule: 1px solid #aaa;
  -moz-column-rule: 1px solid #aaa;
  -webkit-column-rule: 1px solid #aaa;
}

Discussions recurrents

Mida del text

És una pràctica habitual mostrar el text a peu de pàgina amb una lletra més petita diferent del cos del text. Per altra banda, cal assegurar l'accessibilitat per a tothom sense impediments per llegir correctament. Finalment, s'espera que el format sigui consistent entre diferents pàgines. La mida tipificada del 90% de la mida estàndard és un compromís entre diferents opcions i està unificada amb la mida mostrada amb l'etiqueta <references />. Tanmateix, el resultat pot variar segons el navegador utilitzat, el sistema operatiu i l'aparença seleccionada del MediaWiki.

Caixa de desplaçament o col·lapada

Alguns poden trobar que llistes llargues de referències poden fer nosa i preferirien reduir-les d'alguna manera. Les llistes amb caixes de mida fixada on cal desplaçar-se o caixes col·lapsades amb les opcions amaga i mostra, presenten problemes d'usabilitat, accessibilitat i impressió. El contingut podria no ser accessible amb dispositius que no acceptin JavaScript o CSS. Els enllaços entre la citació en el text i la referència en la llista no funcionen si la llista està amagada.

Inclusió del títol de secció

Encara que la secció de referències sol estar tipificada, per exemple:

== Referències ==
{{referències}}

no és recomanable incloure el títol de secció en la mateixa plantilla. El títol mateix pot variar segons el context i la pràctica en diferents disciplines: "Notes", "Bibliografia", "Obres citades". En transcloure el títol des d'una plantilla, l'enllaç per modificar la secció portaria de forma confusa a la plantilla.

Vegeu també