Wikipedia:Technische Wünsche/Topwünsche/Subreferenzierung

Subreferenzierung
 
Status In Arbeit
Ursprung Umfrage Technische Wünsche 2013, 2015, 2022 und andere
Themen-schwerpunkt Wiederverwendung von Einzelnachweisen
Phabricator Projektboard
Bearbeitende 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 hier ein, um zu erfahren, was Neues getestet werden kann.


Es ist umständlich, denselben Einzelnachweis mit unterschiedlichen Details in einem Artikel wiederzuverwenden. Seit Jahren wünschen Communitymitglieder sich eine MediaWiki-Lösung, die für Wikitext und Visual Editor funktioniert, ohne Vorlagen-Workarounds auskommt und auf der bestehenden Funktionsweise von Einzelnachweisen aufbaut. » Mehr über das Problem

Das Team Technische Wünsche entwickelt eine neue, optionale Funktion, mit der man Einzelnachweise leichter mit verschiedenen Details wiederverwenden kann, ohne sie zu duplizieren: Subreferenzierung.

Die Funktion ist hierzuwiki noch nicht verfügbar. Unser Plan ist, sie Ende 2024 auf den Wikimedia-Wikis bereitzustellen. Dieses Projekt gehört zum Themenschwerpunkt „Wiederverwendung von Einzelnachweisen vereinfachen“.

Subreferenzierung in Kürze

Bearbeiten

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 Visual Editor ändern wir den bestehenden Beleg-Dialog, sodass er Subreferenzen unterstützt.

Wichtigste Vorteile

Bearbeiten
  • Subreferenzierung basiert auf der bestehenden Art und Weise, wie Einzelnachweise funktionieren.
  • Subreferenzierung funktioniert sowohl für den Visual Editor als auch für Wikitext – aktuell ist es für Nutzer*innen des Visual Editors sehr viel umständlicher, dieselbe Quelle mit unterschiedlichen Details wiederzuverwenden, als für Wikitext-Nutzer*innen.
  • 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.
 
Bitte gib uns Feedback. Uns ist wichtig, dass die neue Funktion zu deinen Arbeitsabläufen passt, intuitiv ist und sowohl für Benutzer*innen vom Wikitext und Visual Editor gut funktioniert, unabhängig von ihrem Erfahrungsstand oder ihrem Wissen über Wikitext und Vorlagen. Dafür brauchen wir dich:

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

Bearbeiten
  • 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

Bearbeiten

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 stünde im Artikeltext ein Einzelnachweis ganz ohne Details. Die Syntax hierfür lautet:

<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<ref name="Lacroix">U. Lacroix, ''Solar Experts''. Grenoble: Le Grand, 2019.</ref></references>
<ref name="Papadopoulou">M. Papadopoulou, ''Stars''. Heraklion: Times Press, 2024.</ref>
</references>

Falls im Artikel bereits <references /> verwendet wird, muss dies entfernt werden, sonst kommt es zu Fehlern.

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>

 

 
Beachte

Wenn du im Wikitext 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:

  1. Wandle den Einzelnachweis in eine Hauptreferenz um, indem du <ref name> nutzt.
  2. Verschiebe ihn in den Abschnitt Einzelnachweise.
  3. Erstelle eine Subreferenz an der Stelle im Artikeltext, an der sich der ursprüngliche Einzelnachweis befunden hat.
  4. 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.
  5. 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

Bearbeiten
  • 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

Bearbeiten
  • 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)

Bearbeiten

Subreferenzen erstellen

Bearbeiten
  • Im „Belegen“-Dialogfeld kannst du unter „Weiterverwenden“ eine neue Option beim Einzelnachweis auswählen, für den eine Subreferenz erstellt werden soll. Diese Option ändert sich womöglich noch etwas nach unseren Nutzendentests.
     
  • 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

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

Bearbeiten
  • Du kannst Subreferenzen über „Weiterverwenden“ im „Belegen“-Dialogfeld erneut zu nutzen.
     

Bitte beachte

Bearbeiten
  • 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 und im Wikitext auch nicht machbar ist. In der finalen Lösung wird dies nicht mehr möglich sein.
  • 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-reference" 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:


 
Bitte beachte, dass sich das Betawiki von der deutschsprachigen Wikipedia unterscheidet.
  • 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.
  • Manche Seiten, Vorlagen, Helferlein oder Skripte sowie sonstige Inhalte, die du gewohnt bist, könnten fehlen.
  • Dein normales Konto funktioniert nicht im Betawiki. Du kannst entweder einen Account erstellen – bitte nutze ein anderes Passwort, als bei deinem normalen Konto – oder uneingeloggt testen. Dies würde zur Erstellung eines Temporären Kontos führen.

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.

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.

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

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:

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 Prototypen 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 Funktion auf der Wikimania präsentiert und mit den Teilnehmenden diskutiert. (YouTube, Englisch)
  •   Präsentation auf der WikiCon 2024
  •   Moderierte Nutzungsteste mit Benutzer*innen aus verschiedenen Wikis.
  • Aktuell (Oktober/November 2024) untersuchen wir mögliche Änderungen der Wikitextsyntax, basierend auf dem Communityfeedback, was wir erhalten haben. Dazu holen bitten demnächst erneut um Feedback.
  • Der Start mit ersten Pilotwikis verschiebt sich entsprechend, bis diese Änderungen diskutiert und ggf. umgesetzt sind.
  • Die Subreferenzierungsfunktion soll 2025 für Wikitext und den Visual Editor auf den Wikis bereitgestellt werden.
  • 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?

Bearbeiten

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?

Bearbeiten

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.

Wie wird das neue Attribut für die Subreferenzierung benannt?

Bearbeiten

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?

Bearbeiten

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 für die <ref>-Syntax 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?

Bearbeiten

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.