Help:Referenties

From mediawiki.org
This page is a translated version of the page Help:Cite and the translation is 100% complete.
PD Let op: Als u deze pagina bewerkt, gaat u akkoord met het vrijgeven van uw bijdragen onder de CC0. Zie Helppagina’s Publiek Domein voor meer informatie.
Sommige oude revisies van deze pagina zijn geïmporteerd onder de CC BY-SA licentie. Alleen nieuwe bijdragen zijn publieke domein.
PD

"'Cite"' maakt het mogelijk om voetnoten toe te voegen aan een pagina.

Zie de pagina op Cite extension voor technische details.

Gebruik

Het basisconcept van de ‎<ref>-tag is dat de tekst tussen de ref-tags wordt ingevoegd als een voetnoot in een daarvoor bestemde sectie, die u aangeeft met de placeholder-tag ‎<references />. Dit formaat kan niet door elkaar worden gebruikt met het oudere formaat; u moet het een of het ander kiezen.

Extra placeholder-tags ‎<references /> kunnen in de tekst worden ingevoegd, en alle ‎<ref>-tags tot dan toe in die groep zullen daar worden ingevoegd.

Als u vergeet ‎<references /> in het artikel op te nemen, verdwijnen de voetnoten niet, maar de referenties worden aan het eind van de pagina weergegeven.

Deze pagina zelf gebruikt voetnoten, zoals die aan het einde van deze zin.[note 1] Als u bekijkt de bron van deze pagina door op "Edit deze pagina" te klikken, ziet u een werkend voorbeeld van voetnoot.

Wikitext Resultaat
De zon is vrij groot.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> De maan is echter niet zo groot.<ref>R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>

== Opmerkingen ==
<references />

De zon is vrij groot.[1] De maan is echter niet zo groot.[2]

Opmerkingen
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

Dezelfde voetnoot vaker gebruiken

Als u een voetnoot een unieke identificatie wilt geven, gebruikt u ‎<ref name="name">. U kunt vervolgens opnieuw naar dezelfde voetnoot verwijzen door een referentietag met dezelfde naam te gebruiken. De tekst in de tweede tag maakt niet uit, omdat de tekst al in de eerste referentie staat. U kunt de hele voetnoot kopiëren, of u kunt een lege ref-tag gebruiken die er als volgt uitziet: ‎<ref name="name" />.

In het volgende voorbeeld wordt dezelfde bron drie keer aangehaald.

Wikitext Resultaat
Dit is een voorbeeld van meerdere referenties met dezelfde voetnoot.<ref name="multiple">Vergeet niet dat wanneer u meerdere keren naar dezelfde voetnoot verwijst, de tekst van de eerste referentie wordt gebruikt.</ref>

Deze referenties zijn vooral nuttig als verschillende verklaringen uit dezelfde bron komen.<ref name="multiple" /> Een hergebruikte tag mag geen extra inhoud bevatten, door ontstaat er een fout. Gebruik alleen lege tags in deze rol.

Een beknopte manier om meerdere referenties te maken is met behulp van lege referentietags, die aan het einde een slash hebben.
Hoewel dit overtollige werkzaamheden kan verminderen, moet u er rekening mee houden dat als een toekomstige editor de eerste referentie verwijdert, dit zal leiden tot het verlies van alle referenties met behulp van de lege referentietags.<ref name="multiple" />

== Opmerkingen ==
<references />

Dit is een voorbeeld van meerdere referenties met dezelfde voetnoot.[1]

Deze referenties zijn vooral nuttig als verschillende verklaringen uit dezelfde bron komen.[1] Een hergebruikte tag mag geen extra inhoud bevatten, door ontstaat er een fout. Gebruik alleen lege tags in deze rol.

Een beknopte manier om meerdere referenties te maken is met behulp van lege referentietags, die aan het einde een slash hebben. Een beknopte manier om meerdere referenties te maken is met behulp van lege referentietags, die aan het einde een slash hebben. Hoewel dit overtollige werkzaamheden kan verminderen, moet u er rekening mee houden dat als een toekomstige editor de eerste referentie verwijdert, dit zal leiden tot het verlies van alle referentie met behulp van de lege referentietags.[1]

Opmerkingen
  1. 1.0 1.1 1.2 Vergeet niet dat wanneer u meerdere keren naar dezelfde voetnoot verwijst, de tekst van de eerste referentie wordt gebruikt.
