WMDE Technical Wishes/Sub-referencing/nl
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 werkt zonder sjablonen en gebaseerd is op de bestaande manier waarop referenties werken, voor zowel wikitext als VisualEditor. Meer informatie over het probleem
| 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 het prototype 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 | |
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.
Ons plan is om subreferenties maken aan de Wikimedia wiki's eind 2024 toe te voegen als functie.
Beknopte beschrijving
Om meer dan één keer een bron met verschillende details te citeren, is een hoofdreferentie en een subreferentie nodig.
- De hoofdreferentie bevat de belangrijkste bibliografische informatie.
- De subreferentie bevat de details: paginanummers, of elke vorm van aanvullende informatie die voor elk citaat anders is, bijvoorbeeld hoofdstukken of noten.
- In de sectie referenties zien lezers alle subreferenties gegroepeerd onder hun hoofdreferentie. Dit maakt het gemakkelijker om te begrijpen hoe vaak een enkele bron in dat artikel is geciteerd.
- Voor wikitext gebruikt u een nieuw attribuut voor subreferenties. De huidige naam van dat attribuut is extends, maar de naam kan veranderen voordat de functie wordt geïmplementeerd. We zullen meer feedback over de naam verzamelen.
- In VisualEditor, we wijzigen het bestaande citatiedialoogvenster zodat het subreferenties ondersteunt.
Belangrijkste voordelen
- Subreferenties zijn gebaseerd op de bestaande manier waarop referenties werken.
- Het werkt voor zowel VisualEditor als wikitext - waardoor we dichter bij de functie-gelijkheid tussen VisualEditor en wikitext komen.
- De oplossing zal in MediaWiki 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 het prototype! 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 is bijna klaar. De naam van het attribuut kan echter veranderen. De oplossing is nog niet geïmplementeerd, vooral omdat we willen voorkomen dat gebruikers van de VisualEditor een heel andere ervaring hebben dan wikitextgebruikers. De ondersteuning voor de VisualEditor is nog in ontwikkeling.
U kunt nog steeds het prototype testen en ons vertellen hoe het voor u werkt.
Voordelen specifiek voor wikitext
- De oplossing is gebaseerd op 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.
Stap voor stap
1) U heeft een referentie nodig met de belangrijkste bibliografische informatie, de hoofdreferentie. Deze referentie heeft een naam:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
Deze hoofdreferentie moet in de referentiesectie geplaatst zijn, anders heeft u een referentie in het artikel die geen details zoals paginanummers toont. Gebruik in het gedeelte met referenties de syntaxis <references> … </references>. Als het artikel al <references /> gebruikt, verwijder dat dan.
2) U maakt een subreferentie, met behulp van de naam van de hoofdreferentie met het attribuut extends. U voegt de details toe tussen de <ref> tags:
<ref extends="Miller">Page 23.</ref>
Dit is hoe het eruit ziet:
According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref>
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
Als u naar een "nieuwe" bron wilt refereren met behulp van subreferenties in wikitext, hoeft u er alleen maar voor te zorgen dat u de hoofdreferentie in de referentiesectie maakt.
Maar in veel gevallen wilt u waarschijnlijk subreferenties gebruiken met een referentie die al in het artikel bestaat. In deze gevallen
- Verwerk de originele referentie in een hoofdreferentie met behulp van
<ref name>. - Verplaats de hoofdreferentie naar de sectie met referenties.
- Maak een subreferentie waar de oorspronkelijke referentie eerder in de artikel was.
- Verplaats de details van de hoofdreferentie (pagina's, etc.) naar de subreferenties. Zorg ervoor dat deze niet langer in de hoofdreferentie blijven, anders worden deze details tweemaal weergegeven.
- Maak meer subreferenties waar u de bron met verschillende details in het artikel wilt noemen.
U kunt ook een subreferentie hergebruiken door de subreferentie een naam te geven:
According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" />
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
Aandachtspunten
- Het omzetten van referenties naar hoofd- en subreferenties vereist enige opschoning; En de hoofdreferentie moet meestal in de sectie Referenties staan (zoals hierboven beschreven).
- U kunt subreferenties gebruiken met citatiesjablonen. We hebben de meest gebruikte getest, maar uw favoriete sjabloon heeft mogelijk enkele updates nodig om met onze oplossing te werken.
- Sommige gadgets/scripts die verband houden met referenties kunnen ook een update nodig hebben om goed te kunnen werken met de nieuwe oplossing met subreferenties.
- Het is niet mogelijk om een subreferentie van een subreferentie te maken.
- Als
<ref group>wordt gebruikt, moeten de hoofdreferentie en de subreferentie in dezelfde groep zijn.
In VisualEditor (in ontwikkeling)
Op dit moment weten we niet hoe de functie voor VisualEditor eruit zal zien. Tot nu toe hebben we een zeer minimale oplossing die nog niet klaar is om te worden ingezet. In de komende weken zal deze oplossing waarschijnlijk veranderen.
U kunt ook het prototype testen met de huidige staat van de VisualEditor-oplossing. Houd er rekening mee dat dit waarschijnlijk zal veranderen. We zullen deze pagina updaten wanneer nieuwe aspecten kunnen worden getest.
Voordelen specifiek voor VisualEditor
- Om dezelfde bron met verschillende details te citeren, hoeft u geen nieuwe referentie meer vanaf het begin te maken.
- Subreferenties zijn volledig compatibel met VisualEditor (in tegenstelling tot op sjablonen gebaseerde oplossingen): u kunt ze maken via de citatie dialoog en u kunt ze bewerken vanuit het gedeelte referenties.
Workflows in het huidige prototype (zal waarschijnlijk nog wel veranderen)
Een subreferentie aanmaken
- Het aanmaken van een subreferentie werkt nu via het bestaande citatiedialoogvenster.
- Selecteer in het tabblad "hergebruik" de referentie die u via de drie punten wilt hergebruiken en klik op "hergebruiken van deze referentie met extra details".
- Voer de details van die subreferentie in en klik op de knop voor opslaan van de subreferentie.
- De referentie-popup in VisualEditor laat zien dat deze referentie een subreferentie is en hoe vaak deze wordt hergebruikt.
Een bestaande subreferentie bewerken
- Klik op de voetnoot-marker in de tekst van het artikel om een subreferentie te bewerken.
- U kunt nu de details van de subreferentie wijzigen. U wordt ook geïnformeerd dat het een subreferentie is.
- U kunt nog geen subreferentie in de bijbehorende lijst bewerken.
- Klik op de hoofdreferentie in de sectie referenties om de hoofdreferentie te bewerken.
Een subreferentie wijzigen
- U kunt een subreferentie opnieuw gebruiken met behulp van het tabblad "hergebruiken" in de citatie-dialoog.
Aandachtspunten
- Het bestaande probleem met automatische namen voor referenties in de VisualEditor doet zich ook voor bij subreferenties.
- In VisualEditor is het nu mogelijk om een subreferentie van een subreferentie te maken. Dit is een fout en veroorzaakt een fout bij het opslaan. Het is niet verondersteld later te werken in de werkelijke oplossing, en werkt ook niet in wikitext.
- We moeten nog werken aan wat er gebeurt als u een referentie verwijdert die opnieuw wordt gebruikt.
- De workflow bij het omzetten van een bestaande referentie in een hoofd- en subreferentie is nog niet bepaald.
- Wanneer u een hergebruik van een subreferentie in de VisualEditor maakt en vervolgens overschakelt naar wikitext, zult u merken dat de code in wikitext is
<ref extends="main-reference" name="sub-reference" />. Dit is een bug en zal worden opgelost als onderdeel van T367749. <ref name="sub-reference name"/>het referentievoorbeeld voor de subreferentie wordt nu niet correct weergegeven in de bewerkingsmodus van de VisualEditor. U ziet alleen de details van de subreferentie in de pop-up en niet de informatie uit de hoofdreferentie. Om de informatie van de hoofdreferentie ook in de pop-up te zien, moet u nu de syntaxis<ref extends="main" name="sub-reference name" />gebruiken.
Prototype 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.
Het prototype is beschikbaar op bèta-wiki. We nodigen u voornamelijk uit om de wiki-oplossing te testen:
- 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 (op de-betawiki) - of uw IP-adres weergeven (op de Engelse bèta-wiki).
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 bibliografiesectie 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, deel deze dan op de overlegpagina.
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 pilot wiki 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.
We zijn op de hoogte van andere problemen in het focusgebied "hergebruik van referenties", en we zullen proberen ze gaandeweg aan te pakken. Onze focus blijft echter op het creëren van een oplossing voor subreferenties.
Veelgestelde vragen
Hoe kan ik artikelen vinden die subreferenties gebruiken?
Een categorie met de naam Category:Pages that use extended references wordt toegevoegd aan elke pagina waar subreferenties worden gebruikt, zodat u deze pagina's snel kunt vinden en kunt verkennen of repareren met behulp van de nieuwe functie. De naam van deze categorie kan veranderen.
Kan ik deze functie gebruiken met citatiesjablonen/hulpmiddelen?
Ja, u kunt het gebruiken met citatiesjablonen. We hebben de meest voorkomende citatiesjablonen getest (bijv. citeer boek of citeer web) en verwachten geen problemen. Maar uw favoriete sjabloon heeft misschien wat updates nodig om met onze oplossing te kunnen werken. Sommige gadgets/scripts met betrekking tot referenties hebben mogelijk ook een update nodig om goed te kunnen werken met de nieuwe oplossing. Omdat sjablonen, gadgets en scripts in handen zijn van de wiki-gemeenschappen, kunnen we ze niet aanpassen.
Laat ons op de overlegpagina weten als u problemen heeft of hulp nodig heeft bij het bijwerken van citaatvormen om deze te laten werken met de nieuwe functie.
Wat wordt de naam van het subreferentie-attribuut?
Dat weten we nog niet. De naam voor het maken van subreferenties in wikitext is extends. We besloten voor deze naam een paar jaar geleden na een discussie met gemeenschappen en belanghebbenden bij de Wikimedia Foundation. We hebben echter wel wat feedback gekregen dat deze naam misschien niet de beste optie is. Voordat we deze functie in de wiki's zullen invoeren, willen we meer feedback krijgen over de attribuutnaam en zijn we van plan om enkele alternatieven voor discussie te stellen. We laten u weten wanneer dat gebeurt.
Waarom is er voor deze wikitextsyntaxis gekozen?
Toen we voor het eerst begonnen te werken aan de wikitextimplementatie van deze functie, bespraken we verschillende opties. Het toevoegen van een nieuwe tag (bijv. <subref>) werd zorgvuldig besproken, maar we wilden vasthouden aan de bestaande <ref>-aanpak, om de hoeveelheid nieuwe syntaxis die gebruikers moeten leren te minimaliseren. Bovendien zou het introduceren van een nieuwe tag veel updates vereisen van bestaande community-software (hulpmiddelen, gadgets, bots enz.) voor referenties.
Een voorstel (uit 2008) was om de details van de subreferentie te specificeren binnen de <ref>-tag: <ref page="page 2" name="Miller"> of later <ref detail="page 2" name="Miller"> met behulp van het naamattribuut om naar de hoofdreferentie te verwijzen. Dit is vergelijkbaar met wat gebruikers weten van het werken met sjablonen zoals {{cite book}}.
Het belangrijkste probleem met deze aanpak is echter dat het problemen met sjablonen veroorzaakt en zeer waarschijnlijk fouten veroorzaakt. Een ander probleem met deze syntaxis is dat het niet toestaat om een subreferentie opnieuw te gebruiken, omdat het naamattribuut al is gebruikt om naar de hoofdreferentie te verwijzen en niet een tweede keer kan worden gebruikt.
Een manier om beide problemen te voorkomen is om een nieuw referentieattribuut te maken en de details van de subreferentie in het gebied tussen de openings- en sluiting van de <ref>-tags te plaatsen, zoals al wordt gedaan voor de inhoud van referenties. Dit is wat onze aanpak doet.
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.