Parsoid/Parser Unification/Known Issues
This page lists known issues and missing functionality that a typical reader or editor will notice when using the ParserMigration extension to use the Parsoid wikitext parser when viewing articles and talk pages. For a more technical overview of the differences between Parsoid-generated HTML and HTML generated by the legacy parser, see Known differences with Core Parser output.
How to verify and report an issue not listed below
[edit]Before reporting an issue,
- Click the "Use legacy parser" link in the user tools sidebar and verify that your issue is indeed Parsoid-related.
- Purge the cache to regenerate Parsoid HTML that may have been from an older version and check if the issue persists.
If you do not see your issue in the list below, please report it on Phabricator (see Phabricator/Help) or on this discussion page.
Known differences
[edit]The following issues are known differences between Parsoid and the legacy parser and are not expected to be fixed. To fix pages having this issue, see instructions for editors that has more detailed explanations with suggested page fixes or workarounds.
- If you use a non-default thumbnail size (selected in your user preferences), Parsoid will render some images at slightly different sizes. See Parsoid/Parser Unification/Known Issues/Thumbnail sizing for details (yet to be documented). The legacy parser is expected to use these same sizes within a few weeks.
- T381786 – Parsoid has slightly different start-of-line constraints for headings.
- Duplicate IDs on a page may cause issues – any where duplicate ids are found that affects CSS, the proper fix is for editors to remove the id duplication and update the CSS. There is no Parsoid fix for these.
- T368719, T355099 – Whitespace differences around template boundaries
- T374727 – In pages with unmatched single-quote markup, rendering differs from legacy
- T379645 – Interwiki links do not undergo title normalization in Parsoid
- T348722 – Phab page indicator template broken on some wikis
- T417705 – Difference in table row closing when switching from html to wikitext syntax cells (Parsoid's behavior is better and consistent)
- Template:Pre and Template:Markup render differently in some cases and may need adjustment in some transclusions
Known issues
[edit]The following issues are known and expected to be fixed in the weekly version of MediaWiki; check the release schedule and the current version running on your wiki for timing:
- The ListingEditor2023 gadget used on English Wikivoyage is not yet compatible with Parsoid. Use the
ListingEditor2023-Betagadget, available from your user preferences.
Metadata related
[edit]- T402456 - TOC edge cases
Error handling / display
[edit]- T372608 – Not all GeoData errors are displayed
- T398402 – Tracking task for edge case difference between Parsoid and legacy Cite implementation
- T386731 – Different DEFAULTSORT do not trigger an error on Parsoid
- T431137 – Wrong and missing cite warnings.
- T52369 – [edit] link disappears due to unclosed curly braces in a heading or section