Merk op dat identificaties die in het attribuut name worden gebruikt, alfabetische tekens vereisen; anders zal een foutmelding worden gegenereerd. Aanhalingstekens hebben altijd de voorkeur voor namen en zijn verplicht wanneer de naam een spatie, leesteken of ander teken bevat. Het wordt aanbevolen dat namen eenvoudig en beperkt blijven tot de ASCII-tekensets.


<span id="The_‎<references />_tag">

De tag ‎<references />

De tag ‎<references /> geeft de tekst van alle citaten die zijn gedefinieerd in tags ‎<ref> tot op dat punt in de pagina. Op basis van bovenstaande citaten moet er bijvoorbeeld een referentie naar de groep note zijn.

Wikitext Resultaat
<references group="note"/>
  1. Deze voetnoot wordt als voorbeeld gebruikt in het gedeelte "Hoe te gebruiken".

De referentielijst kan een responsieve breedte hebben (waarbij in sommige gevallen de referenties in meerdere kolommen worden weergegeven). In dat geval wordt het attribuut responsive gebruikt om dat gedrag te configureren. Op wiki's met de standaardconfiguratie gebeurt dit op elke pagina; op andere pagina's moet u deze activeren.

Als een pagina meer dan één lijst ‎<references /> bevat, bevat elke lijst de ‎<ref> tags die zijn gedefinieerd na de vorige referentielist. Als deze referentielijsten worden geproduceerd door sjablonen, wordt elk van hen de ref's vermeld die vóór de eerste referentielijst zijn gedefinieerd. Er wordt een foutmelding gegeven als er een tag ref is, maar geen referentielijst.


Gegroepeerde referenties

Dit kan, indien gewenst, worden uitgeschakeld met $wgAllowCiteGroups = false;.

In het volgende voorbeeld worden afzonderlijke referentielijsten gegenereerd voor citaten en diverse voetnoten:

Wikitext Resultaat
Volgens wetenschappers is de zon vrij groot.<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> Het is eigenlijk heel groot.<ref group="footnotes"> Geloof ze maar op hun woord. Kijk niet direct naar de zon!</ref>

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

==Referenties==
<references />
Volgens wetenschappers is de zon vrij groot.[1] Het is eigenlijk heel groot.[footnotes 1]
Opmerkingen
  1. Geloof ze maar op hun woord. Kijk niet direct naar de zon!
Referenties
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.

De anonieme groep werkt als voorheen, terwijl referenties voor de groep met een naam alleen in het aangewezen element ‎<references /> worden weergegeven.

Merk op dat identificaties die in het attribuut group worden gebruikt, alfabetische tekens vereisen; anders zal een foutmelding worden gegenereerd. Aanhalingstekens hebben altijd de voorkeur voor namen en zijn verplicht wanneer de naam een spatie, leesteken of ander teken bevat. Het wordt aanbevolen dat namen eenvoudig en beperkt blijven tot de ASCII-tekensets.

De weergave van een bepaalde groep kan over de hele wiki worden aangepast door MediaWiki:Cite_link_label_group-<name> aan te maken en de gebruikte tekens weer te geven in de volgorde waarin ze verschijnen, gescheiden door spaties of nieuwe regels.

Als bijvoorbeeld MediaWiki:Cite_link_label_group-lower-alpha wordt gemaakt met de inhoud

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

dan geeft de eerste <ref group="lower-alpha">...</ref> [a], de tweede [b], en zo verder, de 26e [z].

Het is een fout om meer voetnoten te gebruiken in een op maat gemaakte groep dan het aantal gedefinieerde tekens, dus de 27e voetnoot in deze groep veroorzaakt een fout.

De volgende groepsnamen worden vaak gedefinieerd als aangepaste groepen door de volgende berichten respectievelijk:

groepsnaam bericht
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
De Cite link label group pagina's zijn niet standaard aangemaakt. Als een wiki ze niet configureert, zal een markering zoals <ref group="lower-alpha">...</ref> als lower-alpha 1 weergeven.

Citeren van verschillende delen van dezelfde bron

Wanneer verschillende delen van hetzelfde werk als referenties in een artikel worden gebruikt, kunt u ze in het referentiedeel clusteren. Hierdoor kunnen lezers zien welke referenties uit dezelfde bron komen. Het stelt u ook in staat om verschillende delen van dezelfde bron te citeren zonder elke keer de hele bron te herhalen.

