Pradyun Gedam

You're right. I'm not sure why, but looks like it came in ~4 hours after I sent it. :) https://sourceforge.net/p/docutils/bugs/450/#6bdd/ddc7

On Tue, Jun 7, 2022 at 7:21 PM "Günter Milde" milde@users.sourceforge.net wrote: can this go into 0.19 I am hesitant to introduce an incompatible API change unannounced and in the last minute . It has the potential to break custom style sheets. Could you elaborate on this? There was an incompatible API change in the 0.18 release -- why can't the same be done in 0.19?

@aa-turner -- the patch would be an improvement over status quo. See image for what can be achieved with the new markup, which is an improvement over 0.18 but not at parity with 0.17. In other words, for preserving the style in Furo, more is needed. As @milde pointed out, Furo uses a grid layout on dl, which means it is able to keep all the footnotes aligned even when there's different width among various labels+references. This would require moving away from each footnote living in its own aside...

Fun, SourceForge does not allow users to reply via email. We don't know whether the patch solves the OP's problem. The rendering in https://pradyunsg.me/furo/kitchen-sink/generic/#footnotes cannot be reproduced easily even with the patch, as every footnote has its own grid (as opposed to one grid for the list of footnotes in the example). That's correct. It does not. In my example, <div class="footnote-label"> functionally replaces the dt and the content div replaces the dd from 0.17. It changes...

The markup rendering for Sourceforge seems to have eaten an _. https://github.com/pradyunsg/furo/blob/d955850a89310a932ecab4e84cba0c20371a6a33/src/furo/assets/styles/content/_footnotes.sass#L12

https://pradyunsg.me/furo/kitchen-sink/generic/#footnotes has the 0.17 rendering. https://github.com/pradyunsg/furo/blob/d955850a89310a932ecab4e84cba0c20371a6a33/src/furo/assets/styles/content/footnotes.sass#L12 has the CSS, basically using the CSS Grid model to stylise the content to be aligned correctly (written in Sass for an indentation based syntax). FYI: https://docutils.sourceforge.io/test/functional/expected/standalone_rst_html5.html#footnotes seems to be unstylised, due to a broken link...

0.18: New HTML markup for footnotes is difficult to stylise

(1) the maintainers want to migrate. (2) what the concerns for doing a migration. (3) whether my helping hand would be welcome. Given the lack of responses here, I'm going to assume that the answers here are (1) no, (2) that the maintainers would have to learn something new and (3) no. Thanks for indulging me I guess? I say that but I'll note that I don't think I got a clear answer to most (if not all) of the direct questions I asked here. I'm gonna be fairly sad that such a foundational project...