Rozszerzenie:RevisionSlider

Podręcznik rozszerzeń MediaWiki

RevisionSlider Status wydania: stabilne
Realizacja	Interfejs użytkownika
Opis	Dodaje pasek przesuwania do widoku różnic, pozwalający na łatwe przemieszczanie się pomiędzy wersjami.
Autor(zy)	Wikimedia Germany (WMDE)
Polityka zgodności	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.25+
Zmiany w bazie danych	Nie
Licencja	GNU General Public License 2.0 or later
Pobieranie	Download extension Git [?]: Pobierz Git master przeglądaj repozytorium (GitHub) historia wprowadzeń repository contributors (GitHub) ocena kodu
Użyte haki DifferenceEngineViewHeader GetPreferences
Przetłumacz rozszerzenie RevisionSlider jeżeli jest dostępne na translatewiki.net
Sprawdź wykorzystywanie i matrycę wersji.
Problemy	Otwarte zadania · Zgłoś błąd

Rozszerzenie RevisionSlider dodaje pasek przesuwania do widoku różnic, pozwalający na łatwe przemieszczanie się pomiędzy wersjami.

Instalacja

• Pobierz i umieść plik(i) w katalogu o nazwie RevisionSlider w folderze extensions/.
• Dodaj poniższy kod na dole swojego pliku LocalSettings.php:

  wfLoadExtension( 'RevisionSlider' );
  

•  Zrobione – Przejdź do Special:Version na swojej wiki, aby sprawdzić czy rozszerzenie zostało pomyślnie zainstalowane.

Użycie

	Na stronie porównywania zmian suwak jest domyślnie schowany i widoczny jest tylko pasek z napisem "Przeglądaj historię" na górze strony. Kliknij na niego, aby wysunąć RevisionSlider.
	Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.
	Każdy pasek reprezentuje wersję strony. Słupki na górze pokazują przyrost rozmiaru strony, słupki na dole jej redukcję. Na obrazku, wersja 1. reprezentuje dodaną treść, podczas gdy wersja 2. reprezentuje usunięcie treści.
	Aby porównać poszczególne wersje, wybierz wersje za pomocą żółtego i niebieskiego wskaźnika. Niebieski wskaźnik wybiera nowszą wersję, żółty wskaźnik wybiera starszą wersję. 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.
	Użyj strzałek wstecz i dalej, aby przemieszczać się w historii edycji i pokazywać starsze i nowsze wersje.

Opt-out

Jeśli nie używasz rozszerzenia RevisionSlider i nie chcesz widzieć paska na górze strony, możesz go ukryć zaznaczając Nie pokazuj Suwaka Wersji w twoich preferencjach w zakładce Wygląd -> Zmiany.

Technical Background

JavaScript Hooks

The RevisionSlider uses AJAX to reload the diff page when new revisions are selected. Once the page has been reloaded both the wikipage.content and wikipage.diff hooks are fired. If user JavaScript or extension JavaScript acts on the diff page you may need to listen to these hooks.

Examples

• The Thanks extension https://phabricator.wikimedia.org/rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• The English Wikipedia wikEdDiff gadget https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

API calls & fetching data

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.

Wizja

RevisionSlider jest funkcją spełniającą jedno z najważniejszych życzeń niemieckiej społeczności i jest tworzone przez zespół WMDE TCB. Został zainspirowany przez gadżet revisionjumper DerHexera i bazuje na prototypie opracowanym przez WMF Community Tech team.

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