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 Extension: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.
| Text wiki | 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.
| Text wiki | 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.
| Text wiki | 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:
| Text wiki | 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 s'utilitzen diverses parts de la mateixa obra com a referències en un article, les podeu agrupar a la secció de les referències. 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.
| Text wiki | 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"</ref> 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
E. Miller, The Sun, (New York: Academic Press, 2005), 23–25. |
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.
| Text wiki | 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
Since Cite's <ref> tag is parsed before MediaWiki's parser functions (e.g. {{#ifexpr:…}}) or variables (e.g. {{PAGENAME}}) or before subst:, these will not work inside of citation references.
Instead, you have to use the magic word {{#tag:…}}.
| Text wiki | Resultat |
|---|---|
Foo<ref>This is not working, see {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|Whereas this does, see {{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
Up to MediaWiki 1.28, one could use the system message MediaWiki:Cite references prefix to define a wiki-wide heading which would be automatically inserted before each references list. In MediaWiki 1.29, this system message was removed. A hacky way to enter a headline now is to add the following code to MediaWiki:Common.js:
$(document).ready(function(){
$('.mw-references-wrap').before('<h2>Referències</h2>');
});
Note that this adds the header unconditionally, i.e. if you already have the header it gets added again thus creating duplicated headers.
If you only need a text heading (no link or other active elements) you could add the following to 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
A typical Wikisource issue are references that span multiple pages in the source material.
These can be merged using a <ref name="name"> tag for the first part of the reference, and tagging the following parts with a tag <ref follow="name"> using the same name.
Exemple:
| Text wiki | Resultat |
|---|---|
This is an example of merging multiple texts into the same footnote.<ref name="main">Remember that all the texts will be included into the reference containing the name="…" attribute.</ref>
<ref follow="main">Simply include the additional text in a tag with the follow="…" attribute, matching the first ref's name.</ref>
== Referències ==
<references/>
|
This is an example of merging multiple texts into the same footnote.[1]
Referències
|
When using this syntax, take care that the "follow" part of the footnote is included on the same page as the first part of the reference.
Note that reference names cannot start with a number, so always include some text like, <ref name="p32"> and <ref follow="p32">.
Personalització
The format of the output of <ref> and <references> is almost completely customizable through MediaWiki messages, that can be modified, for example, through the MediaWiki namespace depending on the configuration of the wiki.
For a list of messages that control the output of <ref> and <references> and the values, if any, that are passed to them ($1, $2, $3 ...), see an up-to-date listing of the default values that can be obtained directly from MediaWiki.
To understand what each parameter means, you can look up the message on translatewiki.net.
Establir que les referències utilitzin ^ i lletres
To replace the default uparrow (↑) with caret (^), modify the following system message. All of these pages can be found on Special:AllMessages.
| Des de | A |
|---|---|
↑
|
^
|
Replacing $2 with $3 changes the links from 1.0, 1.1, 1.2 to a, b, c etc…
| Des de | A |
|---|---|
<sup>[[#$1|$2]]</sup>
|
<sup>[[#$1|$3]]</sup>
|
Searching for these pages for the first time will result in no matches. Simply click "Create this page" to edit the code. The changes will not show up until a page with references is rebuilt.
Set reference and reference number highlighting
Cite/modules/ext.cite.css. Thus that portion of the CSS code below no longer needs to be added manually.Add the following code to the MediaWiki:Common.css page.
/* make the Cite extension list of references look smaller and highlight clicked reference in blue */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }
Hide square brackets around footnote numbers
New approach - Square brackets are wrapped in a span like [, so customization can be accomplished using site-wide or user-specific CSS.
The recommended rule for sites wishing to omit square brackets is to hide the brackets visually, but leave them in the enabled HTML so that they're included when copying and pasting content:
.reference .cite-bracket { font-size: 0; }
Old approach - Customize the MediaWiki:cite_reference_link message to omit square brackets.
This can also be done by adding a span around the brackets, but this is already available now, see above.
Note that customizations using this older approach may interfere with the new styles unless the span is added.
Referències trencades
If the <ref> or <references /> tags are used incorrectly, the Cite extension will add an error message to the page, and will add the page itself to the "Pàgines amb errors a les referències" category.
These error messages will appear in the user interface language, either in the article content or in the References section.
Per exemple:
| Text wiki | Resultat |
|---|---|
This is an example of a references error message.<ref broken>Intended text.</ref>
== Notes ==
<references />
|
This is an example of a references error message.[1] Notes
|