Ajuda:Cita
 |
Nota: Quan modifiqueu aquesta pàgina, esteu acceptant que la vostra contribució es publiqui en el marc de CC0. Vegeu Pàgines d'ajuda de domini públic per a més informació. Algunes versions antigues d'aquesta pàgina s'han importat sota la llicència CC BY-SA. Només les contribucions noves són de domini públic. |
|
Cita fa possible afegir notes a peu de pàgina en una pàgina.
Vegeu Extensió:Cite per a més detalls tècnics.
Ús
El concepte bàsic de l'etiqueta <ref> és que insereix el text comprès entre les etiquetes de referència com a nota al peu en una secció designada, que s'indica amb l'etiqueta de marcador de posició <references />.
Es poden inserir etiquetes addicionals de marcador de posició <references /> al text, i totes les etiquetes de substitució <ref> fins a aquest punt, en aquest grup, s'inseriran allà.
Si oblideu incloure <references /> a l'article, les notes al peu no desapareixeran, però les referències es mostraran al final de la pàgina.
Aquesta mateixa pàgina utilitza notes a peu de pàgina, com la que hi ha al final d'aquesta frase.[note 1] Si visualitzeu la font d'aquesta pàgina fent clic a "Edita aquesta pàgina", podeu veure un exemple utilitzant les notes al peu de pàgina.
| Wikitext | Resultat |
|---|---|
El Sol és bastant gran.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> La Lluna, tanmateix, no és tan gran.<ref>R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>
==Notes==
<references />
|
El Sol és bastant gran.[1]
La Lluna, tanmateix, no és tan gran.[2] Notes
|
Usos múltiples de la mateixa nota a peu de pàgina
Per donar a una nota a peu de pàgina un identificador únic, utilitzeu <ref name="nom">.
Després podreu tornar a referir-vos a la mateixa nota al peu de pàgina utilitzant una etiqueta ref amb el mateix nom.
El text dins la segona etiqueta no es té en compte, perquè ja existeix un text en la primera referència.
Podeu copiar tota la nota a peu de pàgina o podeu utilitzar una etiqueta de referència buida acabada que tingui aquest aspecte: <ref name="nom" />.
Els noms són únics dins del seu grup, no globals; és a dir, una referència <ref group="note" name="source-a">...</ref> només es pot reutilitzar com a <ref group="note" name="source-a" />.
En l'exemple següent, es cita la mateixa font tres vegades.
| Wikitext | Resultat |
|---|---|
Aquest és un exemple de múltiples referències a la mateixa nota a peu de pàgina.<ref name="multiple">Recordeu que quan feu referència a la mateixa nota a peu de pàgina diverses vegades, s'utilitza el text de la primera referència.</ref>
Aquestes referències són especialment útils si diferents declaracions provenen de la mateixa font.<ref name="multiple" /> Qualsevol etiqueta reutilitzada no hauria de contenir contingut extra, això generarà un error. Utilitzeu només etiquetes buides en aquesta funció.
Una manera concisa de fer múltiples referències és utilitzar etiquetes de referència buides, que tenen una barra al final.
Tot i que això pot reduir el treball redundant, si us plau, tingueu en compte que si un futur editor elimina la primera referència, això comportarà la pèrdua de totes les referències utilitzant les etiquetes de referència buides.<ref name="multiple" />
== Notes ==
<references />
|
Això és un exemple de referències múltiples a la mateixa nota a peu de pàgina.[1]
Aquestes referències són particularment útils quan se citen fonts, si diferents declaracions provenen de la mateixa font[1] Qualsevol etiqueta reutilitzada no hauria de contenir contingut extra, això generarà un error. Utilitzeu només etiquetes buides en aquesta funció. Una manera concisa de fer múltiples referències és utilitzar etiquetes de referència buides, que tenen una barra al final. Tot i que això pot reduir el treball redundant, si us plau, tingueu en compte que si un futur editor elimina la primera referència, això comportarà la pèrdua de totes les referències utilitzant les etiquetes de referència buides.[1] Notes
|
L'etiqueta <references />
L'etiqueta <references /> insereix el text de totes les cites que s'han definit a les etiquetes <ref> fins a aquest punt de la pàgina.
Per exemple, basant-nos en les citacions anteriors, hi hauria d'haver una referència per al grup note.
| Wikitext | Resultat |
|---|---|
<references group="note"/>
|
|
La llista de referències pot tenir una amplada adaptable (mostrant en alguns casos les referències en diverses columnes).
En aquest cas, l'atribut responsive s'utilitza per configurar aquest comportament.
En els wikis amb la configuració predeterminada, això succeirà a cada pàgina; en les altres, cal activar-lo. En wikis amb la configuració per defecte, el comportament responsiu es pot desactivar amb <references responsive="0" />.
Si una pàgina inclou més d'una llista <references />, cada llista inclou les etiquetes <ref> definides després de la llista de referències anteriors.
Si aquestes llistes de referències es generen mitjançant plantilles, cadascuna llista les etiquetes ref definides abans de la primera llista de referències i apareix un missatge d'error que indica que hi ha una etiqueta ref, però no una llista de referències.
Referències agrupades
Això pot ser desactivat per $wgAllowCiteGroups = false; si ho desitgeu.
El següent exemple genera llistes de referència separades per a cites i notes a peu de pàgina diverses:
| Wikitext | Resultat |
|---|---|
Segons els científics, el Sol és força gran.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> De fet, és molt gran.<ref group="footnotes"> Confieu en les seves paraules. No mireu directament al sol!</ref>
== Notes ==
<references group="footnotes" />
== Referències ==
<references />
|
Segons els científics, el Sol és força gran.[1] De fet, és molt gran.[footnotes 1]
Notes
Referències
|
El grup anònim funciona com abans, mentre que les referències destinades al grup amb nom només apareixeran a l'element <references /> designat.
La representació d'un grup determinat es pot personalitzar en l'àmbit del wiki creant MediaWiki:Cite_link_label_group-<nom> i llistant els signes utilitzats en l'ordre en què apareixen, separats per espais o salts de línia.
Per exemple, si MediaWiki:Cite_link_label_group-lower-alpha és creat amb el contingut
a b c d e f g h i j k l m n o p q r s t u v w x y z
llavors el primer <ref group="lower-alpha">...</ref> mostrarà [a], el segon mostrarà [b], etcètera, el 26è es mostrarà com [z].
Si s'intenta utilitzar més notes a peu de pàgina en un grup renderitzat personalitzat que el nombre de signes definits, es faran servir les etiquetes numèriques. La 27a es mostrarà simplement com a [1.27], i així successivament.
Els noms de grup següents sovint es defineixen com a grups personalitzats mitjançant els missatges següents respectivament:
| nom de grup | missatge |
|---|---|
upper-alpha |
MediaWiki:Cite link label group-upper-alpha |
lower-alpha |
MediaWiki:Cite link label group-lower-alpha |
upper-roman |
MediaWiki:Cite link label group-upper-roman |
lower-roman |
MediaWiki:Cite link label group-lower-roman |
lower-greek |
MediaWiki:Cite link label group-lower-greek |
<ref group="lower-alpha">...</ref> es mostrarà com lower-alpha 1.
Citant parts diferents de la mateixa font
Quan vulgueu citar diverses parts de la mateixa obra com a referències en un article, podeu fer servir "subreferència": <ref name="nom" details="detalls">.
Això dóna als lectors una manera d'identificar quines referències s'originen des del mateix origen.
També permet citar diferents parts de la mateixa font sense repetir la font sencera cada vegada.
Aquesta funció es pot combinar amb l'opció de separar les referències del text de l'article.
Les subreferències idèntiques es tracten automàticament com a reutilitzacions a VisualEditor i a la vista de lector.
| Wikitext | Resultat |
|---|---|
Segons els científics, el Sol és força gran.<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> De fet, és molt gran.<ref name="Miller" details="p. 123"/> Confieu en les seves paraules. No mireu directament al sol!<ref name="Miller" details="p. 42"/>
== Referències ==
<references />
|
Segons els científics, el Sol és força gran.[1] De fet, és molt gran.[1.1] Confieu en les seves paraules. No mireu directament al sol![1.2]
Referències
|
Separant les referències del text
Amb les referències dins del text es facilita la còpia del text a una altra pàgina; però, d'altra banda, es dificulta la lectura.
Les referències que contenen moltes dades, cites o plantilles elaborades de cites poden constituir una fracció significativament més gran de la font que el text que realment serà visible.
Per evitar això, podeu moure algunes o totes les referències a la secció <references />, al lloc on realment apareixeran al lector.
| Wikitext | Resultat |
|---|---|
Segons els científics, el Sol és força gran.<ref name="miller" /> La Lluna, tanmateix, no és tan gran.<ref name="smith" />
== Notes ==
<references>
<ref name="miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref>
<ref name="smith">R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>
</references>
|
Segons els científics, el Sol és força gran.[1] La Lluna, tanmateix, no és tan gran.[2] Notes
|
Així doncs, el codi anterior tindrà la mateixa sortida que el primer exemple anterior, tot i que la numeració i l'ordre de les referències no seran en general les mateixes.
Si un grup s'estableix amb <references group>, no cal especificar-lo també a cada fill <ref />.
Funcions de substitució i funcions integrades de l'analitzador sintàctic
Com que l'etiqueta <ref> de Cite s'analitza abans de les funcions d'anàlisi sintàctica de MediaWiki (per exemple, {{#ifexpr:…}}) o variables (per exemple, {{PAGENAME}}) o abans de subst:, aquestes no funcionaran dins de les referències de citació.
En comptes d'això, heu de fer servir la paraula màgica {{#tag:…}}.
| Wikitext | Resultat |
|---|---|
Foo<ref>Això no funciona, vegeu {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|Mentre aquest ho fa, vegeu {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}}} bar baz…
<references />
|
Foo[1] bar baz… Foo[2] bar baz…
|
Afegir un encapçalament automàtic abans de la llista de referències
Fins a MediaWiki 1.28, es podia utilitzar el missatge de sistema MediaWiki:Cite references prefix per definir un encapçalament per a tot el wiki que s'inseriria automàticament abans de cada llista de referències. A MediaWiki 1.29, aquest missatge del sistema va ser eliminat. Una manera artificiosa d'introduir un encapçalament ara és afegir el codi següent a MediaWiki:Common.js:
$(document).ready(function(){
$('.mw-references-wrap').before('<h2>Referències</h2>');
});
Tingueu en compte que això afegeix l'encapçalament incondicionalment, és a dir, si ja teniu l'encapçalament, es torna a afegir, creant així encapçalaments duplicats.
Si només necessiteu un encapçalament de text (sense enllaç ni altres elements actius), podeu afegir el següent a MediaWiki:Common.css (Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):
.mw-references-wrap::before {
content: "Blue references";
color: #0645ad;
text-decoration: none;
background: none;
font-style: italic;
font-size: 100%;
font-weight: bold;
line-height: 1.6;
direction: ltr;
font-family: sans-serif;
}
Fusionar dos textos en una sola referència
Un problema típic de Wikisource són les referències que abasten diverses pàgines en el material font.
Aquestes es poden fusionar mitjançant una etiqueta <ref name="name"> per a la primera part de la referència, i etiquetant les parts següents amb una etiqueta <ref follow="name"> amb el mateix nom.
Exemple:
| Wikitext | Resultat |
|---|---|
Aquest és un exemple de fusió de diversos textos en la mateixa nota a peu de pàgina.<ref name="main">Recordeu que tots els textos s'inclouran a la referència que contingui l'atribut name="…".</ref>
<ref follow="main">Simplement incloeu el text addicional en una etiqueta amb l'atribut follow="…", que coincideixi amb el nom de la primera referència.</ref>
== Referències ==
<references/>
|
Aquest és un exemple de fusió de diversos textos en la mateixa nota a peu de pàgina.[1]
Referències
|
Quan s'utilitzi aquesta sintaxi, tingueu cura que la part "follow" de la nota al peu s'inclogui a la mateixa pàgina que la primera part de la referència.
Tingueu en compte que els noms de referència no poden començar amb un número, de manera que sempre s'inclou algun text com, <ref name="p32"> i <ref follow="p32">.
Personalització
El format de la sortida de <ref> i <references> és gairebé completament personalitzable a través dels missatges de MediaWiki, que es poden modificar, per exemple, a través de l'espai de noms MediaWiki segons la configuració del wiki.
Per a una llista de missatges que controlen la sortida de <ref> i <references> i els valors, si n'hi ha, que se'ls passen ($1, $2, $3...), vegeu un llistat actualitzat dels valors predeterminats que es pot obtenir directament des de MediaWiki.
Per entendre què significa cada paràmetre, podeu mirar el missatge a translatewiki.net.
Establir que les referències utilitzin ^ i lletres
Per substituir la fletxa amunt per defecte (↑) pel circumflex (^), modifiqueu el següent missatge de sistema. Totes aquestes pàgines es poden trobar a Special:AllMessages.
| Des de | A |
|---|---|
↑
|
^
|
Substituint $2 per $3 canvia els enllaços d'1,1, 1.1, 1.2 a a, b, c, etc...
| Des de | A |
|---|---|
<sup>[[#$1|$2]]</sup>
|
<sup>[[#$1|$3]]</sup>
|
Si cerqueu aquestes pàgines per primera vegada, no trobareu cap resultat. Simplement, feu clic a "Crear aquesta pàgina" per a editar el codi. Els canvis no apareixeran fins que no es reconstrueixi una pàgina amb referències.
Establir el ressaltat per la referència i el número de referència
Cite/modules/ext.cite.css. Així, aquesta part del codi CSS de sota ja no necessita ser afegida manualment.Afegiu el codi següent a la pàgina MediaWiki:Common.css.
/* fer que la llista de referències de l'extensió Cite sembli més petita i ressaltar en blau la referència en què s'ha fet clic */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }
Amagar els claudàtors al voltant dels números de peu de pàgina
Nou enfocament - Els claudàtors s'embolcallen dins d'un espai com ara [, de manera que la personalització es pot aconseguir mitjançant CSS específic per a tot el lloc web o per a cada usuari.
La regla recomanada per als llocs que vulguin ometre els claudàtors és ocultar-los visualment, però deixar-los a l'HTML habilitat perquè s'incloguin en copiar i enganxar contingut:
.reference .cite-bracket { font-size: 0; }
Enfocament antic - Personalitzeu el missatge MediaWiki:cite_reference_link per ometre els claudàtors.
Això també es pot fer afegint un element "span" al voltant dels claudàtors, però això ja està disponible ara, vegeu més amunt
Tingueu en compte que les personalitzacions que utilitzen aquest enfocament antic poden interferir amb els nous estils, tret que s'afegeixi l'"span".
Referències trencades
Si les etiquetes <ref> o <references /> s'utilitzen incorrectament, l'extensió Cite afegirà un missatge d'error a la pàgina i afegirà la pàgina mateixa a la categoria "Pàgines amb errors a les referències".
Aquests missatges d'error apareixeran en l'idioma de la interfície de l'usuari, ja sigui al contingut de l'article o a la secció Referències.
Per exemple:
| Wikitext | Resultat |
|---|---|
Aquest és un exemple d'un missatge d'error de referències.<ref broken>Text desitjat.</ref>
== Notes ==
<references />
|
Aquest és un exemple d'un missatge d'error de referències.[1] Notes
|
Vegeu l'especificació per la representació d'errors de Cite a Parsoid.