Wikitext Resultaat
Volgens wetenschappers is de zon vrij groot.<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005).</ref> Het is eigenlijk heel groot.<ref extends="Miller">p. 123</ref> Geloof ze maar op hun woord. Kijk niet direct naar de zon!<ref extends="Miller">p. 42</ref>

==Referenties==
<references />
Volgens wetenschappers is de zon vrij groot.[1] Het is eigenlijk heel groot.[1.1] Geloof ze maar op hun woord. Kijk niet direct naar de zon![1.2]
Referenties

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

Deze functie werkt nog niet op wiki's buiten de beta-cluster, daarom is het bovenstaande voorbeeld een vervalsing. U kunt de projectupdate hier volgen.

Referenties scheiden van tekst

In de tekst zijn er referenties waardoor het gemakkelijk is om de tekst naar een andere pagina te kopiëren; aan de andere kant maken ze het moeilijk te lezen. Referenties met veel gegevens, citaten of uitgebreide citaatvormen kunnen een aanzienlijk groter deel van de bron vormen dan de tekst die daadwerkelijk zichtbaar is. Om dit te voorkomen, kunnen recente versies van de uitbreiding sommige of alle verwijzingen naar de sectie ‎<references /> verplaatsen, naar de plaats waar de lezer ze daadwerkelijk zal zien.

Wikitext Resultaat
Volgens wetenschappers is de zon vrij groot.<ref name="miller" /> De maan is echter niet zo groot.<ref name="smith" />

== Opmerkingen ==
<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>

Volgens wetenschappers is de zon vrij groot.[1] De maan is echter niet zo groot.[2]

Opmerkingen
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

De bovenstaande code zal dus dezelfde uitvoer hebben als het eerste voorbeeld hierboven, hoewel de nummering en volgorde van de referenties over het algemeen niet hetzelfde zullen zijn.

Substitutie en ingebedde parserfuncties

