Aide : Résumé des modifications
 Manuel de MediaWiki : I. Lecteurs – II. Éditeurs – III. Administrateurs Index | Guide pour le manuel | Principes éditoriaux | MediaWiki | +/- |
Lors de la modification d’une page, il y a un champ appelé « résumé » sous le cadre principal, comme dans l’image suivante.
Renseigner le champ du résumé des modifications, ou le compléter dans le cas d’une modification de section est une bonne pratique, car elle permet à tout le monde de comprendre ce qui a changé, par exemple pour retracer l’historique de la page, sans avoir à ouvrir chacune des révisions. De plus cela permet de garder les informations de paternité après la suppression d'une longue modification dans le cas de violation des droits d'auteur[1] Définir vos préférences utilisateur (onglet Modification) pour « M’avertir lorsque j’ai laissé vierge le résumé de modification » est une bonne idée. (Si vous voulez vraiment le laisser vide, confirmez simplement le message ou saisissez une espace pour éviter le message.)
Dans le cas d’une substitution, indiquer la ligne de wikicode contenant « subst: » dans le résumé des modifications est particulièrement utile, parce que la substitution ne s’affiche pas comme telle dans le diff.
Propriétés
Le champ de résumé des modifications peut contenir une ligne de 800 caractères, avec une taille maximale de 1 000 octets (la dernière restriction n’a aucun effet sur les textes en ASCII 7 bits, mais en UTF-8, tout caractère hors ASCII occupe 2 à 4 octets). Si vous tentez de saisir ou de coller un texte plus grand, seuls les 800 premiers caractères seront affichés et le reste sera ignoré. Par exemple, essayer d’ajouter 10 nouveaux caractères à n’importe quel endroit dans un résumé contenant déjà 795 caractères résultera en la troncation de tout le texte après le 800e caractère.
Dans les résumés de modifications, les liens internes et interwikis fonctionnent mais avec certaines limitations (voir plus bas).
Les autres éléments de wikicode ne sont pas interprétés :
- les variables, modèles et fonctions d’analyse syntaxique ne sont pas développés ;
- les liens externes ne fonctionnent pas ;
- les balises HTML ne fonctionnent pas ;
- l’italique, le gras, etc. ne fonctionnent pas (les résumés de modifications sont affichés en italique par défaut) ;
- les balises
<nowiki>ne fonctionnent pas, par exemple [[a]] ne peut pas être affiché (il sera rendu comme <nowiki>a</nowiki>), on peut utiliser [[a]] (avec une espace de taille nulle entre les crochets gauches) ou [ [a] ] à la place.
Lorsque vous cliquez sur le bouton Aperçu, un aperçu du résumé des modifications est également affiché en plus de l’aperçu de la page modifiée. Même si le résumé est trop long pour être vu entièrement dans la boite de résumé sans avoir besoin de défiler, il sera affiché entièrement dans l’aperçu et dans l’historique de la page.
Presser Entrée dans la boîte du résumé des modifications a le même effet que de presser sur Publier les modifications. Faites attention à ne pas faire cela par accident quand vous entrez le résumé des modifications, car un résumé incomplet pourrait ne pas avoir de sens, et il ne peut pas être modifé. Une modification vide ultérieure comme l'ajout d'une espace supplémentaire à un endroit qui ne change pas le rendu de la page, est le moyen de fournir un résumé de correction correct de la correction précédente.
Faire un lien vers une section
Le nom d’une ancre, encadrée entre /* et */, produit une flèche vers la droite liée à l’ancre en question sur la page, suivi par le nom de l’ancre avec la classe CSS « autocomment » → Texte de l’ancre. Cela revient au wikicode « <span class="autocomment">[[#Une ancre|→]] Texte de l’ancre</span> ».
Les séparateurs sont automatiquement fournis lorsque nécessaires (c’est-à-dire entre la syntaxe /* */ et le texte dans n’importe quel ordre). Par exemple, le résumé des modifications :
/* Foo */ test /* Bar */ test
est rendu comme ceci :
Pour plus de flexibilité, ces liens vers des ancres spéciales peuvent être remplacées par des liens ordinaires vers des pages redirigeant vers les ancres désirées (voir aussi ci-dessous).
Modification d’une section
Lorsque vous modifiez une section existante, le titre de cette section est inséré automatiquement au début du résumé, entouré des symboles /* et */, par exemple /* Liens externes */.
Si votre modification inclut un changement dans le nom de la section, il est utile de changer le nom de section dans le résumé des modifications également, afin que le lien vers la section fonctionne vraiment une fois la modification sauvegardé (jusqu’à ce que le nom de la section soit encore une fois changé, comme les liens n’évoluent plus une fois publiés).
Si vous créer une nouvelle section avant ou après la section existante en ayant cliqué sur le lien « modifier » de la section, modifiez ou enlevez le texte entre /* et */ pour éviter les confusions.
Les détails de la modification devrait être ajoutés après ce texte. Dans le cas où vous auriez fourni un long résumé vous-même, vous pouvez considérer la suppression du titre de section afin de rester dans la limite des 800 caractères, selon ce qui est le plus important.
Liens internes et interwikis dans les résumés de modification
Dans les résumés de modification, les liens internes, y compris la détection de l’existence de la page et les liens interwikis fonctionnent. L’ajout d’une barre verticale dans ces liens fonctionne également.
Au cas où vous utilisez l’astuce de la barre verticale, la barre verticale est ignorée (mais le lien fonctionne).
Les liens peuvent être vérifiés dans l’aperçu du résumé des modifications.
Les Pages liées n’incluent pas les liens dans les résumés de modifications.
Codes pourcent
Si la cible d’un lien contient un signe % suivi de deux chiffres hexadécimaux, le lien ne fonctionne pas et le contenu du lien s’affiche comme du texte brut sans crochet. S’il s’agit d’un lien avec barre verticale, la cible du lien est perdue.
Par conséquent, alors que sur la page elle-même, les morceaux de wikicode [[w:Wikipedia:Village_pump_%28technical%29#Abc]] et [[w:Wikipedia:Village pump (technical)#Abc]] sont équivalents (affichent w:Wikipedia:Village_pump_(technical)#Abc et w:Wikipedia:Village pump (technical)#Abc), seul le second fonctionne dans un résumé de modifications.
Dans une URL, tous les caractères autres que [[-:/.]], les chiffres 0–9 et les lettres A–Z et a–z sont encodés avec un ou deux signes % suivis par deux chiffres hexadécimaux (suivez le lien pour confirmer que ces quatre caractères ne sont pas impactés).
Ces codes apparaissent, dans la pratique, lorsque le nom d’une page contient des caractères spéciaux (c’est-à-dire d’autres caractères que ceux mentionnés précédemment) et qu’un lien vers une section de cette page est créé en copiant une partie de l’URL vers cette section, ce qui, par conséquent est produit par un lien de la table des matières. Cela n’est pas le cas si seul le nom de la section contient des caractères spéciaux, parce que ans une URL, ils sont encodés à l’aide d’un point suivi de deux chiffres hexadécimaux. Ainsi, l’ancre en elle-même ne pose pas de problème, le fait qu’il y ait une ancre rend plus facile à utiliser l’URL, ce qui donne ce problème.
Pour contourner cela et obtenir un lien fonctionnel dans le résumé des modifications, vous pouvez :
- utiliser l’URL, mais remplacer les codes par les caractères en question à la main (ce n’est pas pratique pour les langues où de nombreux caractères sont encodés) ;
- créer une redirection pour arriver sur la page, par exemple w:WP:VPT ;
- utiliser le lien de la table des matières, obtenir la partie de l’URL depuis le nom de la page, si nécessaire rajoutez le préfixe interwiki, et utilisez le résultat comme cible du lien dans la page comme dans le résumé des modifications ;
- assemblez le nom de la page, #, le nom de la section lui-même ; le nom de la page peut être copié depuis le titre d’entête de l’article, ou, s’il a une redirection courte, le nom de la page peut aussi être facilement tapé : nous obtenons w:WP:VPT#Abc où l’ancre est typiquement plus facile à copier (étant plus longue qu’ici), mais le reste est simplement tapé.
Flexibilité
Puisque le résumé ne peut pas être modifié après avoir sauvegardé la page, déplacer les contenus d’une cible d’un lien peut être problématique, et cela arrive souvent : le déplacement vers une archive est souvent prévisible.
- Dans le cas d’un renommage de page, une redirection est créée ; cependant, s’il y a besoin de l’ancien nom pour une nouvelle page, le lien ne fonctionnera plus.
- Dans le cas d’un lien vers une section, si le nom de la section est changé, une ancre peut être créée avec l’ancien nom de la section.
- Dans le cas d’un lien vers une section, si le contenu est déplacé vers une autre section, le lien mènera toujours vers l’ancienne section.
- Dans le cas d’un lien vers une ancre placée explicitement, l’ancre peut être déplacée avec le contenu, alors que d’autres liens vers l’ancre peuvent avoir besoin de mener vers l’autre position également.
Pour anticiper ces problèmes, il est possible de :
- créer un lien vers une page ayant un nom qui décrit précisément et sans ambigüité la cible souhaitée ;
- si la page n’existe pas, créer une une redirection vers la page désirée, éventuellement avec une ancre.
Même si le résumé des modifications ne change jamais, la redirection peut être changée à volonté.
Cette méthode est aussi utile pour remplacer les liens automatiques vers les sections : elle permet une flexibilité quant au renommage des sections.
Fonction « Publier un commentaire »
Quand vous commencez un nouveau sujet sur une page de discussion, ou une nouvelle page avec __NEWSECTIONLINK__, la fonction « Publier un commentaire » peut être utilisée. Cliquez sur le signe plus à côté du lien Modifier (dans l’apparence MonoBook). Un champ intitulé « Sujet/Titre » apparait avant la boite principale de modification et le champ Résumé des modifications n’apparait pas. Le texte inséré dans le champ Sujet devient à la foi le résumé des modifications et un nouveau titre de section (qui est ajouté à la fin de la page), et le texte entré dans le champ principal de modification est inséré en dessous de ce titre.
Voir aussi l’aide sur l’ajout de section à la fin.
Résumés automatiques
Dans certaines circonstances, un résumé automatique est généré lorsqu’une modification est sauvegardée sans. Celui-ci est à distinguer du résumé ajouté lorsqu’une section est modifiée car dans ce dernier cas, l’utilisateur peut le modifier avant de sauvegarder.
| Situation | Page | Texte |
|---|---|---|
| Longues modifications de pages | ||
| Suppression de tout le contenu d’une page | MediaWiki:Autosumm-blank | Page blanchie |
| Suppression de la plupart du contenu d’une page, ou modification d’une page courte (« $1 » est remplacé par le contenu de la page) |
MediaWiki:Autosumm-replace | Contenu remplacé par « $1 » |
| Création de pages | ||
| Création d’une nouvelle page ($1 est remplacé par le contenu de la page) | MediaWiki:Autosumm-new | Page créée avec « $1 » |
| Création d'une nouvelle page sans contenu | MediaWiki:Autosumm-newblank | Page vide créée |
| Modification des redirections | ||
| Création ou remplacement d’une page par une redirection (« $1 » est remplacé par la cible de la redirection) |
MediaWiki:Autoredircomment | Page redirigée vers [[$1]] |
| Modifier la cible d'une redirection ('$1' est remplacé par la l'ancienne cible de la redirection ; '$2' est remplacé par la nouvelle cible de la redirection) |
MediaWiki:Autosumm-changed-redirect-target | Destination de redirection modifiée de [[$1]] en [[$2]] |
| Supprimer une redirection ('$1' est remplacé par la cible de la redirection) |
MediaWiki:Autosumm-removed-redirect | Redirection supprimée vers [[$1]] |
À l’exception du résumé automatique lors de la création d’une redirection, qui indique généralement tout ce qu’il y a besoin de savoir, ces résumés ne se substituent pas au résumé des modifications proprement dit : il faudrait toujours laisser un véritable résumé, même dans les cas précédents. Ils sont cependant utiles pour fournir un contexte pour les modifications faites par des utilisateurs inexpérimentés qui ne sont pas conscients de l’importance des résumés des modifications, et pour repérer le vandalisme.
Multilingual edit summaries
Some software features, especially Wikidata-related ones, use multilingual automatic summaries via the autocomment functionality of MediaWiki. These appear in the language of the user looking at the wiki. In tools that display the raw edit summary, they usually look like an i18n message key inside a comment, such as /* wbsetsitelink-add:1|frwiki */.
Balises automatiques
Selon le type de modification, le logiciel ajoutera une balise spéciale, comme Modification par mobile ou Révocation manuelle.
Endroits où le résumé des modifications apparait
Le résumé des modifications apparaitra en italique et en noir aux endroits suivants :
de manière permanente :
- dans l’historique de la page : liste des modifications d’une page précise, affiche aussi la taille du wikicode en octets pour les modifications à partir du 19 avril 2007 (pour les wikis Wikimedia),
- dans les contributions de l’utilisateur : liste des modifications d’un utilisateur précis ;
temporairement (voir le manuel de MediaWiki sur $wgRCMaxAge) :
- sur la Liste de suivi : liste des modifications récentes sur les pages suivies (utilisateurs connectés uniquement), affiche aussi la taille des changements du wikicode en octets, utilisez la liste de suivi améliorée pour voir tous les changements récents dans les pages suivies et pas seulement le dernier changement de chaque page,
- sur la page de diff : affiche les différences entre deux révisions,
- dans les Modifications récentes et modifications récentes améliorées : liste toutes les modifications récentes, affiche aussi la taille des changements du wikicode en octets,
- dans les canaux IRC de Wikipédia : liste en temps réel de toutes les modifications,
- dans le Suivi des pages liées : liste des changements dans les pages liées à la page, affiche aussi les changements de taille en octets dans le wikicode,
- dans la liste des nouvelles pages : affiche le résumé de modification de la création, affiche aussi la taille actuelle du wikicode en octets.
Le résumé des modifications apparait aussi dans le courriel reçu s’il y a une notification par courriel.
Regardez aussi l’aide sur le suivi des changements.
Résumé du téléversement de fichiers
Quand vous téléversez un fichier, il est possible d’iniquer un résumé du téléversement du fichier. Cela a plusieurs buts :
- être la seconde partie du résumé de modification créé automatiquement dans le journal de téléversement (la première partie donnant le nom du fichier) ;
- être indiqué dans une écriture de l’historique d’une image ;
- au cas où le nom de fichier de l’image est nouveau :
- servir de résumé des modifications pour la création de la page de l’image,
- servir de wikicode pour la partie modifiable de la page de l’image, ce qui inclut les possibilités suivantes :
- décrire brièvement l’image,
- fournir des liens internes ou externes,
- appeler des modèles,
- indiquer une ou plusieurs catégories à laquelle l’image appartient.
Le résumé prend la forme d’une ligne de 250 caractères maximum ; dans le journal des téléversements, la fin peut ne pas s'afficher, car il y a une limite de 255 caractères incluant le nom du fichier.
Attention, il n’y a pas de moyen de prévisualiser le message pour vérifier le code pour les liens, les appels de modèle et le marquage des catégories. Bien sûr, si cela est nécessaire, il sera tout de même possible de modifier l’image après qu’elle a été téléversée pour corriger les erreurs et aussi détailler le texte.
Voir aussi la page d’aide sur les images.
Modifier un résumé de modification
Changer un résumé de modification est fastidieux et nécessite d’importer (c’est pourquoi cela doit être activé sur le wiki et il faut que l’utilisateur ait cette permission) : exportez la page avec l’historique, supprimez la page, réalisez le changement dans le fichier XML et importez-le à nouveau. Pour changer le résumé de modification de la révision actuelle, il est aussi possible d’exporter la page sans l’historique, puis de supprimer la page, la restaurer à l’exception de la dernière révision, de réaliser le changement dans le fichier XML et de l’importer à nouveau.
Quand on clique sur le « + » en haut d'une page de discussion pour ajouter une nouvelle section, le résumé des modifications est automatiquement le titre de la nouvelle section.
Le journal des importations montre l’importation de la page, avec le nom d’utilisateur, la date, l’heure et le nombre de modifications. Le journal des suppressions montre la suppression et, le cas échéant, la restauration avec le nom d’utilisateur, la date et l’heure. La fonction « Voir et restaurer les pages supprimées » montre les versions supprimées. Il n’est pas possible de voir facilement (comme avec un diff) quels changements ont été faits. S’il y a plusieurs suppressions et importations ou restaurations, les versions qui existaient avant ne sont pas indiquées dans l’historique classique de la page, il n’est donc pas possible de savoir ce qui a changé durant la dernière opération de suppression ou d’importation.
Recherche
La fonction de recherche de Wikimedia ne parcourt pas les résumés de modifications, et ils ne sont pas non plus indexés par les moteurs de recherche externes.
Il existe un outil externe non officiel dans les labos Wikimedia : recherche dans les résumés de modifications. Par ailleurs, les mots-clics (sous la forme #mot) peuvent être recherchés sur https://hashtags.wmflabs.org.
Recommandations
Indiquez toujours un résumé de modification. Cela est considéré comme une ligne directrice importante. Même un court résumé vaut mieux qu’une absence de résumé. Ae résumé est d’autant plus important si vous ôtez du texte, car les autres risquent sinon de vous posez la question de ce retrait. Par ailleurs, mentionner un changement mais pas un autre peut méprendre quelqu’un d’autre qui trouve que l’autre changement était plus important : ajoutez « +divers » pour couvrir les autres changements.
Des résumés précis aident les personnes à décider si cela vaut la peine de vérifier le changement ou pas. Nous avons constaté que les résumés piquent souvent l’intérêt des contributeurs ayant une certaine expertise dans le domaine. Cela n’est pas autant nécessaire pour les modifications mineures mais « orthographe corrigée » est tout de même appréciable.
Dans le cas d’un petit ajout à un article, il est recommandé de copier directement cet ajout dans le résumé (ou deux lignes de l’ajout), ce qui donne un maximum d’information avec un minimum d’efforts. Ainsi, les lecteurs du résumé seront susceptibles de vérifier la page elle-même puisqu’ils connaissent déjà le contenu de la modification. Cela rendu aussi plus facile pour les lecteurs daltoniens ou malvoyants de voir la ponctuation et autres petits changements qui peuvent être difficiles à discerner (c’était notamment vrai avec le nouvel affichage des diff dans MediaWiki 1.20). Cela aide aussi les utilisateurs à contrôler les modifications récentes, historiques de page et contributions des utilisateurs (voir plus bas) très efficacement et réduit la charge des serveurs.
Pour les ajouts plus longs, il faudrait écrire un court résumé des changements que vous avez faits dans l’article. Pour un ajout, disons de 800 caractères, vous pouvez aussi gagner du temps en le copiant dans le champ de résumé.
Malheureusement, vous ne pouvez copier qu’une ligne de texte depuis le champ de modification de la page vers le champ de résumé. Le contenu des lignes suivantes peut être collé à la fin de la ligne. Ainsi, une liste à puce dans « Voir aussi » est fastidieuse à préciser dans le résumé des modifications. Une solution alternative pour une nouvelle liste est d’écrire la liste sur une seule ligne, séparée par des astérisques pour les puces, la copier dans le résumé des modification, puis ensuite dans le champ de modification de la page insérer les sauts de ligne avant les astérisques.
En plus du résumé du changement lui-même, le champ de résumé peut aussi contenir une explication du changement ; prenez garde que, si la raison d’une modification n’est pas claire, elle est plus susceptible d’être annulée, notamment si vous avez supprimé du texte. Pour donner une explication plus détaillée, utilisez la page de discussion et indiquez dans le résumé de modification « voir discussion » ou « voir pdd ».
Après avoir sauvegardé la page, le résumé ne peut plus être modifié ; une autre raison d’éviter les fautes d’orthographe.
En cas d’oubli ou d’erreur importante ans le résumé, il est toujours possible de faire une modification factice uniquement pour indiquer la correction dans le résumé de modification.
Abréviations
Certaines abréviations standard sont utilisées, même si vous restez libre de la façon d'écrire les résumés :
- + : ajout
- - : retrait
- ortho : correction d'orthographe
- corr. lien : correction d'un lien
- +en : ajout d'un lien interlangue vers la version anglophone.
- wiki : mise en forme en utilisant la syntaxe et les liens wiki
- rv, revert : annulation des modifications d'un utilisateur précédent.
etc.
Résumé des actions
Les actions de protection ou de renommage génèrent également des écritures dans l’historique de la page. Celles-ci sont également limitées à 1 000 octets et sont composées de la description de l’action et d’un commentaire fourni par l’utilisateur.
La description de l’action, par exemple « XX déplacée vers YY », est créée à partir des messages systèmes actuels dans la langue du site. Par conséquent, ils ne sont pas traduits lorsque la langue de l’interface utilisateur change.
Les commentaires des utilisateurs, si suffisamment longs, peuvent être tronqués par le système. La version plus longue, qui n’a pas à partager les 1 000 octets avec la description de l’action, peut être trouvée dans les journaux de déplacement ou de protection.
Références
Voir aussi
- Fonctionnalité pour modifier les résumés (2004)
- Sondage pour le pré-remplissage des résumés des modifications (2004)
- Usages des résumés des modifications sur Wikipédia : statistiques de 2005 à 2010
Liens externes
|
Consultation : Bouton consulter | Recherche | URL | Espace de noms | Nom de page | Section | Lien | Pages liées | Lien redirigé | Lien interwiki | Redirection | Catégorie | Page spéciale Suivre les modifications : Modifications récentes | (améliorées) | Suivi des liens | Liste de suivi | Historique | Différences | Contributions | Résumé des modifications | Modification mineure | Modifications surveillées Inscription et préférences : Enregistrement | Préférences | Personnalisation Édition : Édition | Syntaxe wiki | Démarrer une page | Images et fichiers | Page d'image | Caractères spéciaux | Formules | Tableaux | Listes | Frise chronologique | Boîte d'entrée | Modèle | Renommer une page | Raccourcis d'édition | Éditeurs externes | Page de discussion | Tester | Export | Import | |