WMDE Technical Wishes/Sub-referencing/nl
| Subreferentie | |
|---|---|
| Status | In ontwikkeling |
| Origin | Technische Wensen enquête 2013, 2015, 2022 en andere |
| Focus area | Maak het hergebruiken van referenties eenvoudiger |
| Phabricator | projectbord |
| Responsible | Team Technische Wensen |
Vertel ons wat u ervan vindt We nodigen u uit om de functie te testen dat we voortdurend updaten. Houd deze pagina in de gaten of schrijf u in op deze nieuwsbrief om te weten te komen welke nieuwe dingen u kunt testen | |
Op dit moment is het niet mogelijk om eenvoudig dezelfde referentie met andere details opnieuw te gebruiken in een artikel. Leden van de gemeenschap hebben herhaaldelijk gevraagd om een MediaWiki-oplossing die zonder sjablonen werkt en gebaseerd is op de bestaande manier waarop referenties werken, voor zowel wikitext als VisualEditor. Meer informatie over het probleem
Als onderdeel van het focusgebied "Maak het hergebruik van referenties gemakkelijker", introduceert het team Technical Wishes van Wikimedia Duitsland subreferenties gebruiken - een optionele functie waarmee u gemakkelijk verschillende details aan een bestaande referentie kunt toevoegen, zonder deze te hoeven dupliceren.
Subreferenties zijn sinds augustus 2026 ingezet op alle Wikimedia-wiki's behalve op de Engelse Wikipedia, rechts-naar-links wiki's en Wikisource-wiki's. Ons plan is om in 2026 subreferenties naar alle Wikimedia-wiki's te brengen.
Beknopte beschrijving van het toevoegen van subreferenties
Om een bron met verschillende details meer dan één keer te citeren, is een hoofdreferentie en een subreferentie nodig.
- De hoofdreferentie bevat de belangrijkste bibliografische informatie. In de onderstaande schermafbeelding is "1. E. Miller …" in het gedeelte Verwijzingen de belangrijkste referentie.
- Een subreferentie definieert aanvullende details, zoals paginanummers, hoofdstukken, verzen, citaten of video-tijdstempels. In de schermafbeelding vertegenwoordigen "1.1" en "1.2", gevolgd door een paginanummer, twee verschillende subreferenties.

- In de sectie referenties zien lezers alle subreferenties gegroepeerd onder hun gedeelde hoofdreferentie. Dit maakt het gemakkelijker om te begrijpen hoe vaak een enkele bron in het artikel is geciteerd.
- In wikitext gebruikt u een nieuw attribuut om de details van een subreferentie te definiëren. Dit heet
details. Zie hieronder voor meer informatie en voorbeelden. - In VisualEditor, we breiden het bestaande citatiedialoogvenster uit zodat het subreferenties ondersteunt.
Belangrijkste voordelen
- Subreferentie is grotendeels gebaseerd op de bestaande manier waarop referenties werken.
- Het is ontworpen om te werken voor zowel VisualEditor als Wikitext.
- De oplossing zal in de MediaWiki extensie Cite worden geïntegreerd, dus beschikbaar zijn op alle Wikimedia-wiki's en bruikbaar zonder op sjablonen gebaseerde tijdelijke oplossingen.
- Subreferenties worden correct weergegeven in Referentievoorbeelden en pop-ups met mobiele referenties.
- Het is optioneel: u kunt nog steeds andere methoden gebruiken voor het refereren. Maar u kunt subreferenties tegenkomen in artikelen die door andere gebruikers zijn geschreven.

- Test de functie! Lees meer over hoe u kunt testen.
- Geef algemene feedback op de overlegpagina.
- Volg deze pagina of meld u aan voor deze mailinglijst om meer te weten te komen over nieuwe dingen die u kunt testen.
Hoe het werkt
In wikitext
De wikitext-oplossing voor subreferenties kan al getest worden op de bètacluster. Specieke voordelen van de wikitext:
- De oplossing gebruikt het bestaande en bekende concept van benoemde referenties.
- Het vereist geen kennis van sjablonen.
- Bijna dupliceerde referenties kunnen worden verwijderd uit de wikitext, waardoor het schoner, minder overbodig en gemakkelijker te lezen is.
Een hoofdreferentie definiëren
Voordat u subreferenties kunt aanmaken, heeft u een hoofdreferentie nodig die de volledige bibliografische informatie bevat. Aan deze referentie moet een naam worden toegewezen:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
Deze hoofdreferentie kan in de tekst van het artikel (in-line) of in het referentiedeel worden gedefinieerd.
Een subreferentie voor in-line referenties maken
Als de hoofdreferentie in-line is, kunt u een subreferentie op twee manieren maken met behulp van het attribuut details:
Optie 1: Wijzig de hoofdreferentie om aanvullende details toe te voegen (bijvoorbeeld een paginanummer)
<!-- Voeg het attribuut details direct toe aan de tag <ref> -->
<ref name="Miller" details="p. 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- Als volgende stap kunt u een andere subreferentie toevoegen met de volgende verklaring: -->
<ref name="Miller" details="p. 48." />
Voorbeeld:
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot. Het is eigenlijk heel groot.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/>
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers is de zon vrij groot. Het is eigenlijk heel groot.[1.1] Geloof ze maar op hun woord.[1.2]
|
Optie 2: Voeg een of meer afzonderlijke subreferenties rechtstreeks in een nieuwe inline-instructie in, terwijl u de hoofdreferentie intact laat.
<!-- Onveranderde hoofdrefentie (in-line): -->
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- Nieuwe subreferenties: -->
<ref name="Miller" details="p. 23." />
<ref name="Miller" details="p. 48." />
Voorbeeld:
| 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 name="Miller" details="p. 23" /> Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/>
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers is de zon vrij groot.[1] Het is eigenlijk heel groot.[1.1] Geloof ze maar op hun woord.[1.2]
|
Subreferenties maken voor lijstgedefinieerde referenties
Als de hoofdreferentie is opgeslagen in de <references>-tag, hoeft u deze niet in-line opnieuw te definiëren. Gebruik in plaats daarvan gewoon in-line de volgende syntaxis:
<!-- Voeg dit direct toe aan de gekozen locatie in de artikeltekst -->
<ref name="Miller" details="p. 23." />
<!-- De lijstgedefineerde referentie wordt niet gewijzigd: -->
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
Voorbeeld:
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot. Het is eigenlijk heel groot.<ref name="Miller" details="p. 23" /> Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/>
== Referenties ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
According to scientists, the Sun is pretty big. In fact, it is very big.[1.1] Geloof ze maar op hun woord.[1.2]
|
Let op: we raden af om {{reflist|refs=...}} te gebruiken voor lijstgedefinieerde referenties, omdat dit problemen veroorzaakt voor VisualEditor-gebruikers.
Hergebruik van bestaande subreferentie
Als een subreferentie is gedefinieerd, kunt u deze op meerdere plaatsen hergebruiken zonder de hoofdreferentie opnieuw te definiëren. Herhaal gewoon dezelfde syntaxis:
<ref name="Miller" details="Page 23." />
- NB: Dit is weliswaar geen regulier hergebruik zoals u gewend bent van hoofdreferenties is, omdat er duplicaten in wikitext ontstaan, maar in de reader en de VisualEditor worden identieke statements samengevoegd om onnodige duplicatie in de opgebouwde uitvoer te voorkomen.
- Dezelfde hergebruiksoptie werkt al voor reguliere referenties (zowel in de lijst als inline).
- Tip: Het kopiëren en plakken van een bestaande subreferentie statement blijft een eenvoudige en aanbevolen aanpak.
Voorbeeld van het hergebruik van inline subreferenties:
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Het is eigenlijk heel groot. Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/> Kijk niet rechtstreeks naar de zon!<ref name="Miller" details="p. 23" />
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers is de zon vrij groot.[1.1] Het is eigenlijk heel groot. Geloof ze maar op hun woord.[1.2] Kijk niet rechtstreeks naar de zon![1.1]
|
Voorbeeld - hergebruik van lijstgedefinieerde subreferenties:
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot.<ref name="Miller" details="p. 23" /> Het is eigenlijk heel groot. Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/> Kijk niet rechtstreeks naar de zon!<ref name="Miller" details="p. 23" />
== Referenties ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
Volgens wetenschappers is de zon vrij groot. Het is eigenlijk heel groot.[1.1] Geloof ze maar op hun woord.[1.2] Kijk niet rechtstreeks naar de zon![1.1]
|
Bestaande referenties omzetten naar subreferenties
Bewerk de referentie die de nieuwe hoofdreferentie moet worden door details zoals paginanummers toe te wijzen aan het nieuwe details="…" attribuut, Vervang gelijkaardige referenties door subreferenties.
Voorbeeld: Wikitext zonder subreferenties:
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers,<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005, blz. 23.</ref> de zon is vrij groot.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, blz. 30.</ref> Het is eigenlijk heel groot.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, blz. 35.</ref> Geloof ze maar op hun woord.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, blz. 48.</ref> Kijk niet rechtstreeks naar de zon!<ref name="Miller" />
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers,[1] de zon is vrij groot.[2] Het is eigenlijk heel groot.[3] Geloof ze maar op hun woord.[4] Kijk niet rechtstreeks naar de zon![1]
|
Voorbeeld: Wikitext zodra referenties zijn geconverteerd naar subreferenties
Merk op dat de eerste referentie is omgezet in een hoofdreferentie (inclusief details), de andere referenties zijn omgezet naar subreferenties.
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers,<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> de zon is vrij groot.<ref name="Miller" details="p. 30" /> Het is eigenlijk heel groot.<ref name="Miller" details="p. 35" /> Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/> Kijk niet rechtstreeks naar de zon!<ref name="Miller" details="p. 23" />
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers,[1.1] de zon is vrij groot.[1.2] Het is eigenlijk heel groot.[1.3] Geloof ze maar op hun woord.[1.4] Kijk niet rechtstreeks naar de zon![1.1]
|
Subreferenties nesten
Het is mogelijk om geneste voetnoten te gebruiken met subreferenties. Nesten op meerdere niveaus werkt waarschijnlijk ook, hoewel dit niet actief wordt ondersteund.
Voorbeeld: Subrefeenties nesten met behulp van {{refn}}
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Het is eigenlijk heel groot.{{refn|group="notes"|Sommige wetenschappers zijn het er niet mee eens.<ref details="p. 30." name="Miller" />}} Geloof ze maar op hun woord.<ref name="Miller" details="p. 48"/>
== Opmerkingen ==
<references group="notes" /> <!-- of {{reflist|group=notes}} -->
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers is de zon vrij groot.[1.1] Het is eigenlijk heel groot.[notes 1] Geloof ze maar op hun woord.[1.3]
|
Sjablonen en subreferenties
Sjablonen kunnen worden gebruikt in de sub- en hoofdreferenties net als bij gewone referenties.
Voorbeeld: Subreferenties gebruiken het voorbeeld sjabloon {{Subref}}
| Wikitext | Resultaat |
|---|---|
Volgens wetenschappers is de zon vrij groot.<ref name="Miller" details="{{Subref|page=23|quote=It's soo big}}">{{Cite book |last=Miller |first=E. |title=The Sun |publisher=Academic Press |location=New York |date=2005}}</ref> Het is eigenlijk heel groot. Geloof ze maar op hun woord.<ref name="Miller" details="{{Subref|page=48}}" /> Kijk niet rechtstreeks naar de zon!<ref name="Miller" details="{{Subref|page=50|quote=Don't do it}}" />
== Referenties ==
<references /> <!-- of {{reflist}} -->
|
Volgens wetenschappers is de zon vrij groot.[1.1] Het is eigenlijk heel groot. Geloof ze maar op hun woord.[1.2] Kijk niet rechtstreeks naar de zon![1.3]
|
Houd in gedachten

