Help:Cite/nb

PD Merk: Når du redigerer denne siden, godtar du at bidraget ditt slippes som CC0. Se Public Domain Help Pages for mer info.
Noen eldre revisjoner av denne siden ble importert under CC BY-SA. Kun nye bidrag er PD.
PD

Cite gjør det mulig å opprette fotnoter på en side.

Se Extension:Cite for de tekniske detaljene.

Bruk

Det grunnleggende konseptet bak <ref>-taggen er at den setter inn teksten den omslutter i en egen seksjon som du kan plassere ved å bruke plassholderen <references />.

Ytterligere plassholdere (<references />) kan settes inn i teksten, og alle <ref>-tagger fram til det punktet, i samme gruppe, blir satt inn der.

Hvis du glemmer å plassere <references /> vil fotnotene likevel vises nederst på siden.

Også her på denne siden kan du finne henvisninger til fotnoter, slik som den på slutten av denne setningen.[note 1] Hvis du undersøker kildekoden på denne siden ved å klikke på «Rediger», kan du se et fungerende eksempel på fotnoter.

Wikitekst Gjengivelse
Sola er ganske stor.<ref>E. Miller, «The Sun», (New York: Academic Press 2005), s. 23–25.</ref> Månen, derimot, er ikke så stor.<ref>R. Smith, «Size of the Moon», «Scientific American», 46 (april 1978): s. 44–46.</ref>

== Fotnoter ==
<references />

Sola er ganske stor.[1] Månen, derimot, er ikke så stor.[2]

Fotnoter
  1. E. Miller, «The Sun», (New York: Academic Press 2005), 23–25.
  2. R. Smith, «Size of the Moon», «Scientific American», 46 (april 1978): s. 44–46.

Gjentatt bruk av samme fotnote

Bruk <ref name="navn"> for å gi en fotnote en unik identifikator. Deretter kan du henvise til den samme fotnoten gjentatte ganger ved å bruke en ref-tagg med samme navn. Teksten i den andre taggen vil ikke få betydning, fordi teksten allerede er oppgitt i den første taggen. Du kan enten kopiere hele fotnoten, eller bruk en selvlukkende ref-tagg som ser slik ut: <ref name="navn" />. Navnene er unike innen sin gruppe̩ ikke globalt – med andre ord kan referansen <ref group="note" name="source-a">...</ref> kun gjenbrukes som <ref group="note" name="source-a" />.

I følgende eksempel brukes samme kilde tre ganger.

Wikitekst Resultat
Dette er et eksempel med flere referanser til samme fotnote.<ref name="multiple">Husk at teksten fra første referanse er den som blir brukt når du refererer til samme fotnote flere ganger.</ref>

Slike referanser er spesielt nyttige hvis forskjellige påstander kommer fra samme kilde.<ref name="multiple" /> Gjenbrukte tagger bør ikke inneholde ekstra innhold, for da oppstår det en feil. Bruk kun tomme tagger i denne rollen.

En konsis måte å lage flere referanser på er å bruke tomme ref-tagger, med en skråstrek på slutten.
Dette vil gjøre at det blir mindre dobbeltarbeid, men vær obs på at de tomme ref-taggene vil slutte å fungere hvis ref-taggen de henviser til blir fjernet.<ref name="multiple" />

== Fotnoter ==
<references />

Dette er et eksempel med flere referanser til samme fotnote.[1]

Slike referanser er spesielt nyttige når man siterer kilder, hvis forskjellige påstander kommer fra samme kilde[1] Gjenbrukte tagger bør ikke inneholde ekstra innhold, for da oppstår det en feil. Bruk kun tomme tagger i denne rollen.

En konsis måte å lage flere referanser på er å bruke tomme ref-tagger, med en skråstrek på slutten. Dette vil gjøre at det blir mindre dobbeltarbeid, men vær obs på at de tomme ref-taggene vil slutte å fungere hvis ref-taggen de henviser til blir fjernet.[1]

