Extension:ParserMigration/en
From Linux Web Expert
| 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 | |
| Database changes | No |
| License | No license specified |
| Download | |
| Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| 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
See Help:Extension:ParserMigration and the extension's README file.
Installation
- <translate> [[<tvar name=2>Special:ExtensionDistributor/ParserMigration/en</tvar>|Download]] and move the extracted <tvar name=name>
ParserMigration/en</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
<translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ParserMigration%2Fen - <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php</tvar> file:</translate>
wfLoadExtension( 'ParserMigration/en' );
- This extension also 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 new Parsoid wikitext parser to render article pages.
"Follow the wiki default" uses Parsoid based on two configuration options:$wgParserMigrationEnableParsoidDiscussionToolsif set to true will use Parsoid for all pages in the talk namespace, but not for other pages. This is intended for use with the DiscussionTools extension, which is already powered by Parsoid and enabled by default on some wikis.$wgParserMigrationEnableParsoidArticlePagesif set to true will use Parsoid for all pages in the main article namespace, but not for other pages.
- File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>
See also
For the 2018-era deployment of the ParserMigration tool, see:
