Extension:RevisionSlider

Manuel des extensions MediaWiki

RevisionSlider État de la version : stable
Implémentation	Interface utilisateur
Description	Ajoute un curseur dans l'interface de visualisation des différences de version, facilitant la navigation entre celles-ci
Auteur(s)	Wikimédia Allemagne (WMDE)
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki	1.25+
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Accroches utilisées DifferenceEngineViewHeader GetPreferences
Téléchargements trimestriels	152 (Ranked 38th)
Utilisé par les wikis publics	957 (Ranked 262nd)
Traduire l’extension RevisionSlider sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L’extension RevisionSlider ajoute un curseur de visualisation de l’historique des pages de comparaison des versions, afin de rendre la navigation dans l’historique plus facile.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé RevisionSlider dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RevisionSlider
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'RevisionSlider' );
  

•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Utilisation

	Sur les pages de comparaison de versions, le curseur est réduit par défaut et seule une barre étroite « Parcourir l'historique » est visible en haut de la page. Cliquer sur cette barre pour visualiser l’historique.
	RevisionSlider récupère les données sur les révisions et vous permet de naviguer et de comparer les révisions.
	Chaque barre verticale représente une version de la page. Les barres dirigées vers le haut représentent une augmentation de la taille de la page, celles vers le bas une diminution. Sur l’image, la version 1 a ajouté du contenu, tandis que la version 2 en a retiré.
	Pour sélectionner les révisions que vous voulez comparer, utilisez les boutons jaune et bleu. Le curseur jaune permet de sélectionner la version la plus ancienne, le bleu la révision la plus récente. Il y a plusieurs façons de faire cela : Vous pouvez déplacer le bouton à la position désirée sur l'échelle des révisions. Vous pouvez cliquer à la position désirée sur l'échelle des révisions. Pour sélectionner une nouvelle révision, cliquez à la position désirée sur le bouton bleu et pour sélectionner une ancienne révision, cliquez à la position désirée sur le bouton jaune. Pour indiquer la révision que vous êtes sur le point de sélectionner, un aperçu de la page apparait sous le bouton bleu ou jaune apparaît et la barre devient bleue ou jaune. Vous pouvez cliquer sur l'échelle des révisions au-dessus de la ligne médiane (pour sélectionner la nouvelle révision) ou en dessous de la ligne (pour sélectionner l’ancienne révision). Cela vous donne également un aperçu de la page sous le bouton de l'échelle des révisions. Si vous déplacez le bouton bleu vers une position à gauche du bouton jaune, le bouton jaune est automatiquement déplacé le long, et vice versa si vous déplacez le bouton jaune à une position à droite du bouton bleu.
	Utilisez les flèches de part et d’autre pour vous déplacer dans l’historique et afficher des versions plus anciennes ou plus récentes.

Se désinscrire

Si vous n'utilisez pas du tout RevisionSlider et que vous ne voulez pas non plus voir la barre réduite de RevisionSlider en haut des pages de diff, vous pouvez vous désabonner du service en cochant Ne pas afficher la glissière des versions dans votre menu Préférences sous Apparence → Différences.

Questions techniques

Accroches JavaScript

RevisionSlider utilise AJAX pour recharger la page de différences lorsque de nouvelle versions sont sélectionnées. Lorsque le contenu de la page est rechargé, les deux accroches wikipage.content et wikipage.diff sont activées. Si le JavaScript d'un script utilisateur ou d'une extension agit sur la page des différences, il est possible que vous ayez à écouter sur ces accroches.

Exemples

• L’extension Thanks : phab:rETHA0b241d4d296f488dc7d3a1f4260aa0e426b2d7f5#1493b925
• Le gadget wikEdDiff de la Wikipédia en anglais : https://en.wikipedia.org/w/index.php?diff=741585034&oldid=630494053&title=User:Cacycle/wikEdDiff.js

Appels de l'API et recherche de données

Sauf s'il est développé, l'outil ne fait aucun appel à l'API. Seulement lorsque l'utilisateur développe le curseur, l'outil récupère les données concernant les versions : identifiant de version, horodatage, utilisateur, commentaire, taille et drapeaux. L'outil ne prend que les données des versions actuellement visibles à l'écran (au maximum 500 versions) et les données concernant les versions supplémentaires ne sont chargées que lorsque l'utilisateur se déplace (en arrière ou en avant) sur l'échelle des temps en utilisant les flèches.

Contexte

RevisionSlider est une fonctionnalité conçue pour répondre à une des demandes figurant dans la liste des souhaits prioritaires de la communauté allemande ; elle est développée par l’équipe TCB de la WMDE, inspirée par le gadget revisionjumper de DerHexer et repart d’un prototype de l’équipe Community Tech de la WMF.

Les notes (destinées plutôt à un auditoire technique) sur les problèmes RTL rencontrés lors du développement de l'extension ont été publiées sur une sous-page séparée.