| 1 | = Foot-notes for Trac = |
| 2 | |
| 3 | == Description == |
| 4 | |
| 5 | The FootNoteMacro automatically collates[[FootNote(Arranges in numerical order)]] and generates foot-notes. |
| 6 | |
| 7 | To use it, simply call the FootNoteMacro with the foot-note content[[FootNote(Any WikiFormatting can be used as content)]] as the only argument to the macro: |
| 8 | |
| 9 | {{{ |
| 10 | [[FootNote(This is a foot-note)]] |
| 11 | }}} |
| 12 | |
| 13 | Foot-notes are numbered by the order in which they appear. |
| 14 | |
| 15 | To create a reference to an existing foot-note, pass the foot-note number as the only argument to the macro: |
| 16 | |
| 17 | {{{ |
| 18 | [[FootNote(1)]] |
| 19 | }}} |
| 20 | |
| 21 | In addition, identical foot-notes are coalesced into one entry. The following will generate one footnote entry with two references: |
| 22 | |
| 23 | {{{ |
| 24 | Some text[[FootNote(A foot-note)]] and some more text [[FootNote(A foot-note)]]. |
| 25 | |
| 26 | [[FootNote]] |
| 27 | }}} |
| 28 | |
| 29 | And finally, to display a list of foot-notes call the macro with no arguments: |
| 30 | |
| 31 | {{{ |
| 32 | [[FootNote]] |
| 33 | }}} |
| 34 | |
| 35 | Once a set of foot-notes has been displayed, a complete new set of foot-notes can be created. This allows multiple sets of foot-notes per page. |
| 36 | |
| 37 | == Bugs/Feature Requests == |
| 38 | |
| 39 | Existing bugs and feature requests for FootNoteMacro are |
| 40 | [report:9?COMPONENT=FootNoteMacro here]. |
| 41 | |
| 42 | If you have any issues, create a |
| 43 | [http://trac-hacks.swapoff.org/newticket?component=FootNoteMacro&owner=athomas new ticket]. |
| 44 | |
| 45 | == Download == |
| 46 | |
| 47 | [source:footnotemacro/0.8 FootNoteMacro for 0.8]. |
| 48 | |
| 49 | == Source == |
| 50 | |
| 51 | You can check out the source for FootNoteMacro from Subversion at http://trac-hacks.swapoff.org/svn/footnotemacro. |
| 52 | |
| 53 | == Example == |
| 54 | |
| 55 | Here are the footnotes assembled from this page. |
| 56 | |
| 57 | [[FootNote]] |
| 58 | |
| 59 | == Author/Contributors == |
| 60 | |
| 61 | '''Author:''' [wiki:athomas athomas] [[BR]] |
| 62 | '''Contributors:''' |
| 63 | |
| 64 | [[TagIt(macro,athomas,0.8)]] |