A css footnotes option for html writer about pandoc HOT 3 CLOSED

Your suggested HTML is invalid: span elements are not allowed to contain block-level elements like paragraphs.

from pandoc.

That's interesting. Is supported by anything
other than the princexml formatter?

One reservation I have is this. Footnotes in pandoc can contain block
elements. (E.g. you could have a footnote with two paragraphs, a bullet
list, and a code block.) HTML elements are not supposed to
contain block-level elements like

. I don't think I want pandoc to
produce invalid HTML.

John

+++ lrayb [May 05 11 06:29 ]:

Hello John,

Perhaps you may consider adding a css footnotes option to the HTML writer?

The princexml formatter converts (X)HTML or XML to PDF using CSS paged media.
All footnote related processing is done via the formatter and CSS. All that is required in the
HTML, is an inline span with class "footnote" containing the actual footnote content, as below:

... figure with a caption.<span class="footnote"><p>This feature is not yet implemented for RTF, OpenDocument, or ODT. In those formats, you'll just get an image in a paragraph by itself, with no caption.</p></span> (In LaTeX ...

This implies that the HTML writer insert the footnote content, as a span in the document, where the footnote number should appear.
The reference links, backlinks, and list of footnotes at the document end, become superfluous.

It would be really neat if you could add an option to pandoc to accomplish this, perhaps:
pandoc --css-footnote

Currently, I run a script to change my HTML output prior to producing the PDF.
I think only princexml supports this, (other browers likely won't) so it's hardly a priority, but would
be greatly appreciated.

Thank you for all your structured procrastination on pandoc, it makes my life much easier.
Regards
Laurence R Buchanan

from pandoc.

Hello John,
I clearly did not think that one through.
Using a span would suffice only for the simplest examples, without producing invalid markup against a strict DTD.

The recommended method, as per Mike Day, in this post, footnotes containing paragraphs, is to use divs.

<div>some text <div class="footnote">
<p>text 1</p>
<p>text 2</p>
</div> some more text.</div>

That approach would imply bigger changes to the HTML writer than I envisaged.

AFAIK, princexml is the only formatter which implements footnotes as per the css3 generated content for paged media module working draft.

I've left the issue open, should you have further thoughts, but I agree, pandoc should not produce any invalid markup.
Thank you very much for taking a look.

Laurence.

from pandoc.