Help:Footnotes: difference between revisions

This page explains how to create numbered footnotes (endnotes) using <ref>,</ref>, and <references/> syntax, which is the current best-practice method in most circumstances.

Footnotes are most often used in References and Usage Notes. See Wiktionary:References and Wiktionary:Usage notes for policy about each.

At the point of citation in the entry, enter the footnote or reference like this:

<ref>''Oxford English Dictionary, Second Edition'', 1989</ref>

You can include formatting and links in the footnote or reference in the usual way. The reference will become visible in the <references/> list at the bottom, if there is one.

At the point where you want the text of the footnotes or references to appear (usually in a Usage notes or References section), insert the tag:

<references/>

Note that this must be added before you add any footnotes – if you try to add footnotes without a <references/> present, the edit will be blocked.

To cite the same reference or footnote several times, identify it using the name parameter of the <ref> tag.

At one of the citation points (it makes sense to choose the first), enter the reference like this:

<ref name="OED">''Oxford English Dictionary, Second Edition,'' 1989</ref>

Then at all the other citation points, just enter:

<ref name="OED"/>

You are free to pick any footnote name, subject to a few rules. The footnote name is internal and will not be displayed anywhere when the page is viewed. Footnote names are case sensitive and may not be a numeric integer. The quotes are optional unless the name or group includes a space, punctuation or other mark. Names and groups should be kept simple and restricted to the standard English alphabet and numerals.

The <ref> tags in the main text are converted to auto-numbered superscripts, like this:

Clicking on a numbered superscript takes you straight to the text of the corresponding footnote or reference.

The <references/> tag is expanded to show the text of the footnotes or references against their corresponding numbers, like this:

For single citations, clicking on the caret (^) takes you to the point of citation in the main text. For multiple citations, the links back to the main text are distinguished by number superscripts (1.0, 1.1, etc.). Clicking on a letter superscript takes you to the corresponding citation in the main text, assuming the citation is visible and not hidden.

Sometimes it is convenient to separate explanatory footnotes from references. This can be accomplished with the "group" parameter:

===Etymology===

It is said that (of ''foo'') it is from ''[[FUBAR]]''<ref>''Oxford English Dictionary, Second Edition,'' 1989</ref>. This could be why some use it today in a negative way <ref group="usage">It is often exclaimed by programmers when execution fails.</ref>

...

===Usage notes===
<references group="usage"/>

===References===
<references/>

Etymology

It is said that (of foo) is that of FUBAR^[1]. This could be why some use it today in a negative way ^{[usage 1]}

Usage notes

References

Note that, at present, such footnotes cannot themselves contain reference links.

As of September 2009, the cite software allows named references to be defined within the reference list rather than in the main part of the entry. This can make editing entries much easier, particularly on heavily cited sections. For example:

The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>

<references>
<ref name="LazyDog">This is the lazy dog reference.</ref>
</references>

The quick brown fox jumps over the lazy dog.^[1]

Footnotes inserted in a language entry should be shown in that same entry (rather than all at the bottom of the page. Identifiers such as name= and group= will not collide with each other across language entries.

There is no policy on when to use footnotes. Wiktionary:Entry layout explained, the main policy on formatting, doesn't mention them. By convention footnotes are not widely used and most editors prefer to put references directly under the ===References=== header.

• m:help:footnotes - General MediaWiki footnotes documentation
• mw:Extension:Cite/Cite.php - technical details about cite.php technology