Re: footnotes

On Mon, Dec 15, 2014 at 9:46 AM, Virgil Arrington <[email protected]> wrote:
> In the Docutils Quick Reference Guide, I find the following with respect to
> footnotes.
>
>
> Footnote references, like [5]_.
> Note that footnotes may get
> rearranged, e.g., to the bottom of
> the "page".
>
> .. [5] A numerical footnote. Note
>    there's no colon after the ``]``.
>
>
> Does anyone know what determines where footnotes appear in the resulting
> HTML file? I'm finding that, if I insert a footnote as shown in the example,
> the footnote will appear in the resulting document right below the paragraph
> containing the footnote reference. I prefer footnotes at the end of the HTML
> document. To obtain this, I put the actual footnote text at the end of the
> source code document. But, on a long document with more than a few
> footnotes, I can lose track of my footnotes. If I want to move footnotes
> around, finding the footnote text that links with the footnote reference can
> be a challenge.
>
> With MarkDown Extra, footnotes always appear at the end of the document even
> if I put them right after the reference paragraph in the source document.
>
> So, what determines whether a footnote gets "rearranged, e.g., to the bottom
> of the 'page'"?

There is currently no functionality to do automatic rearranging in the
HTML writer (there may be in other writers). I intended to write a
"footnotes" directive that would "move all footnotes in the document
to this point", but never got around to it. It wouldn't be that
difficult to write; contributions are welcome.

If you have a lot of footnotes, I offer this workaround. Keep your
footnotes in a separate file, say "footnotes.txt". At the point in
your document where you want the footnotes to appear, use ".. include:
footnotes.txt". That's the best I can think of, right now.

-- 
David Goodger <http://python.net/~goodger>


> For my browser, I'm using Mozilla Firefox on Ubuntu Linux.
>
> Virgil

------------------------------------------------------------------------------
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=164703151&iu=/4140/ostg.clktrk