Plantilla:Referències

Documentació de la plantilla [ mostra ] [ modifica el codi ] [ mostra l'historial ] [ refresca ]

Aquesta plantilla és utilitzada en més de 400000 pàgines. Per evitar la interrupció a gran escala i la innecessària càrrega del servidor, qualsevol canvi en aquesta plantilla primer hauria de ser provat en la subpàgina /proves, o en el vostre propi espai d'usuari. Els canvis assajats després es poden afegir a aquesta pàgina en una sola edició. Si us plau: considereu discutir qualsevol canvi en la pàgina de discussió abans d'implementar-los.

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 amb disseny responsiu, agrupacions i referències definides en una llista.

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

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

Format avançat amb paràmetres opcionals:

• 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.
• grup: identifica una agrupació de referències a mostrar amb el mateix nom donat en les citacions al text. Per exemple, {{referències|grup=nom_del_grup}} mostra totes les referències citades com <ref grup=nom_del_grup>.
• liststyle: especifica l'estil de la llista. Per defecte és una llista numerada. Vegeu més avall els #Estils de llista.
• tanca: és un paràmetre no definit, usat per convenció per forçar l'analitzador que tanqui totes les referències anteriors perquè no les torni a mostrar si s'utilitza la mateixa plantilla més endavant.

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.<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>
}}

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.

Per defecte la plantilla utilitza un disseny de columnes responsiu. Segons l'amplada de la pantalla del lector pot variar entre una i quatre columnes. Aquestes columnes s'apliquen a partir d'una llista de deu referències, amb un nombre menor no es considera necessari. El tall entre columnes s'aplica sense tallar les línies de la darrera referència. Les columnes s'ajusten a 35em d'amplada, és a dir amb una finestra d'uns 1290px d'amplada canvia d'una a dues columnes, amb uns 1795px de 2 a 3 columnes, i amb uns 2300px de 3 a 4 columnes.

Provisionalment es manté l'opció anterior d'usar un nombre fix de columnes per si hi ha algun cas justificat. El primer paràmetre sense nom usat abans per a aquesta opció ara s'ignora per aplicar per defecte el format responsiu. En el seu lloc es pot usar el paràmetre col= amb el nombre de columnes o encara millor amb la mida de l'amplada, per exemple col=25em. No tots els navegadors poden formatar el text en columnes. Vegeu més avall.

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}}.

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", ...

Lorem ipsum.<ref group="nb">Una nota explicativa</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

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

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

Hi ha alguns noms de grup predefinits que a més de mostrar el grup de referències corresponent estableix un estil de llista. Els noms predefinits són: lower-alpha, upper-alpha, lower-roman, upper-roman i lower-greek.

Les llistes de referències per defecte són numerades. Les referències agrupades amb noms predefinits afegeixen un estil de llista. Amb el paràmetre liststyle es pot controlat l'estil, deixant sense efecte el nom predefinit del grup si fos el cas. Per exemple, utilitzant liststyle=lower-roman mostrarà la llista amb números romans en minúscula en lloc de números decimals. El paràmetre accepta qualsevol valor vàlid CSS definit per a list-style-type. Els valors compatibles amb la majoria de navegadors són:

És possible usar listsyle per diferenciar els marcadors d'una llista de notes dels marcadors d'una llista de referències. En qualsevol cas els estils de llista no s'haurien d'usar de forma que confonguin al lector.

Les columnes múltiples són generades utilitzant CSS3 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:

• Navegadors basats en Trident de Microsoft, com l'Internet Explorer fins a la versió 9 Beta.
• Opera fins a la versió 10.

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.

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.

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;
}

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.

• {{Refn}}
• Viquipèdia:Citau les fonts
• Ajuda:Notes a peu de pàgina
• Viquipèdia:Plantilles per a citar fonts