Revisió actual |
El vostre text |
Línia 1: |
Línia 1: |
− | 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.
| + | <div class="reflist <!-- |
− | | + | -->{{#if: {{{col|}}} |
− | == Sintaxi ==
| + | | {{#iferror: {{#ifexpr: {{{col|1}}} > 1 }} |
− | Format simple: afegiu com a primera de les seccions finals addicionals
| + | | references-column-width |
− | == Referències == | + | | references-column-count references-column-count-{{{col}}} |
− | <nowiki>{{referències}}</nowiki>
| + | }}" style="<!-- |
− | | + | -->{{#if: {{{col|}}} |
− | Format avançat amb paràmetres opcionals:
| + | | {{#iferror: {{#ifexpr: {{{col|1}}} > 1 }} |
− | *'''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.
| + | | {{column-width|{{{col}}}}} |
− | *'''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>.
| + | | {{column-count|{{{col}}}}} |
− | * '''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.
| + | }} list-style-type: <!-- |
− | | + | -->{{{liststyle|{{#switch: {{{grup|{{{group|}}}}}} |
− | == Utilització ==
| + | | upper-alpha |
− | <!-- Exemple 1 -->
| + | | upper-roman |
− | {{mostra codi | + | | lower-alpha |
− | | títol = Referències definides en el text i llistades a peu de pàgina
| + | | lower-greek |
− | | t1 = Text font
| + | | lower-roman = {{{grup|{{{group|}}}}}} |
− | | 1 = <nowiki>Lorem ipsum.<ref>Font, data de consulta, etc.</ref>
| + | | #default = decimal}}}}};"> |
− | Lorem ipsum dolor sit amet.<ref>Font, data de consulta, etc.</ref>
| + | {{#tag:references|{{{refs|}}}|responsive={{#if:{{{col|}}}|0|1}}|group={{{grup|{{{group|}}}}}}}}</div><noinclude> |
− | | + | {{ús de la plantilla}} |
− | == Referències ==
| + | </noinclude> |
− | {{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.
| |