Jump to content

Parsoid/Parser Unification/Cite CSS

From mediawiki.org
Revision as of 16:02, 9 September 2022 by SSastry (WMF) (talk | contribs) (Initial draft)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Like all extensions, the Cite extension has localized messages. Wikis uses this mechanism to customize / localize the rendering of citations (often, via using localized numbering schemes).

Parsoid uses CSS to support localization of the Cite extension. One of the reasons for this approach is to make the editing experience consistent in editing clients like VisualEditor. When citations are modified (added / removed), the CSS approach lets the rendering to adjust consistently. Otherwise, VE (and other clients) will have to make a server request to rerender all citations each time one is added / removed which makes for a very poor UX.

So, as we are starting to migrate read views to be based on Parsoid HTML, wikis will have to add CSS rules to their MediaWiki:Common.css files to target citations.

List of impacted wikis

... TO POPULATE ...

Examples of CSS rules

... point to examples present in the visual diffing repo ...

How can we verify changes?

... changes should be visible when you edit a page in VE ..