Manually numbered footnotes

For manually numbered footnotes, each footnote is assigned a name.

Footnote reference

Description

The footnote reference consists of a footnote label in square brackets followed by an underscore at the end.

The footnote label is any integer number consisting of one or more digits.

Start and end characters

Start character = "[", end character = "]_"

(See also: Inline markup)

Footnote

Description

The footnote (footnote label) consists of an explicit markup start (".. "), the footnote label enclosed in square brackets, and a space followed by indented body elements (footnote content).

(See also: Explicit markup blocks)

Principle

+-----+-----------------------+
|".. "|"["label"]" footnote   |
+-----+                       |
      |(body elements)        |
      +-----------------------+

Properties

  • There may or may not be a blank line between the footnote label and the footnote content.
  • The footnote content must be indented (at least one space).
  • Footnotes can be positioned anywhere in the comment, not just at the end.

Sample:

Footnote references, like [1]_.

.. [1] Body elements go here.

or

Footnote references, like [1]_

.. [1]
 Body elements go here.

Manually numbered footnotes 1:

or

Footnote references, like [1]_.

.. [1]
 - Body elements go here.
 - Second body element.

Manually numbered footnotes 2:

Sample

Clicking the footnote reference [5]_ displays the footnote contents.
(In sample project: B_DocuElements\Hyperlinks\Footnotes\FB_Libdoc_ManuallyNumberedFootnotes)

(*
**Numerical footnote**

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 ``]``.
*)

Manually numbered footnotes 3: