Erweiterung:RevisionSlider

MediaWiki-Erweiterungen

RevisionSlider Freigabestatus: stabil
Einbindung	Benutzer-Schnittstelle
Beschreibung	Fügt ein Schieberegler-Interface zur Unterschiede-Ansicht hinzu, welches das einfache Wechseln zwischen Versionen ermöglicht.
Autor(en)	Wikimedia Germany (WMDE)
Kompatibilitätspolitik	Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
MediaWiki	1.25+
Datenbankänderungen	Nein
Lizenz	GNU General Public License 2.0 oder neuer
Herunterladen	Erweiterung herunterladen Git [?]: Git master herunterladen Repository durchsuchen (GitHub) Ergänzungen und Änderungen Repository-Mitwirkende (GitHub) Code-Review
Verwendete Hooks DifferenceEngineViewHeader GetPreferences
Quarterly downloads	152 (Ranked 38th)
Public wikis using	957 (Ranked 262nd)
Übersetze die RevisionSlider-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme	Offene Aufgaben · Einen Fehler melden

Die Erweiterung RevisionSlider (Versionsblätterer) fügt ein Schieberegler-Interface zur Unterschiede-Ansicht hinzu, welches dir das einfache Wechseln zwischen Revisionen ermöglicht.

Installation

• Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens RevisionSlider im Ordner extensions/ ablegen.
  Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
• Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:

  wfLoadExtension( 'RevisionSlider' );
  

•  Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Verwendung

	Beim Besuch einer Versionsunterschiede-Seite ist der Versionsblätterer standardmäßig eingeklappt und nur als schmaler, mit „Versionsgeschichte durchsuchen“ beschrifteter Balken über dem Versionsunterschied sichtbar. Einfach auf diesen Balken klicken, um den Versionsblätterer auszuklappen.
	Sobald der Versionsblätterer ausgeklappt wurde, lädt er Daten zu den verfügbaren Versionen und hilft somit die verschiedenen Versionen zu vergleichen und zwischen ihnen zu navigieren.
	Jeder Balken repräsentiert eine Version. Balken nach oben zeigen einen Zuwachs der Größe der Seite, Balken nach unten eine Reduzierung an. In dem Bild repräsentiert Version 1 hinzugefügten und Version 2 entfernten Inhalt.
	Um verschiedene Versionen zu vergleichen, wähle diese auf der Zeitleiste des Versionsblätterers mit dem gelben und dem blauen Zeiger aus. Der blaue Zeiger steuert die neuere Version, der gelbe die ältere. There are several ways to do this: You can drag and drop the knob to the desired position on the slider. You can click on the desired position on the slider line. To select the newer revision, click on the blue line, and for selecting the older revision, click on the yellow line. To indicate which revision you're about to select, a preview of a blue or yellow knob appears and the bar turns blue or yellow. You can click into the bar above the middle line (to select the newer revision) or below the line (to select the older revision). This also gives you a preview of the knob on the middle line. If you move the blue knob to a position left of the yellow knob, the yellow knob is automatically moved along, and vice versa if you move the yellow knob to a position right of the blue knob.
	Nutze die Rückwärts- und Vorwärts-Pfeile, um in der Versionsgeschichte zu navigieren und neuere und ältere Versionen anzuzeigen.

Versionsblätterer deaktivieren

Der Versionsblätterer kann in den Einstellungen unter Aussehen -> Versionsvergleich komplett deaktiviert werden, indem bei Den Versionsblätterer nicht anzeigen ein Haken gesetzt wird.

Technische Hintergründe

JavaScript-Hooks

Jedes Mal, wenn neue Versionen auf der Zeitleiste des Versionsblätterers ausgewählt werden, wird per AJAX die Unterschiede-Seite neu geladen. Nachdem das Neuladen abgeschlossen ist, werden sowohl der wikipage.content-als auch der wikipage.diff-Hook (deutsch: Einschubmethode) ausgeführt. Dies ist insbesondere wichtig für von Benutzern oder anderen Erweiterungen definiertes JavaScript, das ebenfalls mit der Unterschiede-Seite interagiert. In diesem Fall kann es nötig sein, die oben genannten Hooks zu verwenden.

Beispiele

• Die Danke-Erweiterung https://phabricator.wikimedia.org/rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• Das wikEdDiff Helferlein auf der Englischen Wikipedia: https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

API-Anfragen & Laden von Daten

Solange der Versionsblätterer noch nicht ausgeklappt wurde, werden keinerlei API-Anfragen geschickt. Nur wenn ein Benutzer den Versionsblätterer ausklappt, lädt die Anwendung Daten über die verfügbaren Versionen (Versions-ID, Zeitstempel, Benutzer, Kommentar, Größe und Flags). Die Anwendung lädt jedoch nur Daten der Versionen die auch am Bildschirm (auf der Zeitleiste des Versionsblätterers) sichtbar sind (maximal 500 Versionen). Daten von weiteren Versionen werden nur geladen wenn sich der Benutzer auf der Zeitleiste des Versionsblätterers mittels der Pfeile vor- oder zurückbewegt.

Unless expanded, the tool is not doing any API calls. Only when the user expands the slider, it fetches data about revisions (revision-id, timestamp, user, comment, size and flags). The tool only fetches data for revisions that are currently visible on the screen (maximum 500 revisions) and data about additional revisions is only loaded when the user navigates back or forth on the timeline using the arrows.

Hintergrund

Der Versionsblätterer ist eine Funktion, um einen der Top-Wünsche der deutschen Community Wunschliste zu erfüllen, und ist vom TCB Team von WMDE entwickelt worden. Er ist durch das revisionjumper Gadget vom Nutzer DerHexer inspiriert und basiert auf einem Prototypen des Community Tech team der Wikimedia Foundation.

Notes (for rather technical audience) on RTL issues discovered while developing the extension have been published on the separate subpage.