FootnotesExtended

Summary: A footnote recipe with extended referencing possibilities
Version: 2023-11-04
Prerequisites:
Status: stable, maintained
Maintainer: ThomasP
Categories: Markup

Motivation

This recipe extends the functionality of the Footnotes recipe. It is here possible to have the footnote text separated from the reference, which allows larger footnote texts and easy multiple referencing of the same footnote text.

Usage

Copy footnotes_extended.phpΔ to your cookbook directory and have the usual

  include_once("cookbook/footnotes_extended.php");

in your local config.php. The following markup will be enabled:

  • [^#anchorname^]
    Place a reference to the footnote named with the given anchor name. (Can be placed multiple times.)
  • [^#anchorname My footnote text.^]
    Definition of the footnote text belonging to the given anchor name. (Usually succeeding the reference(s).) If however this markup precedes any references with the specified anchor, it is understood as a reference with an inline definition of the footnote text.
  • [^My footnote text belonging to an unnamed footnote.^]
    Present footnote markup style works as before.
  • [^#^]
    Print a list of all footnote texts.

Example

In my small[^This is relative of course.^] text, I explain how to use the new markups[^#xxx^]
coming with this recipe[^#xxx^].

[^#xxx These objects are the most emphasized words in this sentence.^]

[^#^]

This will produce something like:

In my small1 text, I explain how to use the new markups2 coming with this recipe2.

1 This is relative of course.
2 These objects are the most emphasized words in this sentence.

Release Notes

  • 1.0 (2007-09-23): initial release
  • 1.1 (2007-09-24): escaped double quotes issue corrected
  • 1.2 (2023-11-04): Adjusted Markup for PHP8

See Also

Contributors

Comments

See discussion at FootnotesExtended-Talk

User notes +1: If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.