Aide:Extension:ParserMigration
 |
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. | |
L'extension ParserMigration permet aux utilisateurs de comparer la sortie de l'ancien analyseur de wikicode avec le dernier analyseur de wikicode Parsoid, ou de basculer entre l'ancien analyseur et Parsoid sur une page donnée. Pour signaler les problèmes avec la sortie Parsoid, lisez d'abord Parsoid/Unification de l'analyseur/Problèmes connus; cette page contient des instructions pour signaler un nouveau problème après que vous ayiez vérifié que celui-ci n'est pas déjà connu.
Activer via les préférences utilisateur
Cette extension ajoute Activer l’outil de migration de l’analyseur et Utiliser le nouvel analyseur syntaxique Parsoid : à la liste des options Outils de développement à la fin des préférences Modification d'un utilisateur.
Pour vous inscrire à la vérification des vues de lecture de Parsoid, sélectionner Toujours (opt-in) sous Utiliser le nouvel analyseur syntaxique Parsoid :.
Vous pouvez également vous assurer que Parsoid n'est jamais utilisé en sélectionnant Jamais (opt-out), ou (par défaut) suivre les paramètres par défaut du wiki pour l'utilisation de l'analyseur de wikicode de Parsoid en sélectionnant Selon la configuration du wiki (par défaut).
Adhérer aux vues de lecture Parsoid sur tous les wikis
Pour adhérer aux vues de lecture de Parsoid sur tous les wikis, vous devez sélectionner Toujours (opt-in) sous Utiliser le nouvel analyseur syntaxique Parsoid : dans votre Préférences globales.
Cliquer d'abord sur le bouton Configurer vos préférences globales de la page Informations personnelles de vos préférences utilisateur :
Préférences globales dans les préférences utilisateur de MediaWikiAprès être passé aux préférences globales, sélectionner Toujours (opt-in) sous Utiliser le nouvel analyseur syntaxique Parsoid :, en bas de l'onglet des préférences Modification :
Basculer entre Parsoid et l'ancien analyseur
Lorsque le nouvel analyseur de wikicode de Parsoid est utilisé sur une page, un lien Utiliser l'ancien analyseur est ajouté à la barre latérale des outils utilisateur.
Cela permet à l'utilisateur de comparer la sortie de l'ancien analyseur, ou à revenir temporairement sur celui-ci pour une page donnée.
Sélection de l'analyseur à l'aide d'une chaîne de requête dans l'URL
L'extension ParserMigration permet aussi d'utiliser useparsoid dans l'URL de la chaîne de requête pour forcer l'utilisation de l'ancien analyseur ou celui de Parsoid, redéfinissant ainsi les préférences utilisateur ou celles du wiki. Ce qui donne une URL de page semblable à :
https://www.mediawiki.org/wiki/Parsoid
L'URL suivante forcera l'utilisation de Parsoid :
https://www.mediawiki.org/wiki/Parsoid?useparsoid=1
Et cette URL forcera l'utilisation de l'ancien analyseur :
https://www.mediawiki.org/wiki/Parsoid?useparsoid=0
Rapporter un bogue visuel
Cette extension ajoute également un lien Rapporter un bogue visuel à la barre latérale, ce qui vous permet de signaler rapidement une différence de rendu.
Comparer le rendu de l'article
Quand Activer l’outil de migration de l’analyseur est activé, un lien Modifier avec l’outil de migration est ajouté au menu Outils de la barre latérale pour les pages d'articles.
En cliquant dessus sur une page d'article, vous verrez une variante de la page Edition d'aperçu qui vous permet de comparer la sortie de l'ancien analyseur avec la sortie de Parsoid.
API Action
Cette extension ajoute également action=parser-migration à l'API action de MediaWiki, qui analyse une page avec deux configurations différentes d'analyseurs et renvoie l'une ou les deux variantes dans la réponse de l'API.
