Extension:RevisionSlider

Manuel des extensions MediaWiki

RevisionSlider État de la version : stable
Implémentation	Interface utilisateur:
Description	Ajoute une visualisation de l’historique aux pages de comparaison de versions, facilitant la navigation entre celles-ci
Auteur(s)	Wikimédia Allemagne (WMDE)
Politique de compatibilité	branches de version
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) relecture du code
Accroches utilisées DiffViewHeader GetPreferences
Traduisez l’extension RevisionSlider sur translatewiki.net
Vérifiez la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signalez un bogue

L’extension RevisionSlider ajoute une visualisation de l’historique aux pages de comparaison de versions, afin de rendre la navigation dans l’historique plus aisée.

Installation

• Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé RevisionSlider dans votre dossier extensions/.

• 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, l'ascenseur 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.
	Once expanded, the RevisionSlider fetches data about the revisions and allows you to navigate and compare revisions on the diff page.
	Chaque barre verticale représente une modification 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 modification no 1 a ajouté du contenu, tandis que la modification no 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 : 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.
	Utilisez les flèches de part et d’autre pour vous déplacer dans l’historique et affiches des versions plus anciennes ou plus récentes.

Opt-out

If you are not using the RevisionSlider at all and also don't want to see the collapsed RevisionSlider bar at the top of the diff page, you can opt-out by checking Don't show the RevisionSlider in your preferences under Appearance -> Diffs.

Crochets JavaScript

RevisionSlider utilise AJAX pour recharger la page de différences lorsque de nouvelle versions sont sélectionnées. Lorsque le contenu a été rechargé, les deux crochets (hooks) wikipage.content et wikipage.diff sont activés. Si un script utilisateur ou une extension agit en JavaScript sur la page de différences, ils peuvent avoir besoin de s’abonner à ces crochets.

Exemples

• L’extension Thanks
• Le gadget wikEdDiff de la Wikipédia en anglais

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.

Contexte

RevisionSlider est une fonctionnalité conçue pour répondre à une des demandes figurant dans la liste de souhaits prioritaire 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 repartant d’un prototype de l’équipe Community Tech de la WMF.

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