Footnotes

Footnotes module can be used to easily create automatically numbered footnote references into an article or post (such as a reference to a URL). This is the first 2.x release of the Drupal Footnotes module, with several enhancements compared to 1.x. Introducing the new square bracket syntax makes Footnotes usable also in WYSIWYG editors like TinyMCE and FCKEditor.

This release also includes "Better URL filter", which can be used to replace the (incomplete) URL filter available in Drupal core. Especially Footnotes users have suffered from the current URL filter, so the inclusion of a fixed URL filter in Footnotes provides for much awaited relief to Footnotes users. Even so, it is also possible to use Better URL filter independent of the Footnotes filter.

Changelog highlights:

• Add support for using [fn]square brackets[/fn] (http://drupal.org/node/268026)
• Add support for specifying "value" attribute. (emfabric http://drupal.org/node/282104)
• Adding Better URL filter (fork from core). http://drupal.org/node/161217
• There appears to also be a French translation now. Thanks Beginner! (Japanese already done earlier.)
• Start using the Drupal theme system, footnotes can now be themed by site admins (emfabric http://drupal.org/node/221156)

ABOUT FOOTNOTES (README.txt)

The Footnotes module can be used to create automatically numbered footnotes within a text. In the place, where you want to add a footnote, enclose the footnote text within an fn tag:

[fn]like this[/fn].

NOTE: This version of Footnotes includes "Better URL filter". See below for details.

The filter will take the text within the tag and move it to a footnote at the bottom of the page. In its place it will place a number which is also a link to the footnote. As of version 2.0 Footnotes supports both [fn]square brackets[/fn] and <fn>angle brackets</fn>. Square brackets support
was added in particular to support WYSIWYG editors like FCKEditor and TinyMCE.

Also supported in 2.0 is the use of a "value" attribute to a) set the numbering to use as a label or b) to set an arbitrary text string as label. Ex:

[fn value="5"]This becomes footnote #5. Subsequent are #6, #7...[/fn]
[fn value="*"]This footnote is assigned the label "*"[/fn]

BETTER URL FILTER

This version of Footnotes includes also a "Better URL filter". This is a fork of the URL filter in Drupal core filter.module. The original URL filter is buggy (or more accurately, very limited). If the enhancements in Better URL filter are ever committed to Drupal core, this filter will (obviously) be deprecated. (You can follow the bug in Drupal core URL filter here: http://drupal.org/node/161217)

In particular Footnotes users have suffered from the Drupal URL filter not converting URLs inside footnotes to links, however, the Better URL filter can be used by anyone wishing more correct URL filter functionality, even if you don't use footnotes. (You don't even need to enable the Footnotes filters to use the Better URL filter.)

TEXTILE STYLE FOOTNOTES

There is also another filter which does the same with a Textile markup style. Use it together with the Textile module.

By default, footnotes are placed at the end of the text. You can also use a [footnotes] or [footnotes /] tag to position it anywhere you want. For Textile use "footnotes." tag.

Note: The Textile style filter is no longer actively developed and may become deprecated. It is better to use the <fn>...</fn> or [fn]...[/fn] style footnotes with any markup you are using.

INSTALL INSTRUCTIONS FOR FOOTNOTES.MODULE

1. Copy the contents of this module to modules/footnotes folder.
2. Login as site administrator.
3. Activate footnotes on the Administer > Site building > Modules page.
4. To use the footnotes filter in some input formats, go to Administer > Site configuration > Input formats.
5. For selected input formats, select configure and activate a suitable footnotes filter.

Note: Typically you want the footnotes filter to be pretty early in the chain. For instance the Footnotes Textile style filter outputs Textile markup, so it should definitively be before your Textile filter. If you need to lift the Footnotes filter higher up, click "rearrange".

Also see section about HTML filter below.

HTML FILTER

Footnotes.module is designed such that it can be used together with Drupal's HTML filter, and in particular you should have footnotes first and html filter later.

This version of Footnotes has been redesigned so that it only outputs HTML tags that are allowed in a default installation of HTML filter. (Tags used are A, OL and LI.)

KNOWN ISSUES

This version uses a new markup for the list of footnotes. It is an OL list with CSS taking away the browser generated list numbers and moving the link numbers towards the left. All IE versions have a bug that the numbers are slightly lower than the baseline of the footnote text. (If you know how to fix this, please tell.)

In addition IE 5.5 has a more serious bug that the footnote number will be on top of the first letters of the footnote text. There doesn't seem to be a way to fix this.

The development version for Drupal 7 has a bug in that CSS and JavaScript files added by modules are absent from the page. If you are hit by this bug, your footnote references will not appear as supertext, and the list of footnotes will have duplicate numbering. There is a workaround to empty Drupal's cache table in Administer > Site Configuration > Performance > Clear cached data
after which everything works again. To follow up on this bug: http://drupal.org/node/279420

COPYRIGHT AND ACKNOWLEDGMENTS

The Footnotes module is copyrighted by Henrik Ingo and other contributors. It is licensed by the same conditions as Drupal itself. (GPL license)

Footnotes was originally created by henrik.ingo@avoinelama.fi ("hingo" on drupal.org) in the summer of 2006.

The HTML footnotes were seriously enhanced by "beginner" (on drupal.org) and later on by other users comments and code snippets.

Footnotes was originally developed for http://openlife.cc/onlinebook

Beginner was the second to use it on his site at http://www.reuniting.info/wisdom/sources/metaphysical/a_course_in_miracl...

I wish to thank all contributors for letting me experience the miracle of maintaining an Open Source module living its own life!

Releases

Official releases	Date	Size	Links	Status
6.x-2.1	2008-Sep-07	18.02 KB	Download · Release notes	Recommended for 6.x
6.x-1.1	2007-Dec-25	12.47 KB	Download · Release notes	Supported for 6.x
5.x-2.1	2008-Sep-07	18.03 KB	Download · Release notes	Recommended for 5.x
5.x-1.3	2007-Dec-25	12.75 KB	Download · Release notes	Supported for 5.x
4.7.x-1.0	2007-Feb-08	9.65 KB	Download · Release notes	Recommended for 4.7.x

Development snapshots	Date	Size	Links	Status
6.x-2.x-dev	2008-Jul-31	18 KB	Download · Release notes	Development snapshot