- Vergeet niet om altijd een referentienaam op te geven wanneer u het kenmerk 'details' gebruikt. Door een referentienaam te gebruiken, kunnen anderen dezelfde referentie eenvoudig hergebruiken met andere details, zonder eerst een naam te hoeven definiëren.
- Subreferenties zijn niet alleen voorbehouden aan paginanummers. U kunt het ook voor andere doeleinden gebruiken. Sommige redacteuren hebben ons laten weten dat ze het willen gebruiken voor podcast-tijdstempels, URL's, gedichten, citaten en andere details.
- Als u aanhalingstekens
"binnendetails="…"wilt gebruiken (bijvoorbeeld bij het invoegen van een citaat), zorg er dan voor dat u"gebruikt of de details begrenst met enkele aanhalingstekens. Gebruikers van de VisualEditor kunnen " typen bij het invullen van subreferentiegegevens en deze worden automatisch omgezet naar wikitext. Andere speciale tekens die mogelijk op een vergelijkbare manier moeten worden verwerkt in combinatie metdetails="…"zijn<en>. - Sommige gadgets/scripts die verband houden met referenties kunnen ook een update nodig hebben om goed te kunnen werken met de nieuwe subreferentieoplossing.
- Vermijd bij het gebruik van subreferentie sjablonen die
<ref>-tags produceren. Deze veroorzaken namelijk problemen in VisualEditor die we op dit moment niet kunnen oplossen.
In VisualEditor
U kunt de huidige versie van de VisualEditor-oplossing testen. Houd er rekening mee dat er nog dingen kunnen veranderen. Voordelen specifiek voor de VisualEditor:
- Om dezelfde bron met verschillende details te citeren, hoeft u niet langer een nieuwe referentie te maken.
- Subreferenties zijn ontworpen om volledig compatibel te zijn met VisualEditor (in tegenstelling met op sjablonen gebaseerde tijdelijke oplossingen).
Een hoofdreferentie definiëren
- Gebruik het bestaande citatiedialoogvenster om een hoofdreferentie te maken die de volledige bibliografische informatie bevat, met uitzondering van de details (bijv. paginanummers) die u in subreferenties wilt gebruiken.
Een subreferentie aanmaken
- Selecteer een hergebruikte referentie of maak een hergebruik (door een referentie te kopiëren en te plakken of door het dialoogvenster voor hergebruik van citaties te gebruiken).
- Klik op de knop om details toe te voegen in de referentie pop-up als de referentie wordt hergebruikt.

- Voer de details van die subreferentie in en klik op de knop voor opslaan van de wijzigingen.

Een subreferentie bewerken
- Klik op de voetnoot-marker in de tekst van het artikel en kies de tweede bewerkingsknop (pictogram pen) om een subreferentie te bewerken.

- U kunt nu de details van de subreferentie bewerken. U wordt ook geïnformeerd dat het een subreferentie is.

- U kunt een subreferentie niet bewerken door erop te klikken in de referentielijst - het bewerken van de hoofdreferentie op deze manier werkt zoals gewoonlijk.
Een subreferentie wijzigen
- U kunt een subreferentie opnieuw gebruiken met behulp van het tabblad "hergebruiken" in de citatie-dialoog.

- Als alternatief kunt u - net als bij reguliere referenties - de voetnoot van een subreferentie selecteren en deze naar de gewenste locatie in het artikel kopiëren met behulp van copy & paste, wat ook een hergebruik creëert.
Bestaande referenties omzetten naar subreferenties
- Selecteer een hergebruikte referentie (of hergebruik een referentie).
- Klik op bewerken, kopieer de details die u wilt gebruiken voor de subreferentie (bijv. het paginanummer) en verwijder de details om van de referentie een hoofdreferentie te maken.
- Klik op de knop "Details toevoegen".

- Plak (of vul) de gegevens in die u zojuist heeft verwijderd en klik op de knop om de wijzigingen vast te leggen.

- Vervang andere soortgelijke referenties door hergebruik van de hoofdreferentie en voeg voor elk van deze details toe.
Sjablonen en subreferenties
Sjablonen kunnen worden gebruikt in de sub- en hoofdreferenties net als bij gewone referenties.
- Klik op de knop "Details toevoegen".

- Gebruik de knop "insert" om een sjabloon te kiezen.

- Gebruik de dialoog om het gewenste sjabloon te zoeken.

- Vul de formulierparameters in en voeg het sjabloon toe.

- De subreferentie wordt nu weergegeven met het sjabloon.

Aandachtspunten
- Het bestaande gedrag van aanmaken automatische namen voor hergebruik van referenties in de VisualEditor doet zich ook voor bij subreferenties. Het oplossen van dit probleem valt buiten het bestek van dit project, maar we werken aan verbeteringen als onderdeel van ons nieuwe project op VisualEditor genereerde automatisch referentienamen.
De functie testen
We hebben uw feedback nodig om ervoor te zorgen dat we de juiste dingen bouwen. Feedback of vragen zijn altijd welkom op de overlegpagina van dit project of door rechtstreeks een gesprek aan te vragen met onze 'User Researcher'. De functie is beschikbaar op de beta-wiki en de meeste Wikimedia wiki's.

- Ze kunnen er anders uitzien (bijvoorbeeld niet met uw gekozen skin).
- Ze kunnen nieuwe functies bieden die nog steeds worden getest.
- Ze bevatten slechts enkele testpagina's en sjablonen, niet de hele inhoud van uw wiki, en niet alle sjablonen en modules, gadgets, enz. waaraan u gewend bent.
- Uw normale Wikimedia-login werkt niet op bèta-wiki's. U kunt een account registreren. Zorg ervoor dat u een ander wachtwoord gebruikt dan uw gewone Wikimedia-account. U kunt de functie ook testen zonder een account, wat zal leiden tot het aanmaken van een tijdelijk account.
Voortgang
Subrefereren is nu klaar in Wikitext en VisualEditor en geïmplementeerd in de meeste Wikimedia wiki's. Enkele van onze volgende stappen:
- Hoewel er geen problemen zijn met reguliere verschillen (diffs), geven visuele verschillen nu subreferenties niet correct weer (phab:T434055).
- Nieuwe regels in subreferenties in wikitext worden nu niet geladen in VisualEditor (phab:T390266).
- We evalueren mogelijke verbeteringen van de weergave voor lezers zoals vermeld in ons rapport.
Het probleem dat we oplossen
In Wikipedia-artikelen is het gebruikelijk om meerdere keren naar een bron te refereren. Maar hoewel u een referentie precies zoals het is kunt hergebruiken, kunt u nu niet dezelfde referentie hergebruiken met verschillende details (bijv. verschillende paginanummers). Uw enige optie is om een geheel nieuwe referentie te maken of om tijdelijke oplossingen te gebruiken.
Status quo: hergebruik van referenties in wikitext en VisualEditor
Als u een referentie in wikitext wilt hergebruiken, kunt u er een benoemde referentie van maken en op een ander punt in het artikel naar die naam verwijzen. De benoemde referentie kan in de tekst van het artikel of in de sectie referenties worden geplaatst. In de VisualEditor kunt u de optie "hergebruiken" gebruiken in het citaat dialoogvenster. In de sectie referenties worden referenties met dezelfde naam gegroepeerd.
-
Wikitext: <ref name> in de artikeltekst
-
Wikitext: <ref name> in de sectie referenties
-
VisualEditor: dialoog citaten
-
Weergave op scherm
Status quo: Hergebruik van referenties met verschillende details in wikitext
Als u een bestaande referentie met andere details in wikitext wilt hergebruiken, moet u nu de bestaande referentie kopiëren en plakken en de details van het duplicaat wijzigen of een nieuwe (bijna identieke) referentie helemaal opnieuw maken. Sommige projecten gebruiken tijdelijke oplossingen zoals korte citaten of op sjablonen gebaseerde oplossingen zoals verkorte voetnoten. In de sectie referenties worden de oorspronkelijke referentie en de nieuwe die u heeft gemaakt niet gegroepeerd.
-
Twee bijna identieke referenties in de wikitext.
-
Weergave op scherm: Bijna identieke referenties worden niet in groepen opgenomen
-
Tijdelijke oplossing met korte citaten in wikitext
-
Weergave op scherm: tijdelijke oplossing met korte citaten
-
Tijdelijke oplossing met {{sfn}} in wikitext
-
Weergave op scherm: tijdelijke oplossing met {{sfn}}
Status quo: Hergebruik van referenties met verschillende details in VisualEditor
Als u een bestaande referentie met andere details in de VisualEditor wilt hergebruiken, kunt u de optie Hergebruiken in de dialoog voor het citeren en ook de kopieer-en-plak-methode niet gebruiken, omdat beide leiden tot "identiek" hergebruik, en het wijzigen van details van de hergebruikte/gekopieerde referentie verandert "beide" instanties van die referentie. In plaats daarvan moet u een geheel nieuwe (bijna identieke) referentie maken. In de sectie referenties worden de oorspronkelijke referentie en de nieuwe die u heeft gemaakt niet gegroepeerd.
Referenties die zijn gemaakt door op sjablonen gebaseerde tijdelijke oplossingen zoals {{sfn}}, kunnen niet worden bewerkt vanuit de sectie referenties en worden niet weergegeven op het tabblad hergebruik van citaten; Maar het is mogelijk om ze handmatig te bewerken wanneer u ze in de artikeltekst plaatst.
tijdelijke oplossing met {{sfn}}:
-
Weergave op scherm
-
De referenties verdwijnen uit de sectie referenties wanneer u op "bewerken" klikt.
-
Het is niet mogelijk om {{sfn}}-referenties te gebruiken via de dialoog "hergebruik".
-
Referenties kunnen alleen worden bewerkt wanneer de referentie in de artikeltekst staat
Problemen voor lezers
Op sjablonen gebaseerde tijdelijke oplossingen worden niet correct weergegeven in Referentie previews, Referentie-tooltips en pop-ups voor mobiele referenties.
{{sfn}} tijdelijke oplossing met voorbeelden van referenties:
-
Referentie previews: De belangrijkste informatie is niet opgenomen in de pop-up.
-
Referentie Tooltips: De belangrijkste informatie is niet opgenomen in de eerste pop-up.
-
Referentie tooltips: De belangrijkste informatie wordt getoond in een andere pop-up.
-
mobiele referentie pop-ups: De belangrijkste informatie is niet inbegrepen.
Belangrijkste problemen met de status quo
- De ervaring van gebruikers van VisualEditor en wikitext is heel verschillend.
- De meeste tijdelijke oplossingen voor het hergebruiken van referenties met verschillende details werken niet goed in VisualEditor.
- Het creëren van veel bijna identieke referenties met verschillende details maakt de wikitext langer en mogelijk moeilijker te lezen.
- Op sjablonen gebaseerde tijdelijke oplossingen worden niet door alle gemeenschappen in gelijke mate geaccepteerd en zijn dus niet wereldwijd beschikbaar.
- Sommige gebruikers proberen dit probleem te vermijden door bronnen in de sectie bibliografie te plaatsen zonder ze als referentie te gebruiken, wat het moeilijker maakt om secties van het artikel te verifiëren.
Recente wijzigingen en volgende stappen
Ons team heeft al geruime tijd af en toe aan aan dit probleem gewerkt. Hier is een overzicht van de geschiedenis van dit project, inclusief ons onderzoek.
Dank aan iedereen die heeft deelgenomen aan de tests en interviews en die interesse heeft getoond, evenals iedereen die in de loop der jaren de tijd heeft genomen om commentaar te geven op onze overlegpagina's. Het wordt zeer gewaardeerd. Als u meer feedback heeft, geef dat dan op de overlegpagina.
Updates
We hebben het in september 2025 in gebruik genomen voor de Duitse Wikipedia als onze eerste pilot wiki.
Lees meer over onze ervaringen en observaties na drie maanden subreferentie op de Duitse Wikipedia.
We hebben het in februari 2026 in 9 extra pilot wiki's mogelijk gemaakt (inclusief Poolse en Zweedse). (phab:T418209)
We hebben in april 2026 subreferenties op de Tsjechische en Italiaanse Wikipedia ingevoerd. (phab:T420938)
We hebben in juni 2026 subreferenties naar de Franse Wikipedia en de meeste wiki's die niet van Wikipedia zijn, ingevoerd. (phab:T425662)
We hebben in juni 2026 subreferenties in de Azerbeidzjaanse, Catalaanse, Nederlandse, Portugese en Spaanse Wikipedia en veel kleinere taalversies van Wikipedia ingevoerd. (phab:T428902)
We hebben in juli 2026 subreferenties naar de Finse, Griekse, Hongaarse, Thaise en Turkse Wikipedia ingevoerd. (phab:T430941)
We hebben in augustus 2026 subreferenties in de Chinese, Indonesische, Japanse, Koreaanse, Russische, Simpel, Oekraïense en Vietnamese Wikipedia ingevoerd. (phab:T432731)
We verbeteren de functie continu en implementeren feedback van de gemeenschap.
Volgende stappen
De focus van het team blijft liggen op het voltooien van de functie subreferentie.
- We zullen u voortdurend inlichten naarmate de functie zich ontwikkelt op de betawiki en we willen dat u het test.
- We zijn van plan om in de komende maanden de functie te implementeren in de Engelstalige Wikipedia, evenals rechts-naar-links taalwiki's en Wikisource-wiki's.
- Bekijk ons rapport en phab:T414094 voor ons implementatieplan en onze roadmap voor aankomende verbeteringen.
- We zullen de feedback blijven verzamelen om de functie na de globale implementatie te verbeteren.
Gearchiveerde updates uit 2025
In 2024 hebben we gewerkt aan een prototype voor ontdekking- en testdoeleinden op basis van de extends-syntaxis. Ook hebben we samengewerkt met de community via meerdere on-wiki-communicaties, gebruikerssessies en workshops op verschillende locaties, waaronder Wikimania 2024.
In oktober/november 2024 hebben we mogelijke wijzigingen in onze wikitext-aanpak onderzocht, gebaseerd op de feedback die we van de gemeenschap hebben ontvangen. We hebben contact opgenomen met gemeenschappen en een nieuwe oplossing gepresenteerd om feedback te krijgen over de bruikbaarheid ervan. We constateerden gemengde reacties, maar niets sprak tegen dat de functie de beoogde waarde voor de gemeenschap zou opleveren.
In 2025 begonnen we met de ontwikkeling van de nieuwe syntaxis. De ingenieurs en ontwerpers van het team Technical Wishes werken aan de bouw van subreferenties.
We hebben het in september 2025 in gebruik genomen voor de Duitse Wikipedia als onze eerste pilot wiki.
We verbeteren het gebruik van subreferenties en zullen in de komende maanden andere potentiële pilot-wiki's benaderen.
Gearchiveerde updates uit 2024
Er is een prototype is beschikbaar op de bètawiki. Het behandelt de wikitext-oplossing en enkele van de basisfuncties van VisualEditor. U kunt het prototype testen en feedback geven.
We hebben aankondigingen naar alle wiki's gezonden om de gemeenschappen te laten weten over deze aankomende functie, en we hebben hen uitgenodigd om te testen en feedback te geven.
Ons team presenteerde subreferenties op Wikimania 2024 en besprak het met de deelnemers. (YouTube)
In 2024 werden gebruikersproeven uitgevoerd in verschillende projecten.- Vanaf oktober/november 2024 onderzoeken we de mogelijke veranderingen in onze wikitext aanpak, gebaseerd op de community feedback die we hebben ontvangen. We zullen binnenkort contact opnemen met de gemeenschappen om meer feedback te krijgen over mogelijke veranderingen in de subreferentie functie.
- De implementatie van de pilotwiki is stilgelegd, in afwachting van discussies en mogelijke wijzigingen in onze functie.
- We zijn van plan om de functie in 2025 te implementeren in andere Wikimedia wiki's.
- We zullen feedback blijven verzamelen om de oplossing na de implementatie te verbeteren.
Veelgestelde vragen
Hoe kan ik artikelen vinden die subreferenties gebruiken?
Een tracking-categorie met de naam Category:Pages that use sub-references wordt toegevoegd aan elke pagina waar subreferenties worden gebruikt, zodat u pagina's kunt verkennen of corrigeren met behulp van de nieuwe functie. De naam van deze categorie kan veranderen.
Ook heeft het team een aantal voorbeelden gemaakt op de Engelse betawiki.
Kan ik een sjabloon invoegen in het attribuut details?
Ja, u kunt sjablonen invoegen in zowel de hoofd- als de subreferentie, zie de voorbeelden voor wikitext en VisualEditor. We hebben in eerste instantie feedback ontvangen die suggereert dat het gebruik van sjablonen in een kenmerk meer problemen dan voordelen kan opleveren. Andere gebruikers wensten expliciet sjabloonondersteuning, vooral in de VisualEditor. Deel alstublieft uw mening over subreferenties en sjablonen op de overlegpagina.
Hoe kan ik me voorbereiden op de uitrol van subreferentie?
- Controleer of er onvertaalde Cite berichten in uw taal zijn.
- Overweeg om de trackingcategorie cite-tracking-category-ref-details aan te maken die gelinkt is aan de versie van uw wiki van Special:TrackingCategories. Gebruik
__HIDDENCAT__(of een speciaal sjabloon) om het voor de lezers te verbergen. Voeg de categorie toe aan d:Q129764848.- Engelse Wikipedia voorbeeld: en:Category:Pages that use sub-references
- Controleer of uw wiki hiervoor Tooltips gebruikt en volg de onderstaande instructies (of in phab:T416304) als er een update nodig is. Er is geen actie nodig als uw wiki Referentievoorbeelden standaard gebruikt.
- Engelse Wikipedia voorbeeld: en:Special:Diff/1344408362
- Overweeg om gelokaliseerde versies van MediaWiki:Cite-ve-dialog-subreference-help-dialog-link en MediaWiki:Cite-ve-dialog-subreference-help-dialog-link-ve op uw wiki te maken, waarbij u de standaard
Special:MyLanguagelinks vervangt door links die wijzen op de vertaalde versie van deze projectpagina. Dat is niet nodig, maarSpecial:MyLanguagewerkt niet goed voor gebruikers die ingelogd zijn – het vervangen van de standaardlink zorgt ervoor dat ze altijd de vertaalde projectpagina krijgen. Het is ook mogelijk om deze links te vervangen door links naar hulppagina's op uw lokale wiki.- Franse Wikipedia voorbeeld: fr:MediaWiki:Cite-ve-dialog-subreference-help-dialog-link / fr:MediaWiki:Cite-ve-dialog-subreference-help-dialog-link-ve
- Wiki's die MediaWiki:Edittools of gerelateerde wikitextfuncties gebruiken zoals en:MediaWiki:Gadget-charinsert-core.js of de:MediaWiki:Gadget-editMenus.js kunnen
<ref name="..." details="..." />aan die hulpmiddelen toevoegen.- Poolse Wikipedia voorbeeld: pl:Special:Diff/79273099
Welke invloed zal de nieuwe functie hebben op bestaande gadgets en scripts?
Sommige gadgets en scripts met betrekking tot referenties kunnen een update nodig hebben om goed te kunnen werken met deze nieuwe functie. Omdat gadgets en scripts in handen zijn van de wiki-gemeenschappen, kunnen we ze niet aanpassen.
Aan wiki's die een kopie van de gadget Referentie Tooltips hebben, wordt gevraagd hun versie bij te werken – meestal staand op MediaWiki:Gadget-ReferenceTooltips.js – zoals hier getoond. Zie phab:T416304 voor meer informatie.
Laat het ons op de overlegpagina weten als u problemen ontdekt of hulp nodig heeft bij het bijwerken van citaatsjablonen om deze te laten werken met de nieuwe functie.
Waarom is er voor deze wikitextsyntaxis gekozen?
Deze post geeft een reden voor het kiezen van de syntaxis details. Wij zijn van mening dat de beste en snelste weg naar het leveren van een bruikbare functie de gekozen syntaxis is, ook al heeft deze enkele beperkingen.
Historisch gezien is geen enkele syntaxis perfect geweest en elke oplossing heeft zijn tekortkomingen. Na lange discussies en overleg met meerdere teams van de Wikimedia Foundation, zijn we tot de conclusie gekomen dat deze oplossing voldoet aan onze technische eisen en duurzaam is voor langdurig onderhoud.
Het is ook volledig compatibel met wiki's die blijven vertrouwen op of aan {{reflist}} de voorkeur geven. Deze syntaxis maakt het mogelijk dat de hoofdreferentie in-line wordt gebruikt zonder dat deze in de sectie Referenties hoeft te worden geplaatst, wat anders beperkingen in de VisualEditor zou veroorzaken.
Bovendien zijn we ervan overtuigd dat deze aanpak ook consistent zal werken in de workflows van VisualEditor.
Kan ik subreferenties gebruiken voor andere details dan paginanummers?
Ja, dat kan, de functie is bewust ontworpen om andere soorten details toe te staan, bijvoorbeeld alinea's, citaten of audio-tijdstempels. We hebben verschillende voorbeelden geselecteerd uit de Duitse Wikipedia in dit rapport.
Waarom duurt het zo lang om een oplossing te vinden?
Het team Technische Wensen heeft vele jaren af en toe aan deze functie gewerkt. Als u meer wilt weten, hier is een overzicht van de geschiedenis en complexiteit van dit probleem.