GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing www.mediawiki.org — Extension:ParserMigration - MediaWiki

**MediaWiki extensions manual**
ParserMigration Release status: stable
Implementation	User interface
Description	Provides an interface for migrating article text to new versions of the MediaWiki parser
Author(s)	Tim Starling, C. Scott Ananian, Content Transform Team
Latest version	Continuous updates
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	>= 1.46
Database changes	No
Parameters $wgParserMigrationCompactIndicator $wgParserMigrationUserNoticeVersion $wgParserMigrationEnableParsoidMobileTalkPages $wgParserMigrationFeedbackTitleURL $wgParserMigrationFeedbackAPIURL $wgParserMigrationEnableParsoidPercentage $wgParserMigrationEnableQueryString $wgParserMigrationEnableUserNotice $wgParserMigrationEnableParsoidMobileArticlePages $wgParserMigrationUserNoticeDays $wgParserMigrationEnableParsoid $wgParserMigrationEnableIndicator $wgParserMigrationExcludePageProps $wgParserMigrationEnableQuickSurvey $wgParserMigrationEnableReportVisualBugOnlyLoggedIn $wgParserMigrationFeedbackTitle $wgParserMigrationEnableReportVisualBug $wgParserMigrationEnableParsoidArticlePages $wgParserMigrationEnableParsoidTalkPages
Hooks used ArticleParserOptions ChangeTagsAllowedAdd ChangeTagsListActive ConfirmEditTriggersCaptcha GetPreferences ListDefinedTags ParserOutputPostCacheTransform QuickSurveysEnabled ResourceLoaderGetConfigVars SidebarBeforeOutput
Licence	Creative Commons Zero v1.0 Universal
Download	Download extension Git ^[?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball
Help	Help:Extension:ParserMigration
Translate the ParserMigration extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The ParserMigration extension provides an interface for comparing article rendering with a new non-default version of the MediaWiki parser , thus serving as a parser migration tool.

It was deployed on the Wikimedia production cluster until 2018 to compare Tidy-based output with a RemexHTML-based output. RemexHTML was the replacement for Tidy. In 2023 it was redeployed in order to compare legacy wikitext parser output with output generated by the Parsoid wikitext parser.

The availability of the tool can be controlled by a user via the "parsermigration" preference option.

Using the extension

See Help:Extension:ParserMigration and the extension's README file.

Installation

Download and move the extracted ParserMigration folder to your extensions/ directory.
Developers and code contributors should install the extension from Git instead, using:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ParserMigration
```
Add the following code at the bottom of your LocalSettings.php file:
```
wfLoadExtension( 'ParserMigration' );
```
Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

This extension adds a dropdown under "Developer tools" at the bottom of the "Editing" options for a user, which allows the user to opt-in, opt-out, or follow the wiki defaults for the use of the Parsoid wikitext parser to render article pages.

If the user chooses to follow the wiki default, the use of Parsoid will be based on two configuration options:

$wgParserMigrationEnableParsoidDiscussionTools if set to true, will use Parsoid for all pages in the talk namespace. This is intended for use with the DiscussionTools extension, which is already powered by Parsoid and enabled by default on some wikis.
$wgParserMigrationEnableParsoidArticlePages if set to true, will use Parsoid for all pages in the main article namespace.

GeezerVison

Using the extension

Installation

Configuration

See also