WMDE Technical Wishes/Sub-referencing/de
| Subreferenzierung | |
|---|---|
| Status | In Arbeit |
| Origin | Umfrage Technische Wünsche 2013, 2015, 2022 und andere |
| Focus area | Wiederverwendung von Einzelnachweisen |
| Phabricator | Projektboard |
| Responsible | Team Technische Wünsche |
 Bitte gib uns Feedback Du bist eingeladen, unseren Prototypen zu testen, den wir kontinuierlich weiterentwickeln. Beobachte diese Seite oder trage dich in diese Mailingliste ein, um zu erfahren, was Neues getestet werden kann. | |
Es ist umständlich, den selben Einzelnachweis mit unterschiedlichen Details in einem Artikel wiederzuverwenden. Communitymitglieder haben sich eine MediaWiki-Lösung gewünscht, die für Wikitext und Visual Editor funktioniert, ohne Vorlagen-Workarounds auskommt und auf der bestehenden Funktionsweise von Einzelnachweisen aufbaut. » Mehr über das Problem
Im Rahmen des Themenschwerpunkts "Wiederverwendung von Einzelnachweisen vereinfachen" führt das Team Technische Wünsche von Wikimedia Deutschland Subreferenzierung ein – eine optionale Funktion, die es erlaubt, verschiedene Details einem bestehendem Einzelnachweis hinzuzufügen, ohne diesen duplizieren zu müssen.
Unser Plan ist, diese Funktion Ende 2024 auf den Wikimedia-Wikis bereitzustellen.
Subreferenzierung in Kürze
Um eine Quelle mit unterschiedlichen Details zu verwenden, benötigt man eine Hauptreferenz und eine Subreferenz.
- Die Hauptreferenz enthält die bibliographischen Hauptinformationen.
- Die Subreferenz enthält die Details: Seitenzahlen oder jede Art von zusätzlichen Informationen, die für jeden Beleg unterschiedlich sind, z.B. Kapitel, Verse oder Anmerkungen.
- Leser:innen sehen Subreferenzen im Abschnitt Einzelnachweise unter ihrer jeweiligen Hauptreferenz gruppiert. Dadurch wird schneller ersichtlich, wie oft eine Quelle in einem Artikel zitiert wurde.
- Im Wikitext nutzt man ein neues Attribut, um Subreferenzen zu erzeugen. Aktuell heißt dieses Attribut extends, aber der Name kann sich noch ändern, bevor die Funktion eingeführt wird. Wir werden dazu noch weiteres Feedback einholen.
- Im Visua Editor ändern wir den bestehenden Beleg-Dialog, sodass er Subreferenzen unterstützt.
Wichtigste Vorteile
- Subreferenzierung basiert auf der bestehenden Art und Weise, wie Einzelnachweise funktionieren.
- Subreferenzierung funktioniert sowohl für den Visual Editor als auch für Wikitext und bringt somit die Funktionsgleichheit zwischen Visual Editor und Wikitext näher.
- Die Lösung wird in MediaWiki umgesetzt, ist somit in allen Wikimedia-Wikis verfügbar und kann ohne vorlagenbasierte Workarounds verwendet werden.
- Subreferenzen werden in der Einzelnachweisvorschau und der mobilen Einzelnachweisvorschau korrekt angezeigt.
- Subreferenzierung ist optional: Du kannst andere Methoden zur Erstellung von Einzelnachweisen weiterhin verwenden. Aber wahrscheinlich wirst du Artikeln begegnen, in denen Subreferenzierung vorkommt.
- Teste den Prototypen! Mehr Infos zum Testen.
- Feedback, Fragen und Anmerkungen gerne auf die Diskussionsseite.
- Beobachte diese Seite oder trage dich hier ein, um zu erfahren, was Neues getestet werden kann.
So funktioniert’s
Wikitext
Die Wikitext-Lösung für Subreferenzierung ist fast fertig. Der Name des Attributs könnte sich aber noch ändern. Die Lösung wurde noch nicht bereitgestellt, weil wir vermeiden wollen, dass Nutzer:innen des Visual Editors eingeschränktere Möglichkeiten haben als Wikitext-Nutzende. Die Lösung für den Visual Editor befindet sich noch in der Entwicklung.
Du kannst den Prototypen testen und uns Feedback geben.
Vorteile für Wikitext
- Diese Lösung basiert auf dem bestehenden und bekannten Konzept der benannten Einzelnachweise.
- Sie erfordert keine Vorlagen-Kenntnisse.
- Durch die Reduzierung nahezu identischer doppelter Einzelnachweise wird der Wikitext übersichtlicher, weniger redundant und leichter zu lesen.
Step by step
1) Du benötigst einen Einzelnachweis, der die wesentlichen bibliographischen Informationen enthält – die Hauptreferenz. Diese Hauptreferenz muss benannt werden:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
Die Hauptreferenz sollte im Abschnitt Einzelnachweise platziert werden, ansonsten steht im Artikeltext ein Einzelnachweis ganz ohne Details.
2) Erstelle die Subreferenz: Nutze das Attribut extends und gib den Namen der Hauptreferenz dort als Wert an. Zwischen den <ref>-Tags trägst du die Details ein:
<ref extends="Miller">Page 23.</ref>
Beispiel:
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>
|
|
Wenn du im Wiktext eine neue Quelle mehrfach verwenden möchtest, die noch nicht im Artikel auftaucht, solltest du nur darauf achten, sie im Abschnitt Einzelnachweise zu platzieren.
In vielen Fällen möchtest du aber wahrscheinlich eine Subreferenz aus einem Einzelnachweis erzeugen, der bereits im Artikel vorhanden ist. Dann gehst du so vor:
- Wandle den Einzelnachweis in eine Hauptreferenz um, indem du
<ref name>nutzt. - Verschiebe ihn in den Abschnitt Einzelnachweise.
- Erstelle eine Subreferenz an der Stelle im Artikeltext, an der sich der ursprüngliche Einzelnachweis befunden hat.
- Verschiebe die Details der Hauptreferenz (Seitenzahlen usw.) in die Subreferenz. Achte darauf, dass sie nicht mehr in der Hauptreferenz stehen, sonst werden diese Angaben doppelt angezeigt.
- Erstelle weitere Subreferenzen, wenn du die Quelle im Artikel mit anderen Details verwenden willst.
Subreferenzen können auch wiederverwendet werden, indem man ihnen ebenfalls einen Namen zuweist:
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>
|
|
Bitte beachte
- Die Umwandlung von Einzelnachweisen in Haupt- und Subreferenzen erfordert ein paar Anpassungen; die Hauptreferenz sollte sich im Abschnitt Einzelnachweise befinden (siehe oben).
- Subreferenzierung kann mit Belegvorlagen verwendet werden. Wir haben die wichtigsten Belegvorlagen getestet, aber eventuell müssen andere Vorlagen angepasst werden, damit sie mit unserer Lösung funktionieren.
- Auch einige Helferlein/Skripte für Einzelnachweise müssen möglicherweise angepasst werden, damit sie mit Subreferenzen funktionieren.
- Es ist nicht möglich, Subreferenzen von Subreferenzen zu erstellen.
- Wird
<ref group>verwendet, müssen Haupt- und Subreferenz in der gleichen Einzelnachweisgruppe sein.
Visual Editor (in Arbeit)
Aktuell wissen wir noch nicht exakt, wie die Lösung für den Visual Editor aussehen wird. Bislang gibt es eine sehr minimale Lösung, die noch nicht eingesetzt werden kann. In den kommenden Wochen wird sich diese Lösung wahrscheinlich noch ändern.
Du kannst auch den aktuellen Stand der Visual-Editor-Lösung im Betawiki testen. Bitte beachte aber, dass er sich aller Voraussicht nach noch ändern wird. Wir werden diese Seite updaten, wenn neue Funktionen getestet werden können.
Vorteile für Visual Editor
- Um dieselbe Quelle mit anderen Details zu zitieren, muss man nicht mehr einen vollständig neuen Einzelnachweis erstellen.
- Subreferenzen sind – im Gegensatz Vorlagen-Workarounds – vollständig kompatibel mit dem Visual Editor: Sie können über den „Belegen“-Dialog erstellt und im Abschnitt Einzelnachweise bearbeitet werden.
Workflows im aktuellen Prototypen (ändern sich wahrscheinlich)
Subreferenzen erstellen
- Das Erstellen einer Subreferenz funktioniert derzeit über bereits vorhandenen „Belegen“-Dialog.
- In dem Reiter „Wiederverwenden“, kannst du über die drei Punkte den Einzelnachweis auswählen, der wiederverwendet werden soll, und auf „Diesen Einzelnachweis mit zusätzlichen Details wiederverwenden“ klicken.
- Dann kannst du die Details der Subreferenz eingeben und auf einfügen klicken.
- Im Vorschau-Popup der Subreferenz im Visual Editor sieht man, dass es sich bei diesem Einzelnachweis um eine Subreferenz handelt und wie oft sie wiederverwendet wird.
Subreferenzen bearbeiten
- Klicke auf die Fußnote im Artikeltext, um die Subreferenz zu bearbeiten.
- Nun kannst du die Details der Subreferenz bearbeiten. Dabei wird dir angezeigt, dass es sich um eine Subreferenz handelt.
- Aktuell ist es noch nicht möglich, Subreferenzen über die Einzelnachweisliste zu bearbeiten.
- Die Hauptreferenz kann über die Einzelnachweisliste bearbeitet werden, indem du auf sie klickst.
Subreferenzen wiederverwenden
- Du kannst Subreferenzen über "Weiterverwenden" im „Belegen“-Dialogfeld erneut zu nutzen.
Bitte beachte
- Das bestehende Problem mit automatisch vergebenen, numerischen Namen für Einzelnachweise im Visual Editor tritt auch bei Subreferenzen auf.
- Im Visual Editor ist es aktuell möglich, über den Beleg-Dialog die Subreferenz einer Subreferenz zu erstellen. Dies ist ein Fehler, der nach dem Speichern auch als Fehler angezeigt wird. In der finalen Lösung soll dies nicht mehr möglich sein und funktioniert auch nicht im Wikitext.
- Aktuell müssen wir noch eine Lösung finden, was passiert, wenn ein Einzelnachweis gelöscht wird, der weiterverwendet wird.
- Der Prozess zur Umwandlung eines bestehenden Einzelnachweises in eine Haupt- und Subreferenz muss für den Visual Editor noch definiert werden.
- Wenn man eine Subreferenz im Visual Editor weiterverwendet und dann zum Wikitext wechselt, steht dort
<ref extends="main-reference" name="sub-reference" />. Dies ist ein Fehler, der in T367749 behoben wird. <ref name="sub-reference name"/>führt aktuell zu einer fehlerhaften Einzelnachweisvorschau im Editormodus des Visual Editors. Es sind nur die Details der Subreferenz im Pop-up zu sehen und nicht die Informationen der Hauptreferenz. Um die Informationen der Hauptreferenz ebenfalls im Pop-up anzuzeigen, muss man aktuell die Syntax<ref extends="main" name="sub-reference name" />verwenden.
Teste den Prototypen
Für die weitere Entwicklung benötigen wir dein Feedback. Wir freuen uns über Fragen und Anmerkungen auf der Diskussionsseite.
Der Prototyp ist im Betawiki verfügbar. Wir laden aktuell vor allem dazu ein, die Wikitext-Lösung zu testen:
- Seiten könnten anders aussehen (z.B. nicht deinen bevorzugten Skin nutzen).
- Es könnte einige dir unbekannte, neue Features geben, die noch in der Entwicklungsphase sind.
- Sie enthalten nur einige Testseiten und Vorlagen, nicht den gesamten Inhalt Ihres Wikis. Daher könnten manche Vorlagen, Helferlein oder Skripte sowie sonstige Inhalte, die du gewohnt bist, fehlen.
- Dein normales Konto funktioniert nicht auf Betawikis. Du kannst entweder einen Account erstellen – bitte nutze ein anderes Passwort, als bei deinem normalen Konto – oder uneingeloggt testen. Dies würde entweder dazu führen, dass ein Temporäres Konto erstellt wird (im de-betawiki) oder deine IP-Adresse angezeigt wird (im en-betawiki).
Das Ursprungsproblem
In Wikipedia-Artikeln ist es üblich, Quellen mehrfach zu zitieren. Zwar kann man Einzelnachweise bereits identisch wiederverwenden. Aber es ist derzeit nicht möglich, denselben Einzelnachweis mit unterschiedlichen Details (z. B. anderen Seitenzahlen) einfach wiederzuverwenden. Die einzige Möglichkeit besteht darin, einen völlig neuen Einzelnachweis zu erstellen oder Workarounds zu verwenden.
Status quo: Einzelnachweise wiederverwenden in Wikitext und im Visual Editor
Um einen Einzelnachweis im Wikitext wiederzuverwenden, kann man ihm einen Namen geben und an anderer Stelle im Artikel auf diesen Namen referenzieren. Der benannte Einzelnachweis kann im Artikeltext oder am Ende des Artikels im Abschnitt Einzelnachweise platziert werden. Im Visual Editor kann man die Option "Weiterverwenden" im „Belegen“-Dialog nutzen. Im Abschnitt Einzelnachweise werden Einzelnachweise mit demselben Namen gruppiert.
-
Wikitext: <ref name> im Artikeltext -
Wikitext: <ref name> im Abschnitt Einzelnachweise -
Visual Editor: Beleg-Dialog -
Ansicht für Lesende
Status quo: Einzelnachweise mit unterschiedlichen Details wiederverwenden im Wikitext
Um denselben Einzelnachweis mit unterschiedlichen Details zu verwenden, muss man den Einzelnachweis derzeit im Wikitext kopieren, einfügen und die Details der Kopie ändern oder einen neuen (fast identischen) Verweis von Grund auf erstellen. Einige Projekte verwenden Workarounds wie short citations oder vorlagenbasierte Lösungen wie shortened footnotes. Im Abschnitt Einzelnachweise werden der ursprüngliche Einzelnachweis und der neu erstellte Einzelnachweis mit anderen Details nicht gruppiert.
-
Zwei fast identische Einzelnachweise im Wikitext. -
Lesendenansicht: Fast identische Einzelnachweise werden nicht gruppiert -
Workaround mit short citations im Wikitext -
Lesendenansicht: Workaround mit short citations -
Workaround mit {{sfn}} im Wikitext -
Lesendenansicht: Workaround mit {{sfn}}
Status quo: Einzelnachweise mit unterschiedlichen Details wiederverwenden im Visual Editor
Möchte man denselben Einzelnachweis mit unterschiedlichen Details im Visual Editor verwenden, funktionieren dort weder die Option "Weiterverwenden" im „Belegen“-Dialog noch Kopieren und Einfügen: Beide Optionen fügen einen identischen Einzelnachweis ein, und wenn man dort Details ändert, ändern diese sich sowohl im Original als auch in der Kopie. Stattdessen muss man einen vollständig neuen (fast identischen) Einzelnachweis erstellen. Im Abschnitt Einzelnachweise werden der ursprüngliche Einzelnachweis und der neu erstellte Einzelnachweis nicht gruppiert.
Einzelnachweise, die durch Vorlagen-Workarounds wie {{sfn}} erstellt wurden, können nicht über den Abschnitt Einzelnachweise bearbeitet werden und tauchen unter "Weiterverwenden" im „Belegen“-Dialog nicht auf. Aber es ist möglich, sie über den Fußnotenmarker im Artikeltext zu finden und manuell zu bearbeiten.
Workaround mit {{sfn}}:
-
Lesendenansicht -
Die Einzelnachweise verschwinden aus der Einzelnachweisliste, sobald man auf „Bearbeiten“ klickt. -
Es ist nicht möglich, {{sfn}}-Einzelnachweise über den "Weiterverwenden"-Dialog zu nutzen. -
Einzelnachweise können nur bearbeitet werden, wenn man sie über den Artikeltext aufruft.
Probleme für Lesende
Vorlagen-Workarounds werden in der Einzelnachweisvorschau, im enwiki Helferlein Reference Tooltips und in der mobilen Einzelnachweisvorschau nicht richtig angezeigt.
{{sfn}}-Workaround mit Einzelnachweis-Pop-ups:
-
Einzelnachweisvorschau: Die Hauptinformationen werden nicht angezeigt. -
Reference Tooltips: Die Hauptinformationen werden zunächst nicht angezeigt. -
Reference Tooltips: Die Hauptinformationen werden dann in einem weiteren Pop-up angezeigt. -
Mobile Einzelnachweisvorschau: Die Hauptinformationen werden nicht angezeigt.
Hauptprobleme mit dem Status quo
- Die Nutzungserfahrung im Visual Editor und im Wikitext ist sehr unterschiedlich.
- Die meisten Workarounds für die Wiederverwendung von Einzelnachweisen mit unterschiedlichen Details funktionieren im Visual Editor nicht richtig.
- Viele fast identische Einzelnachweise mit unterschiedlichen Details machen den Wikitext unübersichtlich.
- Vorlagen-Workarounds werden nicht von allen Wiki-Communitys gleichermaßen akzeptiert und sind daher nicht weltweit verfügbar.
- Einige Nutzer:innen versuchen, dieses Problem zu umgehen, indem sie Quellen nur im Abschnitt „Bibliographie“ angeben und gar keine Einzelnachweise verwenden, was die Überprüfung einzelner Artikelinhalte erschwert.
Letzte Änderungen und nächste Schritte
Unser Team hat seit längerer Zeit immer wieder an diesem Problem gearbeitet. Hier gibt es einen Überblick über die Geschichte dieses Projekts, einschließlich der dazugehörigen Recherche.
Vielen Dank an alle, die an Tests und Interviews teilgenommen und Interesse gezeigt haben, sowie an alle, die sich im Laufe der Jahre die Zeit genommen haben, auf den Diskussionsseiten zu kommentieren. Wir wissen dies sehr zu schätzen. Weiteres Feedback kann sehr gerne weiterhin auf der Diskussionsseite geteilt werden.
Es gibt einen Prototyp im Beta-Wiki. Er deckt die Wikitext-Lösung ab sowie einige grundlegende Funktionen für den Visual Editor. Er kann kontinuierlich getestet werden.- Alle Wikis wurden informiert, dass diese Funktion kommen wird, verbunden mit der Einladung, Feedback zu geben.
- Unser Team hat die Sub-Einzelnachweise auf der Wikimania 2024 präsentiert und mit Teilnehmern darüber diskutiert. (YouTube)
- Moderierte Nutzertests fanden 2024 in verschiedenen Projekten statt.
- Stand Oktober/November 2024 prüfen wir derzeit mögliche Änderungen an unserem Wikitext-Konzept, die auf dem Feedback der Community basieren. Wir werden uns bald an die Communitys wenden, um mehr Feedback zu möglichen Änderungen an der Funktion für Subreferenzierung zu erhalten.
- Der Einsatz in Pilot-Wikis wurde gestoppt, da noch Diskussionen und mögliche Änderungen an unserem Feature ausstehen.
- Wir planen, Subreferenzierung im Jahr 2025 auf anderen Wikimedia-Wikis bereitzustellen.
- Wir sammeln auch nach der Bereitstellung Feedback, um die Funktion weiter zu verbessern.
Wir wissen um weitere Probleme rund um die Wiederverwendung von Einzelnachweisen und werden versuchen, sie im Zuge der Arbeiten an dieser Funktion zu lösen. Unser Schwerpunkt liegt jedoch weiterhin auf der Subreferenzierungsfunktion.
FAQ
Wie kann ich Artikel finden, die Subreferenzierung nutzen?
Seiten, die Subreferenzen verwenden, erhalten automatisch die Wartungskategorie Kategorie:Seiten, die erweiterte Einzelnachweise verwenden. So kann man Seiten mit Subreferenzierungen leichter entdecken, beispielsweise um Einzelnachweise aufzuräumen oder zu vereinheitlichen. Der Name der Kategorie kann sich noch ändern.
Kann ich diese Funktion mit Belegvorlagen/-tools verwenden?
Ja, du kannst Subreferenzierung auch nutzen, wenn du Vorlagen zur Erstellung von Einzelnachweisen nutzt. Wir haben die häufigsten Belegvorlagen getestet (z.B. Vorlage:Internetquelle und Vorlage:Literatur) und erwarten keine Probleme. Die gebräuchlichsten Belegvorlagen haben wir getestet, aber vielleicht müssen einige Vorlagen aktualisiert werden, damit sie mit unserer Lösung funktionieren. Einige Helferlein/Skripte, die mit Einzelnachweisen zu tun haben, müssen möglicherweise ebenfalls aktualisiert werden, damit sie mit der Lösung für Subreferenzen richtig funktionieren. Da Vorlagen, Helferlein und Skripte grundsätzlich in den Händen der Wiki-Communitys liegen, nehmen wir diese Anpassungen nicht selbst vor.
Falls du Probleme feststellst oder Hilfe bei der Anpassung von Vorlagen an die neue Funktion brauchst, melde dich gern auf der Diskussionsseite.
Wir werden auf der diesjährigen Wikimania auch einen Workshop zum Thema „[$2 A brand new citation option – What does this mean for citation templates?]“ anbieten (hybrid, auf Englisch). Komm gern vorbei oder schau dir später die Aufnahmen an.
Wie wird das neue Attribut für die Subreferenzierung benannt?
Das wissen wir noch nicht. Derzeit lautet der Attributname für die Erstellung von Subreferenzen in der Wikitext-Implementierung extends. Die Wahl fiel vor einigen Jahren nach Diskussionen mit Communitys und Stakeholdern bei der Wikimedia Foundation auf diesen Namen. Wir haben jedoch einige Rückmeldungen erhalten, dass der Name möglicherweise nicht die beste Option ist. Bevor wir die Subreferenzierungsfunktion in die Wikis bringen, möchten wir mehr Rückmeldungen zum Attributnamen sammeln und planen, einige Alternativen zur Diskussion zu stellen. Wenn das passiert, geben wir Bescheid.
Warum wurde diese Wikitext-Syntax gewählt?
Als wir ursprünglich mit der Arbeit an der Wikitext-Lösung begonnen haben, haben wir verschiedene Optionen besprochen. Es wurde sorgfältig diskutiert, ob ein neues Tag (z.B. <subref>) erzeugt werden sollte. Letztlich wollten wir aber bei dem bestehenden <ref>-Ansatz bleiben, damit neue Benutzer*innen möglichst wenig neue Syntax erlernen müssen. Außerdem würde ein gänzlich neuer Tag mehr Aktualisierungen von bestehender Community-Software für Einzelnachweise (Tools, Helferlein, Bots usw.) erforderlich machen.
Ein Vorschlag (aus dem Jahr 2008) bestand darin, die Details der Subreferenz innerhalb des <ref>-Tags zu definieren: <ref page="page 2" name="Miller"> oder, als späterer Vorschlag, <ref detail="page 2" name="Miller">. Dabei würde das Attribut name verwendet, um auf die Hauptreferenz zu verweisen. Dieser Vorschlag ähnelt dem, was Benutzer:innen aus der Arbeit mit Vorlagen wie {{Literatur}} kennen.
Das Hauptproblem bei diesem Ansatz ist jedoch, dass er Probleme mit Vorlagen verursacht und sehr wahrscheinlich zu Fehlern führt. Ein weiteres Problem bei dieser Syntax ist, dass sie es nicht zulässt, eine Subreferenz selbst wiederzuverwenden, da das Attribut name bereits für die Hauptreferenz verwendet wurde und nicht ein zweites Mal verwendet werden kann.
Eine Möglichkeit, diese beiden Probleme zu vermeiden, besteht darin, ein neues Attribut zu schaffen und die Details der Subreferenz in den Bereich zwischen dem öffnenden und dem schließenden <ref>-Tag zu setzen, so wie es ja auch allgemein für den Inhalt von Einzelnachweisen gemacht wird. Dies ist der Ansatz, den wir umsetzen.
Warum hat es so lange gedauert, eine Lösung zu finden?
Das Team Technische Wünsche hat über mehrere Jahre immer wieder an diesem Problem gearbeitet. Hier ist eine Übersicht über die Geschichte und Komplexität dieses Projekts.