Extension:RevisionSlider

Příručka k rozšířením MediaWiki

RevisionSlider Stav rozšíření: stabilní
Implementace	Uživatelské rozhraní
Popis	Přidává rozhraní posuvníku do zobrazení rozdílů, které umožňuje snadný přechod mezi revizemi
Autoři	Wikimedia Germany (WMDE)
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	1.25+
Změny v databázi	Ne
Použité háčky (hooks) DifferenceEngineViewHeader GetPreferences
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Přeložte rozšíření RevisionSlider, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření RevisionSlider přidává do zobrazení rozdílů rozhraní s posuvníkem, takže se můžete snadno pohybovat mezi revizemi.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného RevisionSlider ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
  

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'RevisionSlider' );
  

• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Použití

	Na stránce s rozdíly je posuvník ve výchozím nastavení sbalen a v horní části stránky je viditelný pouze úzký pruh s označením "Browse history" (historie procházení). Kliknutím na tento pruh posuvník revizí rozbalíte.
	Po rozbalení RevisionSlider načte data o revizích a umožní vám procházet a porovnávat revize na stránce rozdílů.
	Každý sloupec představuje revizi stránky. Sloupce nahoře ukazují nárůst velikosti stránky, sloupce dole zmenšení. Na obrázku představuje revize 1 přidaný obsah, zatímco revize 2 představuje odstraněný obsah.
	Pro výběr revizí, které chcete porovnat, použijte žlutý a modrý knoflík. Modrý knoflík ovládá novější revizi, žlutý knoflík mapuje na starší revizi. Existuje několik způsobů, jak to udělat: Knoflík můžete přetáhnout na požadovanou pozici na posuvníku. Můžete kliknout na požadovanou pozici na posuvníku. Chcete-li vybrat novější revizi, klikněte na modrou čáru a pro výběr starší revize klikněte na žlutou čáru. Pro indikaci, kterou revizi se chystáte vybrat, se zobrazí náhled modrého nebo žlutého knoflíku a pruh se zbarví do modra nebo žluta. Můžete kliknout do lišty nad prostřední čarou (pro výběr novější revize) nebo pod čarou (pro výběr starší revize). Zobrazí se vám také náhled knoflíku na prostřední čarě. Pokud přesunete modrý knoflík do polohy nalevo od žlutého knoflíku, žlutý knoflík se automaticky přesune, a naopak, pokud přesunete žlutý knoflík do polohy napravo od modrého knoflíku.
	Pomocí šipek zpět a vpřed se můžete pohybovat v historii revizí a zobrazovat starší a novější revize.

Odhlášení

Pokud RevisionSlider vůbec nepoužíváte a také nechcete vidět sbalený panel RevisionSlider v horní části stránky s rozdíly, můžete se odhlásit zaškrtnutím políčka "Nezobrazovat posuvník revizí" v nastavení v části "Vzhled" → "Porovnání verzí".

Technické informace

JavaScriptové háčky

RevisionSlider používá AJAX k opětovnému načtení stránky diff při výběru nových revizí. Po opětovném načtení stránky se spustí háčky wikipage.content a wikipage.diff. Pokud na stránce diff pracuje uživatelský JavaScript nebo rozšiřující JavaScript, budete možná muset těmto háčkům naslouchat.

Příklady

• Rozšíření Thanks: phab:rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• Gadget wikEdDiff pro anglickou Wikipedii: https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

Volání API a načítání dat

Pokud není posuvník rozbalen, nástroj neprovádí žádná volání API. Pouze když uživatel rozbalí posuvník, načte data o revizích (ID revize, časové razítko, uživatel, komentář, velikost a příznaky). Nástroj načte data pouze pro revize, které jsou aktuálně viditelné na obrazovce (maximálně 500 revizí) a data o dalších revizích se načtou pouze tehdy, když se uživatel pohybuje tam a zpět na časové ose pomocí šipek.

Podklady

RevisionSlider je funkce, která splňuje jedno z hlavních přání německé komunity, , a je vyvinuta týmem TCB WMDE. Je inspirována DerHexerova revisionjumper gadgetem a založena na prototypu od Community Tech týmu WMF.

Poznámky (pro spíše technické publikum) k problémům s psaním zprava doleva, které byly zjištěny při vývoji rozšíření, byly publikovány na samostatné podstránce.