Help:Extension:ParserMigration
The ParserMigration extension allows users to compare the output of the legacy wikitext parser with the latest Parsoid wikitext parser.
Enabling via user preference
This extension adds Enable parser migration tool and Use Parsoid by default to the list of Developer tools options at the bottom of the Editing preferences for a user. To opt-in to test Parsoid read views, ensure Use Parsoid by default is checked.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/7/77/ParserMigration_extension_user_preferences.png/400px-ParserMigration_extension_user_preferences.png)
Opting in to Parsoid read views on all wikis
To opt in to Parsoid read views on all wikis, you will need to select Use Parsoid by default in your global preferences. First, click the Set your global preferences button on the "User profile" page of your user preferences:
![](http://upload.wikimedia.org/wikipedia/commons/thumb/1/16/ParserMigration_Global_Preferences_menu.png/393px-ParserMigration_Global_Preferences_menu.png)
After you have switched to global preferences, select the Enable parser migration tool and Use Parsoid by default options at the bottom of your Editing preferences tab:
![](http://upload.wikimedia.org/wikipedia/commons/thumb/b/b8/ParserMigration_extension_global_preferences_menu.png/393px-ParserMigration_extension_global_preferences_menu.png)
Switching between Parsoid and the legacy parser
When Use Parsoid by default is selected, article and discussion pages will use the new Parsoid parser by default. To compare the output to the legacy parser, or to temporarily switch back to the legacy parser, a Use legacy parser link is added to the user tools sidebar.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/3/30/ParserMigration_toolbar_switch_link.png/393px-ParserMigration_toolbar_switch_link.png)
Comparing article rendering
When Use parser migration tool is enabled, an Edit with migration tool link is added to the Tools menu in the sidebar for article pages.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/b/b1/ParserMigration_extension_tools_menu.png/400px-ParserMigration_extension_tools_menu.png)
Clicking this on an article page will bring up a variant of the "preview edit" page which allows you to compare the legacy parser output against Parsoid output.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/3/3f/ParserMigration_extension_preview_page.png/400px-ParserMigration_extension_preview_page.png)
Action API
This extension also adds action=parser-migration
to the MediaWiki action API, which parses a page with two different parser configurations and returns one or both variants in the API response.
![](http://upload.wikimedia.org/wikipedia/commons/thumb/f/f1/ParserMigration_extension_action_API.png/400px-ParserMigration_extension_action_API.png)