Edició de la pàgina «Plantilla:Referències»

{{Subpàgina de plantilla}}
<!-- SI US PLAU, AFEGIU LES CATEGORIES AL FINAL D'AQUESTA PÀGINA -->

Aquesta [[Viquipèdia:Plantilles per a citar fonts|plantilla per a citar referències]] proporciona el format i l'organització de [[Ajuda:Notes a peu de pàgina|citacions bibliogràfiques i notes a peu de pàgina]]. Incorpora l'etiqueta <code><nowiki><references /></nowiki></code> que mostra la llista de referències definides per etiquetes <code><nowiki><ref></nowiki></code>. Afegeix facilitats per mida de text reduïda, columnes amb disseny responsiu, agrupacions i referències definides en una llista.

== Sintaxi ==
Format simple: afegiu com a primera de les seccions finals addicionals
 == Referències ==
 <nowiki>{{referències}}</nowiki>

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 <code><nowiki>{{referències|refs=<ref name=nom>...</ref>}}</nowiki></code> proporciona la referència citada en el text com <code><nowiki><ref name=nom /></nowiki></code>, 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, <code><nowiki>{{referències|grup=nom_del_grup}}</nowiki></code> mostra totes les referències citades com <code><nowiki><ref grup=nom_del_grup></nowiki></code>.
* '''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.

== Utilització ==
<!-- Exemple 1 -->
{{mostra codi
 | títol = Referències definides en el text i llistades a peu de pàgina
 | t1 = Text font
 | 1 = <nowiki>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}}</nowiki>
 | 2 = Lorem ipsum.<ref>Font, data de consulta, etc.</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

{{mostra d'encapçalament|sub=3|Referències}}
{{referències|tanca}}
}}

<!-- Exemple 2 -->
{{mostra codi
 | títol = Referències citades en el text i definides a peu de pàgina
 | t1 = Text font
 | 1 = <nowiki>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>
}}</nowiki>
 | 2 = Lorem ipsum.<ref name="text curt"/>
Lorem ipsum dolor sit amet.<ref name="text llarg"/>

{{mostra d'encapçalament|sub=3|Referències}}
{{referències|tanca|refs=
<ref name="text curt">Font, data de consulta, etc.</ref>
<ref name="text llarg">Font, data de consulta, etc.</ref>
}}
}}

=== 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 [[:en:User:Edokter/fonttest|mostra de diferents mides de text]] i la [[:en:User:Edokter/fonttest/screenshots|captura de pantalla amb diferents navegadors]].

=== Columnes ===

Per defecte la plantilla utilitza un disseny de columnes [[wikt:responsiu|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 <code>col=</code> 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.

=== Usos múltiples ===
Si {{tl|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 {{tl|referències}}. Per evitar usos forçats de paràmetres la convenció és utilitzar el paràmetre no definit {{tlx|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:
:<code><nowiki><ref group=</nowiki>"''grup''"></code>

I per llista la referència:
:{{plan|noenllaç=sí|code=sí|referències|2=group="''grup''"}}
on ''grup'' és l'identificador de l'agrupació, com "notes", "[[Nota bene|nb]]", ... 

{{mostra codi
 | títol = Referències agrupades
 | t1 = Text font
 | 1 = <nowiki>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}}</nowiki>
 | 2 = Lorem ipsum.<ref group="nb">Una nota explicativa</ref>
Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>

{{mostra d'encapçalament|sub=3|Notes}}
{{referències|grup="nb"}}

{{mostra d'encapçalament|sub=3|Referències}}
{{referències|tanca}}
}}

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.

===Estils de llista===

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 <code>liststyle</code> es pot controlat l'estil, deixant sense efecte el nom predefinit del grup si fos el cas. Per exemple, utilitzant <code>liststyle=lower-roman</code> 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 <code>list-style-type</code>. Els valors compatibles amb la majoria de navegadors són:

{|
| <ol style="list-style:none"><li>none</li><li>none</li></ol>
| <ol style="list-style:disc"><li>disc</li><li>disc</li></ol>
| <ol style="list-style:circle"><li>circle</li><li>circle</li></ol>
| <ol style="list-style:square"><li>square</li><li>square</li></ol>
| <ol style="list-style:decimal"><li>decimal</li><li>decimal</li></ol>
| <ol style="list-style:lower-roman"><li>lower-roman</li><li>lower-roman</li></ol>
| <ol style="list-style:upper-roman"><li>upper-roman</li><li>upper-roman</li></ol>
| <ol style="list-style:lower-alpha"><li>lower-alpha</li><li>lower-alpha</li></ol>
| <ol style="list-style:upper-alpha"><li>upper-alpha</li><li>upper-alpha</li></ol>
|}

És possible usar <code>listsyle</code> 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.

== Notes tècniques ==
Les columnes múltiples són generades utilitzant [[CSS]]3 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 (navegador web)|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]]: <code>div.references { font-size: 90%; }</code>

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

== Personalització ==
Podeu modificar el vostre [[Especial:Mypage/common.css|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:

<source lang="css">
ol.references,
div.reflist,
div.refbegin {
  font-size: 90%;
}
</source>
canviant el 90% a la mida desitjada.

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

<source lang="css">
.references-column-count, .references-column-width {
  column-rule: 1px solid #aaa;
  -moz-column-rule: 1px solid #aaa;
  -webkit-column-rule: 1px solid #aaa;
}
</source>

== 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 <code><nowiki><references /></nowiki></code>. 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:
<pre>
== Referències ==
{{referències}}
</pre>
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é ==
*{{tl|Refn}}
*[[Viquipèdia:Citau les fonts]]
*[[Ajuda:Notes a peu de pàgina]]
*[[Viquipèdia:Plantilles per a citar fonts]]

<includeonly>
[[Categoria:Plantilles de llistes de referències|Referencies]]
</includeonly>