Fotnoter
  1. 1 2 3 Husk at hvis du refererer til samme fotnote flere ganger, så er det teksten fra den første referansen som blir brukt.
Merk at identifikatorene som brukes i name-attributtet krever bokstaver; man får en feilmelding om man prøver å bruke kun tall. Det anbefales å alltid bruke sitattegn for navn, og det er obligatorisk dersom navnet inneholder mellomrom eller annen tegnsetting. Det anbefales at navnene holdes enkle og at man begrenser seg til ASCII-tegnsettet.

<references />-taggen

<references />-taggen setter inn teksten til alle siteringene som er definert i <ref>-tagger fram til det punktet på siden. Basert på siteringene ovenfor skal det være en referanse for gruppa note.

Wikitekst Resultat
<references group="note"/>
  1. Denne fotnoten benyttes som et eksempel i seksjonen «Bruk».

Referanselista kan ha responsiv bredde, der den i noen tilfeller viser referansene i flere kolonner. Attributtet responsive brukes til å styre dette. På wikier som bruker standardkonfigurasjonen skjre dette på hver side; på andre wikier må det aktiveres.

Hvis ei side inkluderer mer enn én <references />-liste vil hver liste inkludere <ref>-taggene definert etter forrige referanseliste. Hvis disse referanselistene produseres av maler, vil hver av dem liste opp ref-taggene som defineres før den første referanselista, og en feilbeskjed kommer om at det finnes en ref-tagg, men ingen referanseliste.


Gruppering av referanser

Dette kan deaktiveres med $wgAllowCiteGroups = false;, om man ønsker det.

Følgende eksempel genererer separate referanselister for siteringer og andre fotnoter:

Wikitekst Resultat
I følge forskere er sola ganske stor.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), s. 23–25.</ref> Den er faktisk veldig stor.<ref group="footnotes"> Ta dem på ordet. Ikke se rett inn i sola!</ref>

== Merknader ==
<references group="footnotes" />

== Referanser ==
<references />
I følge forskere er sola ganske stor.[1] Den er faktisk veldig stor.[footnotes 1]
Merknader
  1. Ta dem på ordet. Ikke se rett inn i sola!
Referanser
  1. E. Miller, The Sun, (New York: Academic Press, 2005), s. 23–25.

Den anonyme gruppa fungerer som før, mens referansene som tilhører den navngitte gruppa kun vil dukke opp i tilsvarende <references />-element.

Merk at identifikatorene som brukes i group-attributtet krever bokstaver; man får en feilmelding om man prøver å bruke kun tall. Det anbefales å alltid bruke sitattegn for navn, og det er obligatorisk dersom navnet inneholder mellomrom eller annen tegnsetting. Det anbefales at navnene holdes enkle og at man begrenser seg til ASCII-tegnsettet.

Visningen av en gitt gruppe på tvers av wikien kan skreddersys ved å opprette MediaWiki:Cite_link_label_group-<navn> og liste opp tegnene som skal brukes i den rekkefølgen de skal brukes, atskilt av mellomrom eller linjeskift.

Hvis for eksempel MediaWiki:Cite_link_label_group-lower-alpha opprettes med innholdet

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

vil den første <ref group="lower-alpha">...</ref> vise [a], den andre vil vise [b] osv., og den 26. vil vise [z].

For grupper som har skreddersydd nummerering vil det oppstå en feil dersom det er flere fotnoter enn det er definerte symboler, så den 27. fotnoten i denne gruppa vil produsere en feil.

Følgende gruppenavn defineres ofte som egendefinerte grupper av følgende beskjeder:

gruppenavnbeskjed
upper-alphaMediaWiki:Cite link label group-upper-alpha
lower-alphaMediaWiki:Cite link label group-lower-alpha
upper-romanMediaWiki:Cite link label group-upper-roman
lower-romanMediaWiki:Cite link label group-lower-roman
lower-greekMediaWiki:Cite link label group-lower-greek
Cite link label group-sidene er ikke opprettet som standard. Hvis en wiki ikke har konfigurert disse vil koden <ref group="lower-alpha">...</ref> vises som lower-alpha 1.

Sitering av forskjellige deler av samme kilde

Når forskjellige deler av samme verk brukes som referanser i en artikkel kan du samle dem i referanseseksjonen. Dette gir leserne en enkel måte å identifisere hvilke referanser som kommer fra samme kilde. Det lar deg også sitere forskjellige deler av samme kilde uten å gjenta hele kilden hver gang.

Wikitekst Resultat
I følge forskere er sola ganske stor.<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), s. 23–25.</ref> Den er faktisk veldig stor.<ref extends="Miller">p. 123</ref> Ta dem på ordet. Ikke se rett inn i sola!<ref extends="Miller">p. 42</ref>

== Referanser ==
<references />
I følge forskere er sola ganske stor.[1] Den er faktisk veldig stor.[1.1] Ta dem på ordet. Ikke se rett inn i sola![1.2]
Referanser

1. E. Miller, The Sun, (New York: Academic Press, 2005), s. 23–25.
   1.1 ↑ p. 123
   1.2 ↑ p. 42

Denne funksjonen virker ennå ikke på wikier utenfor betaklyngen, så dette er kun en eksempelvisning. Du kan følge oppdateringer om dette prosjektet på m:WMDE Technical Wishes/Sub-referencing.

Utskilling av referanser fra tekst

Referanser i teksten gjør det enklere å kopiere teksten til en annen side, men de gjør det også vanskeligere å lese den. Referanser inneholder mye data, sitater eller innviklede maler som kan utgjøre en mye større andel av kildeteksten enn det som faktisk blir synlig. For å unngå dette kan man flytte noen eller alle referansene inn i <references />-seksjonen, til stedet der de faktisk vises for leseren.

Wikitekst Resultat
I følge forskere er sola ganske stor.<ref name="miller" /> Månen, derimot, er ikke så stor.<ref name="smith" />

== Merknader ==
<references>
<ref name="miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), s. 23–25.</ref>
<ref name="smith">R. Smith, «Size of the Moon», «Scientific American», 46 (april 1978): s. 44–46.</ref>
</references>

I følge forskere er sola ganske stor.[1] Månen, derimot, er ikke så stor.[2]

Merknader
  1. E. Miller, The Sun, (New York: Academic Press, 2005), s. 23–25.
  2. R. Smith, «Size of the Moon», «Scientific American», 46 (april 1978): s. 44–46.

Koden ovenfor har dermed samme visning som det første eksempelet ovenfor, selv om nummereringen og rekkefølgen på referansene ikke alltid vil være den samme.

Hvis ei gruppe er satt med <references group> trenger man ikke å definere den for hver under-<ref />.

Substitution and embedded parser functions

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

Wikitext Result
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…

  1. This is not working, see "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]].
  2. Whereas this does, see "Search" . Retrieved on 2021-03-11.

Adding an automatic heading before the references list

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

Merging two texts into a single reference

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.

Example:

Wikitext Result
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>

==References==
<references/>

This is an example of merging multiple texts into the same footnote.[1]

[1]

References

  1. Remember that all the texts will be included in the reference containing the name="…" attribute. Simply include the additional text in a tag with the follow="…" attribute, matching the first ref's name.

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


Customization

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.

Set references to use ^ and letters

To replace the default uparrow () with caret (^), modify the following system message. All of these pages can be found on Special:AllMessages.

MediaWiki:Cite reference backlink symbol
From To
^
MediaWiki:Cite references link many format

Replacing $2 with $3 changes the links from 1.0, 1.1, 1.2 to a, b, c etc…

From To
<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

Starting with MediaWiki 1.26 the selectors for highlighting are now incorporated into Cite/modules/ext.cite.css. Thus 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.

Broken references

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 "Sider med feil i referanser" category. These error messages will appear in the user interface language, either in the article content or in the References section. For example:

Wikitext Result
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]

Section
  1. Intended text.

See also

Category:Extension help/nb#Cite
Category:Extension help/nb Category:Pages with reference errors