Extension:ParserMigration

From mediawiki.org
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)
Latest version Continuous updates
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.42
Database changes No
License Creative Commons Zero v1.0 Universal
Download
Help Help:Extension:ParserMigration
  • $wgParserMigrationEnableParsoidArticlePages
  • $wgParserMigrationEnableQueryString
  • $wgParserMigrationUserNoticeVersion
  • $wgParserMigrationEnableParsoidDiscussionTools
  • $wgParserMigrationUserNoticeDays
Quarterly downloads 9 (Ranked 141st)
Translate the ParserMigration extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The ParserMigration extension was introduced in gerrit:296182. It 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[edit]

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


Installation[edit]

  • 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' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

See also[edit]

For the 2018-era deployment of the ParserMigration tool, see: