Erweiterung:RevisionSlider
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 | |
Quarterly downloads | 154 (Ranked 37th) |
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 Ordnerextensions/
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. | |
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:
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[1] ist eine Funktion, um einen der Top-Wünsche der deutschen Community Wunschliste[2] 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.
Einzelnachweise
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |