View source for Wikipedia:Footnote3

{{historical}}
{{Notice|'''This is no longer the recommended method of citing sources (but is still fully operational).'''<br>An explanation on how to create 'numbered footnotes' is at [[Help:Footnotes]]. To use 'linked [[wikipedia:harvard referencing|Harvard references]]', use {{tl|harv}} + {{tl|note label}}, as explained below.}}

----
{{shortcut|WP:FN3}}This page explains a previously used [[footnote]] system, which is totally superseded by the newer [[Wikipedia:Footnotes|footnoting system]]. Currently, the {{tl|ref}} and {{tl|note}} templates should only be used in specific circumstances, not for general purpose referencing.{{ref|autonumber}}

The pairs of templates discussed in this guideline are:{{ref|LabelVariant}}
{| class="wikitable"
! Link in text area !! Link in References area
|-
| width="50%" |'''<nowiki>{{</nowiki>[[template:ref|ref]]<nowiki>|</nowiki>'''<nowiki><name></nowiki>'''<nowiki>}}</nowiki>'''
| width="50%" | '''<nowiki>#{{</nowiki>[[template:note|note]]<nowiki>|</nowiki>'''<nowiki><name></nowiki>'''<nowiki>}}</nowiki>'''  - followed by comment or citation
|-
| width="50%" | '''<nowiki>{{</nowiki>[[template:ref label|ref label]]<nowiki>|</nowiki>'''<nowiki><name>|<footnote number>|<backlink label></nowiki>'''<nowiki>}}</nowiki>'''
| width="50%" | '''<nowiki>{{</nowiki>[[template:note label|note label]]<nowiki>|</nowiki>'''<nowiki><name>|<footnote number>|<backlink label></nowiki>'''<nowiki>}}</nowiki>''' (follows on the same line as an existing <nowiki>{{note}}</nowiki>, before the formal citation info)
|}

'''Not all references are made using footnotes''' : Please see [[Wikipedia:Citing sources]] for guidance on references and alternative markup.

Also, '''not all footnotes are citations of information sources.'''  They are also used for clarification or other notes about material.  Common uses include explaining the meaning of a table header, or an exception regarding a specific entry in a table, etc.

==Footnote overview==
A footnote is a note placed at the bottom of a page of a document that comments on, and may cite a reference for, a part of the main text.  The connection between the relevant text and its footnote is often indicated with a number or symbol which is used both after the text fragment and before the footnote.

Footnotes are sometimes useful for relevant text that would distract from the main point if embedded in the main text, yet are helpful in explaining a point in greater detail.  Footnotes are also often used to [[citation|cite]] [[reference]]s which are relevant to a text.  Citation of sources is important in supporting [[Wikipedia:Verifiability|Verifiability]], a key aspect of Wikipedia.

===Footnote usage===
The '''{{tl|ref}}''' templates generate automatically-numbered links in text to connect to footnotes in the section, most commonly named Notes or References, and footnotes contain matching '''{{tl|note}}''' templates which generate backlinks back to the referring text.

:* To avoid an editor having to renumber footnotes due to insertion or deletion, this method uses automatically-generated numbers as much as possible ('''ref''' templates, plus a "numbered list" of footnotes to give automatic numbering of footnotes).
:* The connection between text and footnote uses appropriately-created ''name'' attributes per the template table above, so it is possible to identify the intended footnote even if numbering becomes incorrect.
:** The footnote connection is intended to be robust so content can be converted for use with future versions of supporting software.
:* To reduce disruption in the flow of text, footnote references are displayed as small, superscripted numbers.

This method has the following disadvantages:
:* When using the '''ref''' template there can only be one sequence of footnotes from the text -- although using the {{tl|ref label}} template can circumvent that sequence. This is an example.{{ref label|NumberedRef|5|none}} Most articles have little reason to do that, but it can be useful, for example, in indicating that multiple pieces of data in a table come from the same source.
:* Every footnote number in the text refers to a separate note at the bottom: if you want to reuse a number so that it refers to the same footnote at the bottom, the '''ref label'''/{{tl|note label}} variant must be used and manually numbered.{{ref label|LabelVariant|2|a}}
:* WARNING:  It is not possible to test footnotes while previewing.  Clicking on a footnote ejects the user, perhaps to the previous version of the article (use the back arrow to return).  One '''can''' test the back link, which should really confirm the forward link as well.

==How to use==
:''See also [[help:footnotes]] for a concise manual and examples''
The basic use of the '''ref''' and '''note''' templates is just choosing a one word descriptive '''<name>''' for your reference and:
:* put '''<syntaxhighlight lang="wikitext" inline>{{ref|<name>}}</syntaxhighlight>''' where you want the footnote number to be
:* put a ''numbered list'' at the bottom of your document '''<syntaxhighlight lang="wikitext" inline># {{note|<name>}}</syntaxhighlight>''', for automatic numbering of your footnotes.

Use a separate '''note''' template for each '''ref'''erence template.

There are three examples below:  The first is for this basic use of the '''ref''' and '''note''' templates.  The second example explains how to build identical references, referring to the same footnote, using the '''ref label''' and '''note label''' templates for additional references to a '''ref'''/'''note''' footnote.  The third example is a combination of the two, but with the multiple references made only ''within'' the footnotes section for easier maintenance by editors and easier navigation by the reader.

===Example===
<!-- if I just use indentation in this then the templates get interpreted :-( -->
<syntaxhighlight lang="wikitext">
According to scientists, the Sun is pretty big.{{ref|miller-23}}
The Moon, however, is not so big.{{ref|moonsize}}

==Notes==

# {{note|miller-23}} Miller, E: "The Sun.", page 23. Academic Press, 2005
# {{note|moonsize}} Smith, R: "Size of the Moon", ''Scientific American'', 46(78):46
</syntaxhighlight>
The <syntaxhighlight lang="wikitext" inline>{{note}}</syntaxhighlight>'s in the Notes section must occur in the same order as the corresponding <syntaxhighlight lang="wikitext" inline>{{ref}}</syntaxhighlight>'s in the main text. This is an important issue to consider when adding more footnotes later.

The <syntaxhighlight lang="wikitext" inline>{{ref label|<name>|<fixed number>}}</syntaxhighlight> template (where the numbers of the text references are '''fixed''' and not automatically assigned) can be used instead of the <syntaxhighlight lang="wikitext" inline>{{ref|<name>}}</syntaxhighlight> template, but this should only be used when necessary due to the lack of automatic numbering.

It is encouraged that other, non-numbered references use citation templates such as shown in ''[[Wikipedia:Template messages/Sources of articles/Generic citations]]''.

===Example with multiple ''references to'' the same footnote===
For the same footnote to be used several times, the additional template pairs now also include the ''footnote number'', and a ''backlink label'' with which to identify the backlink (usually a letter "a" through "z").
<syntaxhighlight lang="wikitext">
This is an example of a whole document in wiki format.{{ref|myref-25}}
Another reference to the same source can be made.{{ref label|myref-25|1|a}}
In this case, "1" is the number in the References section and "a" is the backlink label.

==References==

# {{note|myref-25}}{{note label|myref-25|1|a}} and this is a note about the text from page 25
of a book.  If known, give full reference including title, author, and ISBN.
</syntaxhighlight>
Footnote [2] in this article is referred to multiple times in the text, as well as in latter sections of the article, following this example.{{ref label|LabelVariant|2|b}}

===Example with multiple ''uses of'' the same footnote===
Another way to get to and use the same footnote is by travelling within the Footnotes section itself.  Get ''to'' the footnotes section using the auto-numbered "ref/note" template pair, the basic template.  Then use the "ref label/note label" template pair, exactly as in the preceding ''Example with multiple references..'', but now entirely within the Footnotes section.  Say something like "See above footnote 2c" to help the reader navigate.  Future maintenance of ''footnote numbers'' and ''backlink labels'' is easier, within just the Footnote section, than trying to locate footnote references buried in a long text such as this article is.  This alternative may cost the reader two extra clicks, a tradeoff against easier navigation.  This approach is shown in this footnote.{{ref|shootFoot}}

Finally, the original footnote could be multiply repeated in the Footnotes section, each time with a new number -- in this article footnote [2] would appear five times, with five different numbers.  This alternative is acceptable if done judiciously -- but ''not'' in this article.

:* WARNING:  It is not possible to test footnotes while previewing.  Clicking on a footnote ejects the user, perhaps to the previous version of the article (use the back arrow to return).  One '''can''' test the back link, which should really confirm the forward link as well.  This repeated warning may save you some time.

==Style recommendations==
* Internal links should still be used as normal, like this: [[Wikipedia]].
* Consider using a separate bibliography section if the same book reference is used in multiple footnotes.  In this case, just the page number and book name can be given in each note, following [[Wikipedia:Citing sources]].
* Where possible choose a name for each link which matches the author/page system used by academics - use a single word and a hyphen to connect the page number (hunter-47)
* If you don't know the page number, just use a single word (field)
* With multiple books by the same author, make a difference, e.g. hunterA and hunterB, as in hunterA-22, hunterA-46 & hunterB-35 for page 22 and 46 of hunter's first book and page 35 of her second book.

==Helping editors unfamiliar with footnote templates==
As the recommended footnote structure does not appear to be entirely intuitive to all editors, and as notes being placed in the wrong order can affect the order of all following notes, making notes appear as if they do not match up, this short HowTo description can be inserted at the top of the Footnotes section, marked off to hide it from the actual article:

<syntaxhighlight lang="moin">
<!-- <nowiki><nowiki></nowiki>

IMPORTANT:
 Footnotes using {{ref}}/{{note}} templates (and their variants) are becoming obsolete:
 A more up-to-date system uses MediaWiki software <ref>...</ref> and <references/> tags,
 as explained in [[Wikipedia:Footnotes]].

IF CONTINUING TO USE {{ref}}/{{note}} FOOTNOTES ON THIS PAGE:
 Footnotes in this article use names, not numbers. Please see [[Wikipedia:Footnote3]] for details.
 How to add a *SEMI-AUTOMATICALLY NUMBERED* footnote:
 1) Assign your footnote a unique name, for example TheSun_Dec9.
 2) Add the macro {{ref|TheSun_Dec9}} to the body of the article, where you want the new footnote.
 3) Take note of the name of the footnote that immediately precedes yours in the article body.
 4) Add #{{Note|TheSun_Dec9}} to the list, immediately below the footnote you noted in step 3.  No need to re-number anything!
 5) Multiple footnotes to the same reference: see [[Wikipedia:Footnote3]] for a how-to.
 NOTE: It is important to add footnotes in the right order in the list!

HARVARD REFERENCES
 See:
 * [[Wikipedia:Harvard referencing]]
 * {{ref_harvard}}/{{ref_harv}} + {{note_label}} templates can be used as explained in [[Wikipedia:Footnote3]]

<nowiki></nowiki></nowiki> -->
</syntaxhighlight>

Instead of copy-pasting this text, it is possible to insert the following: <nowiki>{{subst:</nowiki>[[template:Footnotestext|Footnotestext]]<nowiki>}}</nowiki> (don't forget the "subst:" as only then is the template tag replaced by the commentary!).

==Other (obsolete) template names==
Originally this proposal used the <nowiki>{{an|<name>}}</nowiki> template and <nowiki>{{anb|<name>}}</nowiki>; these were made obsolete and have been deleted.  The [[Template:endnote|<nowiki>{{endnote|<name>}}</nowiki> template]] was used in another earlier proposal which was converted to use the same system as is listed here. Substituting <nowiki>{{endnote|</nowiki> with <nowiki>{{note|</nowiki> should update pages still using this system.

==Design goals==
The design goals behind this system were

* get something working with the current Wikimedia software.
* make a very short easy to use template
* get rid of [http://en.wikipedia.org/w/index.php?title=J%F6rg_Friedrich&diff=10262311&oldid=10260170 complex renumbering edits]
* avoid disturbing the flow of text too much
* maintain nice features of fn/fnb template (back link from footnote to text, & simplicity, for example)
* remain reasonably accessible{{ref|fn_on_web}}
* provide semantic markup to help future enhancements by labeling information about source materials.

==Migration strategy==
There is a [[Wikipedia:Footnote3/numlink2note.pl|perl script numlink2note.pl]] available which automatically converts  numbered URL links in a page into footnotes with this system.  The references should still be hand checked, but at least part of the work is done.

Migration from old footnote systems should be reasonably easy to automate.  As an intermediate measure, the embedded footnote numbers can be used as temporary footnote names until better ones are generated manually.

The [[Template:fn|<nowiki>{{fn|<name>}}</nowiki> template]] and [[Template:fnb|<nowiki>{{fnb|<name>}}</nowiki> template]] can be simply changed to match an and note templates.  The following substitution (untested perl code).
<syntaxhighlight lang="perl">
 m/\{\{fnb/ && /s/^\*/\#/ ;
</syntaxhighlight>
will provide automatic numbering of footnote comments.

The following code will warn about pages which use links without text.
<syntaxhighlight lang="perl">
 m,\[[a-z]://\W*\],i && warn "unprotected url in text";
</syntaxhighlight>

==How does it work?==
''This section describes the technical implementation based upon characteristics of the current software.''

The {{tlp|ref|<name>}} uses tricks listed in  [[m:Help:Variable]] to create an external wiki link back to a section in the same page (like <nowiki>[http://en.wikipedia.org/wiki/This_Page.html#footnote]</nowiki>).  This external link is then automatically numbered by the normal numbering system for external links without link text.  The link is surrounded in a ''sup'' tag which makes it look like a footnote and gives a reference that the footnote can link back to.

 {{tlp|ref|Jefferson}}

becomes
<syntaxhighlight lang="html">
<span class="reference"><sup id="ref_Jefferson" class="plainlinksneverexpand">
[{{SERVER}}{{localurl:Page_name.html}}#endnote_Jefferson]</sup></span>
</syntaxhighlight>

The {{tlp|note|<name>}} is a bit simpler, and is basically a copy of the older {{tlp|fnb|<name>}}.  This just creates a section link back to the location of the footnote.

 # {{tlp|note|Jefferson}}

becomes

<syntaxhighlight lang="html"># <cite id="endnote_Jefferson" style="font-style: normal;">[[#ref_Jefferson|'''^''']]</cite>&nbsp;</syntaxhighlight>

Normal link and list numbering then produces automatic numbering of the footnotes.

==Converting citation styles==
Converting citation styles should not be done without first gaining consensus for the change on the article's talk page.

<!-- Sorry, if what follows sounds harsh, but I found no way of formulating it softer without making the links to the ArbCom case, and the SEWilco bot user page: the ArbCom decision did not leave any margin that SEWilco could use his bot or convert citation styles "after consensus", no, he was forbidden throughout, quote from the RFAr "Remedies" section: "SEWilco should not use a bot to convert citations on articles, nor should he manually convert citation styles on any articles." (Passed 7-0) / this note inserted by ~~~~ -->
A [[Wikipedia:Requests for arbitration/Climate change dispute 2#SEWilco's conversion of citations|December 2005 ArbCom case]] ruled that following scripts could no longer be used by a [[User:SEWilcoBot|certain wikipedian]]:
* [[Wikipedia:Footnote3/numlink2note.pl]], explained at [[Wikipedia talk:Footnote3/numlink2note.pl]]
* [[Wikipedia:Footnote3/order-footnote.pl]], explained at [[Wikipedia talk:Footnote3/order-footnote.pl]]

Similarly, individual users may be forbidden to "manually convert citation styles on any articles."

So, ''tread lightly'', and ''seek consensus first'', before converting citation styles.

==Disadvantages and future improvements==

* '''Editors must make sure to keep the numbered list at the bottom of the page in the same order as the references in the article text, or else the numbers may not match up.'''  (Though this is better than relying on manual numbering at both ends.)
* We would like to see [[Mediawiki]] software support for automatically generating and/or numbering footnotes. Reportedly, Magnus Manske added code for this to [[Nupedia]].
* Because of the way links are numbered, some editors argue that inline external links cannot be used in combination with auto-numbered footnotes, but must be converted into footnotes too. Other editors argue that both citation styles can be used in the same article.
* Superscripts cause an increase in line spacing for the line they are on.  Because lines without superscripts are still displayed at the original line spacing, this makes the text unevenly spaced, and this looks bad. This is a general problem with superscripts.  It may require CSS changes or even improvements in web browsers or OS font rendering systems.  (This should be filed as a bug in Bugzilla if it hasn't already.) <!-- Another possibility is using images which contain numbers. -->
* Some people like the idea of having ''sidenotes'' instead of or in addition to ''footnotes'', especially if this is an option one can turn on and off in Mediawiki preferences.  (You can turn a table into a sidenote with style="float: right;".)
* Some people like the idea of "hover" or "tooltip" notes, that appear only when "hovering" over the superscript with the mouse point.  (See e.g. [[Template:Hnote]].)
* [http://bugzilla.wikimedia.org/show_bug.cgi?id=2745 Bug 2745: Have References text edit window on Edit pages]

==Footnotes==
# {{Note|autonumber}} There have been several other footnote proposals.  See also [[Wikipedia:Citing sources]], and [[Wikipedia:Footnote2]]
# {{note|LabelVariant}}{{note_label|LabelVariant|2|a}} {{note label|LabelVariant|2|b}} {{note label|LabelVariant|2|c}} {{note label|LabelVariant|2|d}}  The first two pairs of templates are '''used''' in this article.  The reader can click on the tab "edit this page", to see the actual coding (or markup) for both pairs.  You will see that the first pair is always used but for succeeding references to this same footnote, with this system, the second pair must be used - references after the first one have to use {{tl|ref_label}} and {{tl|note_label}} templates.  Each footnote shows as many backlinks (^, a,b,...) as there are references to it.
#{{note|shootFoot}} (The reader's eyes can do the travel within this footnotes section, but the travel coding is needed to document this travel for purposes of future maintenance.)  See above footnote 2c.{{ref label|LabelVariant|2|c}}
# {{Note|fn_on_web}} If footnotes are too small, then they are difficult for some people to use.  See [http://www.cs.tut.fi/~jkorpela/www/fn.html Footnotes (or endnotes) on Web pages],  Jukka "Yucca" Korpela, 2003-08-22, retrieved 2005-02-19 from http://www.cs.tut.fi/~jkorpela/www/fn.html
# {{Note label|NumberedRef||none}} Example of non-continuous numbering of text references, with the {{tl|ref_label}} template.  Note that one can choose only the number immediately after the footnote numbers automatically generated in the text.  And you must (re)arrange the numbered list of footnotes accordingly, to end up with the expected matching numbers in text and footnote section.

==See also==
*[[Wikipedia:Citing sources/example style]], listing also several examples of ''non-numbered'' APA style and Harvard referencing techniques
*[[Wikipedia:Template messages/Sources of articles]] for complete list of templates that are available for citations
*[[Wikipedia:WikiProject Wikicite]]: Proposal for use of database of citations.
*[[Wikipedia:WikiProject Fact and Reference Check]]
*[[Wikipedia:Footnote1]] (alternate method – very old, manually numbered, ''don't use'')
*[[Wikipedia:Footnote2]] (alternate method – obsolete, manually numbered, replaced by Footnote3 system, which is no longer current)
*The '''an/anb''' footnote system, an alternate version of the ref/note system. The an/anb system is completely identical to the ref/note system
*[[Wikipedia:Footnote4]] (manually numbered system that allowed reuse of the same reference number multiple times in the same text, but has become deprecated after being incorporated into the footnote system){{ref_label|LabelVariant|2|d}}
*[[mw:Extension:Cite]] – current system (last verified as of June 2018)
*[[Wikipedia:VisualEditor/User guide]]

{{Wikipedia referencing}}

[[Category:Footnote3 templates|*]]
[[Category:Wikipedia archives]]
[[Category:Wikipedia how-to]]

[[hr:Wikipedia:Fusnote]]
[[sv:Wikipedia:Källhänvisningar]]