Aide : Diff
 |
Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public. | |
Un diff (abréviation de « différence ») affiche les changements entre deux révisions d’un article. Les diffs sont un composant fondamental pour la navigation et la modération de contenu sur les wikis MediaWiki.
La plate-forme de l'écosystème du wiki comporte différentes versions d'un même diff, qui dépendent de l'appareil sur lequel on va consulter les données et de l'installation de MediWiki proprement dite.
Quand et pourquoi utiliser un diff ?
La principale raison d'utiliser un diff est de vérifier un changement spécifique à une page faite par vous-même ou par quelqu'un d'autre. Il y a beaucoup de raisons possibles d'utiliser un diff :
- Aider à détecter des cas de vandalisme
- Voir que quelqu'un a ajouté ou supprimé une section, une phrase ou un mot
- Savoir lequel des éditeurs a été utilisé pour faire le(s) changement(s)
- En tant que base de départ pour d'autres actions, car le diff contient modifier, annuler et d'autres mesures, ainsi que des liens vers la page du contributeur et les pages de discussion.
Comment afficher un diff ?
La manière la plus courante est de passer par l'« historique des révisions ». Qui est accessible via l'onglet « Voir l’historique ». À partir de là, vous pouvez utiliser « diff » pour voir les diffs de révisions uniques ou traverser les diffs de révisions multiples, via les boutons radio et le bouton « Comparer les versions sélectionnées ».
La plupart des pages spéciales qui listent les modifications incluent des liens vers ces diffs, comme :
Une manière différente de visualiser un diff est d'utiliser la page Special:Diff.
Pour l'utiliser, vous devez connaître les identifiants des révisions que vous voulez comparer.
Les identifiants de révision peuvent être récupérés en regardant la partie diff=123 d'une URL de diff, où 123 est l'identifiant du diff.
En outre, vous pouvez utiliser la valeur du paramètre oldid pour obtenir le diff entre cette révision et la précédente.
Composantes d'une page de diff
Vous trouverez ci-dessous une représentation des composants importants de la page de diff affichés lorsque vous comparerez les différences entre deux versions.
Cet exemple interactif montre le haut de la page de diff (certains des liens sont simulés).
La révision la plus ancienne est affichée à gauche, la plus récente à droite.
Ligne 8 : Ligne 8 : For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one. For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one. − This is only shown when viewing the diff between the currentversion and the oneimmediately preceding it.+ This is only shown when viewing the diff between the recent version of a page and the last version by an author other than the one of the most current version. This example shows the top of the diff page, with the links described above. This example shows the top of the diff page, with the links described above. Ligne 25 : Ligne 25 : </table> </table> + [[MediaWiki User's Guide]] +
Texte qui n'a pas été modifié
Le texte inchangé est gris foncé sur fond gris clair (seules les parties précédant et suivant la modification sont affichées).
| Diff précédent | Diff le plus récent | ||
|---|---|---|---|
| |||
Texte déplacé
Un texte non modifié, mais qui a été déplacé, est généralement affiché comme un texte ajouté puis supprimé. Sur les installations de MediaWiki utilisant Wikidiff2, il peut y avoir une icône de flèche indiquant plus clairement où se trouve le texte déplacé.
Texte ajouté
Les lignes contenant du texte ajouté sont précédées d'une icône « plus » (+). Les mots et les caractères ajoutés sont affichés en surbrillance et en gras.
Texte supprimé
Les lignes contenant du texte supprimé sont précédées d'une icône « moins » (−). Les mots et les caractères supprimés sont affichés en surbrillance et en gras.
Texte remplacé
On peut voir ce qui a été remplacé par un nouveau contenu car il y a une icône + et une icône − de chaque côté de la phrase où le changement a été effectué.
Les paragraphes modifiés sont en noir sur fond blanc, avec un surlignage orange sur la partie ancienne révision et bleu pour la nouvelle.
Les insertions et les suppressions sont mises en évidence par la couleur de surlignage et la graisse typographique. Quand des paragraphes entiers ont été supprimés ou insérés, aucun surlignage ou changement de graisse n'est appliqué et l'autre côté est vide.
| Ancienne révision | Nouvelle version | ||
|---|---|---|---|
| |||
| Ancienne révision | Nouvelle version | ||||
|---|---|---|---|---|---|
| |||||
| Ancienne révision | Nouvelle version | ||
|---|---|---|---|
| |||
Créer un lien vers un diff
On peut créer ce type de liens en copiant l'URL pendant que le diff est visible ; cette URL a deux paramètres, diff et oldid.
On peut aussi créer ce type de liens à partir d'une URL externe en utilisant l'URL complète, par exemple :
https://mediawiki.org/w/index.php?diff=1242287
La page spéciale Special:Diff facilite la création d'URLs raccourcies qui redirigeront vers le diff.
En interne, ces liens peuvent prendre les formes suivantes :
[[Special:Diff/1242287]]→ Special:Diff/1242287 – Affiche le diff par rapport à la modification précédente de la même page.[[Special:Diff/1242287/prev]]→ Special:Diff/1242287/prev – Affiche le diff par rapport à la modification précédente de la même page.[[Special:Diff/1242287/next]]→ Special:Diff/1242287/next – Affiche le diff par rapport à la modification suivante de la même page.[[Special:Diff/1242287/cur]]→ Special:Diff/1242287/cur – Affiche le diff de la modification courante de la même page.[[Special:Diff/1242286/1242287]]→ Special:Diff/1242286/1242287 – Affiche le diff entre les modifications spécifiques de la même page qui peuvent également être annulées, par exemple[[Special:Diff/1242287/1242286]]→ Special:Diff/1242287/1242286, bien que cela soit déconseillé.
Ces liens peuvent être utilisés dans l'édition du sommaire aussi bien qu'adaptés comme n'importe quel autre lien interne, par exemple[[Special:Diff/1242286/1242287|voir le diff]] → voir le diff.
Par exemple, la totalité de l'URL [https://mediawiki.org/w/index.php?diff=1242287 1242287] pourrait également être écrite ainsi : [[Special:Diff/1242287|1242287]].
Par défaut, la dernière modification de l'article est affichée sous le diff ; ce qui peut être désactivé via les préférences (« Ne pas afficher le contenu des pages sous les diffs ») ou en renseignant diffonly=1 dans l'URL.
On peut créer des liens vers des diffs sans le texte de l'article :
{{canonicalurl:Special:Diff/1242287|diffonly=1}}→ https://www.mediawiki.org/w/index.php?title=Special:Diff/1242287&diffonly=1
Diffs en ligne
| Version de MediaWiki : | ≥ 1.35 |
Depuis la version 1.35 de MediaWiki, un diff « en ligne » (diff unifié) est disponible.
Depuis 2022, ce n'est disponible qu'avec le moteur wikidiff2.
On peut accéder aux diffs en ligne en passant le paramètre diff-type=inline dans l'URL ([exemple https://www.mediawiki.org/w/index.php?diff=1242287&diffmode=source&diff-type=inline]).
| Version de MediaWiki : | ≥ 1.41 |
À partir de MediaWiki 1.41, une commutation a été ajoutée aux pages de diffs qui permet aux utilisateurs de passer du mode « en ligne » au mode « deux colonnes » dans l'interface utilisateur (T336716).
Content added Content deleted
For sysops and those with the rollback flag, a revert button is shown allowing them to revert from the new version to the old one.
This is only shown when viewing the diff between the
currentversion and the one of a page and the last version by an author other than the one of the most current version.. This example shows the top of the diff page, with the links described above.</table>
[[MediaWiki User's Guide]]
↲ newline
Les modifications suivantes ont été ajoutées pour les diffs « en ligne » :
- Les légendes et les conseils qui expliquent les surlignages bleu et orange. (T324759)
- Cette annotation représente l'ajout ou la suppression d'une ou plusieurs lignes. (T330247)
Comment faire remonter des bogues ?
Les bogues doivent être déclarés via reported on Phabricator derrière le #MediaWiki-Page-diffs.
Préférences de l'utilisateur
Les préférences utilisateur sont disponibles dans la section« Différences » de l'onglet des préférences « Apparence » :
- Ne pas afficher le contenu des pages sous les diffs
- Faites passer l'affichage du texte de l'article en-dessous du diff. Ce texte est le dernier des deux modifications de l'article.
- Ne pas afficher le diff après avoir révoqué
- Montrer le diff d'un retour en arrière après celui-ci.
Certaines extensions ajoutent également leurs propres préférences liées aux diffs. L'une de ces extensions est Extension:RevisionSlider, qui peut être désactivée dans les préférences en utilisant « Ne pas afficher la glissière des versions » dans cette section.
Voir aussi
- Aide:Historique — Navigation et compréhension de l'historique de l'article.
- Différences visuelles — Les diffs à travers les extensions « VisualEditor » et « VisualDiff ».
| Lecture |  | |
|---|---|---|
| Modifier | ||
| Avancé | ||
| Personnel | ||
| Administrateur | ||