Page MenuHomePhabricator

Parsoid: explicit numbering for footnote markers
Closed, ResolvedPublic

Description

This task is done when Parsoid emits the same explicit ("fallback") footnote markers as the legacy parser, including for custom groups.

Out of scope:

Parsoid renders footnote markers in two layers, one is a CSS counter reset which will be styled by the browser to show digits in the current content language. The other is a plaintext fallback, eg. "[1]". This plaintext should be rendered using page content digits in the same way as FootnoteMarkFormatter in the legacy parser.

Custom groups present a challenge and we'll decide in T370879: Investigation: How to best support custom footnote marker groups in VE, Parsoid, and read mode? how to go forward. The simplest migration is to wire through the legacy Cite logic at first, but it depends on l10n services which aren't available to Parsoid. It also leaves technical debt in the code and on-wiki, where users have to manually compile long alphabetical lists. (done)

Event Timeline

This is a won't fix, I believe, although I'm going to punt this to @ssastry for comment when he returns from sabbatical. We shouldn't really be emitting fallback text at all, and to the extent that we do it is desirable that it is consistent for machine-readability of citation markup. No humans should see that.

If there is some way that fallback text is being shown to human readers, then we should treat that as a bug and fix it.

There's still space for discussion, but I'd like to point out that the parser emits localized text, and in particular the legacy Cite parser emits footnote marker numbers as literal strings. These numbers can be customized by on-wiki overrides according to group name, for example see https://en.wikipedia.org/wiki/MediaWiki:Cite_link_label_group-lower-greek . What's the benefit of having Parsoid use CSS counter reset for every footnote? This is a mechanism that I'm planning to remove entirely, so it would be great to figure out a consistent way forward.

Also: I've created a parent task to reflect my team's further plans, let's please shift any discussion here instead: T370027

awight updated the task description. (Show Details)
awight renamed this task from Parsoid footnote marker fallback must be localized to Parsoid: explicit numbering for footnote markers.Oct 30 2024, 7:55 AM
awight updated the task description. (Show Details)
awight claimed this task.