Aangezien de ‎<ref> tag van Cite wordt geanalyseerd voor de parserfuncties van MediaWiki (bijv. {{#ifexpr:…}}) of variabelen (bijv. {{PAGENAME}}) of voor subst:, werken deze niet binnen citatiereferenties. In plaats daarvan moet u het magische woord {{#tag:…}} gebruiken.

Wikitext Resultaat
Foo<ref>Dit werkt niet, zie {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|Dit werkt wel, zie {{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. Dit werkt niet, zie "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]]. 
  2. Dit werkt wel, zie "Search" . Retrieved on 2021-03-11. 

Toevoegen van een automatische kop voor de referentielijst

Tot op MediaWiki 1.28, kon men het systeembericht MediaWiki:Cite references prefix gebruiken om een wiki-brede kop te definiëren die automatisch zou worden ingevoegd voor elke referentielist. In MediaWiki 1.29, is dit systeembericht verwijderd. Een manier om een kopregel toe te voegen is om de volgende code toe te voegen aan MediaWiki:Common.js:

$(document).ready(function(){
    $('.mw-references-wrap').before('<h2>Referenties</h2>');
});

Let op dat dit de kop onvoorwaardelijk toevoegt, d.w.z. als u de kop al heeft, wordt deze opnieuw toegevoegd, waardoor dubbele koppen worden gecreëerd.

Als u alleen een tekst kop nodig heeft (geen link of andere actieve elementen) kunt u het volgende toevoegen aan 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;
}

Samenvoegen van twee teksten tot één referentie

Een typisch Wikisource-probleem zijn referenties die meerdere pagina's in het bronmateriaal omvatten. Deze kunnen worden samengevoegd met behulp van een tag ‎<ref name="name"> voor het eerste deel van de referentie, en het taggen van de volgende delen met een tag ‎<ref follow="name"> met dezelfde naam.

Voorbeeld:

Wikitext Resultaat
Dit is een voorbeeld van het samenvoegen van meerdere teksten in dezelfde voetnoot.<ref name="main">Onthoud dat alle teksten in de referentie worden opgenomen met het attribuut name="…".</ref>

<ref follow="main">Voeg de aanvullende tekst gewoon toe in een tag met het follow="…"-attribuut, dat overeenkomt met de naam van de eerste ref.</ref>

==Referenties==
<references/>

Dit is een voorbeeld van het samenvoegen van meerdere teksten in dezelfde voetnoot.[1]


Referenties

  1. Onthoud dat alle teksten in de referentie worden opgenomen met het attribuut name="…". Voeg de aanvullende tekst gewoon toe in een tag met het follow="…"-attribuut, dat overeenkomt met de naam van de eerste ref.

Let er dan op dat het "follow" gedeelte van de voetnoot op dezelfde pagina staat als het eerste deel van de referentie.

Merk op dat referentienamen niet kunnen beginnen met een getal, het bevat dus altijd een tekst zoals <ref name="p32"> en <ref follow="p32">.


Aanpassen

Het formaat van de uitvoer van ‎<ref> en ‎<references> is bijna volledig aanpasbaar via MediaWiki systeemberichten, die bijvoorbeeld kunnen worden gewijzigd via de MediaWiki-namespace, afhankelijk van de configuratie van de wiki.

Voor een lijst van systeemberichten die de uitvoer van ‎<ref> en ‎<references> regelen en de waarden, indien van toepassing, die aan hen worden doorgegeven ("$1, $2, $3...), zie een up-to-date lijst van de standaardwaarden die rechtstreeks van MediaWiki kunnen worden verkregen.

Onvolledige lijst
  • cite_reference_link_key_with_num
    1. key
    2. num
  • cite_reference_link_prefix
  • cite_reference_link_suffix
  • cite_references_link_prefix
  • cite_references_link_suffix
  • cite_reference_link
    1. ref ID
    2. backlink ID
    3. aantal te tonen
  • cite_references_link_one
    • Wordt gebruikt om de bronlijst die ‎<references /> geeft te formatteren, het configureert 3 dingen: de backlink-ID, de refer-ID en de tekst van de notitie.
    1. backlink ID — Gebruikt voor het maken van de nummervolgorde van de bronlijst.
    2. ref ID — Gebruikt om terug te koppelen aan de feitelijke referentie in de tekst, hier kunt u het symbool ^ configureren.
    3. tekst van notitie — tekst gebruikt boven de beschrijving van de broninformatie
  • cite_references_link_many
    1. backlink ID
    2. lijst met links
    3. tekst van notitie
  • cite_references_link_many_format
    1. ref ID
    2. numerieke waarde om te gebruiken als backlink
    3. aangepaste waarde (zoals gedefinieerd in cite_references_link_many_format_backlink_labels om als backlink te gebruiken)
  • cite_references_link_many_format_backlink_labels
  • cite_references_link_many_sep
  • cite_references_link_many_and
  • cite_references_suffix

Stel referenties in voor het gebruik van ^ en letters

Als u de standaardpijl omhoog (↑) wilt vervangen door het dakje (^), wijzigt u het volgende systeembericht. Al deze pagina's zijn te vinden op Special:AllMessages.

MediaWiki:Cite reference backlink symbol
Van Naar
^
MediaWiki:Cite references link many format

Het vervangen van $2 door $3 verandert de links van 1.0, 1.1, 1.2 naar a, b, c etc...

Van Naar
<sup>[[#$1|$2]]</sup>
<sup>[[#$1|$3]]</sup>

Als u deze pagina's voor het eerst zoekt, komt er geen match op. Klik eenvoudig op "Deze pagina aanmaken" om de code te bewerken. De wijzigingen worden pas weergegeven als een pagina met referenties is herbouwd.

Instellen markering referentie- en referentienummer

Vanaf MediaWiki 1.26 worden de selectoren voor het markeren nu opgenomen in Cite/modules/ext.cite.css. De onderstaande CSS-code hoeft dus niet langer handmatig toegevoegd te worden.

Voeg de volgende code toe aan pagina MediaWiki:Common.css.

/* Maak de referentielijst van de extensie Cite kleiner en markeer de geklikte referentie blauw */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }


Pagina waaraan wordt gerefereerd bestaat niet

Als de tags ‎<ref> of ‎<references /> verkeerd worden gebruikt, voegt Cite een foutmelding toe aan de pagina en voegt het de categorie "Pagina's met referentiefouten" toe. Deze foutberichten verschijnen in de taal van de gebruikersinterface, in de inhoud van het artikel of in het gedeelte Referenties. Bijvoorbeeld:

Wikitext Resultaat
Dit is een voorbeeld van een foutmelding over een referentie.<ref broken>Beoogde tekst.</ref>

== Opmerkingen ==
<references />

Dit is een voorbeeld van een foutmelding over een referentie.Cite error: Invalid parameter in <ref> tag

Opmerkingen

Zie de specificaties voor de Parsoid's Cite fouten.

Zie ook