Wikipedia:Footnotes
-
WP:FOOT redirects here; you may also be looking for Wikipedia:WikiProject Football.
Note: The Cite.php footnote system is not mandatory; editors are free to use a different method. See How and where to cite sources.
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 cite references which are relevant to a text. Citation of sources is important in supporting Verifiability, a key aspect of Wikipedia.
Wikipedia has built-in support for footnotes, via the Cite.php extension to the MediaWiki software it runs on. You can add footnotes to an article using <ref> tags, which will be explained on this page. This way of adding footnotes is called "Cite.php footnotes", where "Cite.php" is the name of the file in MediaWiki that makes this possible.
Footnotes are an excellent way to cite sources, but they are not the only way; some articles use inline links instead, or Harvard referencing. Also, Cite.php footnotes are not the only way to make footnotes. Many articles use templates to create footnotes. For more information, see Wikipedia:Citing sources, which is the main style guide on citations.
Before Cite.php footnotes were available, the same functionality was achieved with a system called Wikipedia:Footnote3 that used templates.[1] Converting old Footnote3 notes to MediaWiki footnotes can make the references in an article easier to maintain.
Contents |
How to use
- A very simplified explanation is given at Help:Footnotes
- Place a <ref> ... </ref> where you want a footnote reference number to appear in an article—type the text of the note between the ref tags.
- Place the <references/> tag in a "Notes" or "References" section near the end of the article—the list of notes will be generated here.
This page itself uses footnotes, such as the one at the end of this sentence.[2] If you view the Wikicode of this page by clicking "Edit this page", you can see a working example of footnotes. The new format cannot be mixed on a page with the old Footnotes3 format—you must pick one or the other.
Where to place ref tags
Place a ref tag at the end of the term, phrase, sentence, or paragraph to which the note refers.[3]
The ref tag should be placed directly after most punctuation marks,[3] without an intervening space in order to prevent the reference number wrapping to the next line.[3] The same is true for successive ref tags.[2][3] The exception is a dash[3]—which should follow the ref tag. This is the format recommended by the Chicago Manual of Style.[4]
Example:
According to scientists, the Sun is pretty big,<ref>Miller, E: "The Sun.", page 23. Academic Press, 2005</ref>
however the moon is not so big.<ref>Smith, R: "Size of the Moon", ''Scientific American'', 46(78):46</ref>
== Notes ==
<references/>
Citing a footnote more than once
To give a footnote a unique identifier, use <ref name="name"> ... </ref>. You can then refer to the same footnote again by using a ref tag with the same name. The name cannot be a number, or the extension will return an error.
The text in the first occurrence of a named ref is used, so text in the second and following occurrence will be ignored.. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: <ref name="name"/>.
In the following example, the same source is cited three times.
This is an example of multiple references to the same footnote.<ref name="multiple">Remember that when you refer to the same footnote multiple times, the text from the first reference is used.</ref>
Such references are particularly useful when citing sources, if different statements come from the same source.<ref name="multiple">This text is superfluous, and won't show up anywhere. We may as well just use an empty tag.</ref>
A concise way to make multiple references is to use empty ref tags, which have a slash at the end.<ref name="multiple"/>
== Notes ==
<references/>
The text above gives the following result in the article (see also Notes section below):
This is an example of multiple references to the same footnote.[5]
Such references are particularly useful when citing sources, when different statements come from the same source.[5]
A concise way to make multiple references is to use empty ref tags, which have a slash at the end.[5]
One should be particularly careful when deleting the first of multiple named references, because the footnote text will be deleted unless it is copied to the second (now first) ref tag.
Style recommendations
- Internal links should still be used as normal, like this: Wikipedia.
- Wiki formatting such as bold, italics, and internal and external links work as normal within the text of your citation.
- Note: you cannot rely on the "pipe trick" to expand a link for you in ref text; you must type out [[George Clark (historian)|George Clark]], instead of just typing [[George Clark (historian)|]] and letting the software fill in the text after the pipe.
- Consider maintaining a separate bibliography/references section, then just the page number and book name can be given in each note, following Wikipedia:Citing sources.
- There are templates you can insert between the <ref> and </ref> tags to format bibliographic references for you. You can see some instructions on using these templates at Wikipedia:Template messages/Sources of articles#Citations of generic sources. The use of citation templates is not a requirement. If you find it easier to type the reference in bibliographic style yourself, you are not obligated to use these templates, but they help to maintain a consistent bibliographic style across articles.
- Some editors make the references smaller. Although a small font size can be difficult for many readers, it is common with very long lists of references to enclose the <references/> tag in a 'references-small class div', like this:
-
- <div class="references-small"><references/></div>
If multiple sections are are made small for consistency (e.g. notes, references, see also, external links sections), the div tags must be opened and closed within each section.
- A class exists for small footnotes in two columns, but this displays as a single column in some common browsers:
-
- <div class="references-2column"><references/></div>
- For another way to make smaller text footnotes, see below.
Helping editors unfamiliar with this system of footnotes
Rather than simply adding
<references/>
in the "References" or "Notes" section, consider adding the following:
<!--See http://en.wikipedia.org/wiki/Wikipedia:Footnotes for an explanation of how to generate footnotes using the <ref> and </ref> tags and the tag below -->
<references/>
The same effect can be obtained (that is, including both the commentary text and the <references/> tag) by putting the following in the references section:
{{subst:Footnotes|100%}}
The footnote text may also be RESIZED by changing the listed percentage. Any option other than 100% currently resizes the text to a standard 92%. Resizing is not encouraged as a standard technique in all articles.
{{subst:Footnotes|92%}}
{{FootnotesSmall}} should not be used with a "subst:", instead the use of {{subst:Footnotes|100%}} (or for long lists of footnotes:{{subst:Footnotes|92%}}) is encouraged while it includes the help comment mentioned above.
(Maintenance aid: list of Wikipedia articles that used the Footnotes template "non-subst:")
Compatibility with other MediaWiki sites
As of late December 2005, the Cite.php extension to MediaWiki has been installed on all Wikimedia wikis. Other wikis that use the MediaWiki software may not have this extension installed, and therefore may be unable to display Cite.php footnotes.
Technical details
See Meta:Cite/Cite.php for a technical explanation of the Cite.php extension on Meta-Wiki.
Converting citation styles
Converting citation styles should not be done without first gaining consensus for the change on the article's talk page.
A December 2005 ArbCom case ruled that the following scripts could no longer be used by a 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. For example, when using (semi-)bot tools as listed below:
- User:Cyde/Ref converter converts articles that use the {{ref}} and {{note}} system into the more recent m:Cite.php system;
- Citation Tool diagnoses and fixes sequencing and duplication errors in m:Cite.php references. In the future, Citation Tool may (optionally) enable user-guided conversion of some or all of the <ref> numbered citations to named notes using the footnote3 template technology (which includes Harvard references).
CAUTION: don't edit-war with automated tools that convert in opposing directions.
Disadvantages and future improvements
- In the old Footnote3 system, links and auto-numbered footnotes pulled from the same counter, which made it difficult to keep the endnotes consistent. With the new Cite.php module, a different issue presents itself: a casual reader might not notice or understand the difference between an external link and an auto-numbered footnote and may be confused, thinking that the numbers are not in order. For this reason, some editors argue that auto-numbered external links are better not used on the same page with auto-numbered footnotes, which can be avoided, e.g., by making text links for the external references, like this: Kate's Tool, instead of: Kate's Tool[1]. Other editors argue that both citation styles can be used in the same article, and that the disadvantage of using text links like Kate's Tool is that it does not clearly signal to the reader that they are being directed off Wikipedia.
- Superscripts cause an increase in line spacing for the line they are on in most browsers. 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 has not already). A fix has been published that eliminates the problem without reducing the size of the superscript. It requires the user to add CSS to their style sheet (monobook.css), and thus works only while logged in.
- The new style copies the bracketed numbers from the old style, though they are now in superscript. Typical (print) references use plain superscripted numbers with no brackets. If the purpose of the brackets is to increase the clickable area, they could be removed and the same thing done with CSS; increase the horizontal padding around the numbers and vertical arrows instead. Discussion here: w:Wikipedia_talk:Manual_of_Style#Changes_to_Cite. and w:Wikipedia_talk:Footnote3#Superscripts_2.
- 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.)
- The reference content is in the article source code, but displayed in the References section. Some have proposed moving the reference content into the References section to fix these problems:
- Content from one place rendering in a different place is confusing and unusual.
- Some references require a lot of markup (citation templates, for instance), which interrupts the article source code, making navigation of the article content more difficult.
- Editing the format of references requires finding them in the article instead of editing all of them at once in the References section. This is inconvenient and confusing.
- Section editing is useless if you want to edit references. You ca not just edit the References section because that is not where the references actually are. You can not just edit the section that contains the reference since that is not where the rendered references are (so they will not show up in the preview). You have to edit and preview the entire article to see the changes.
- Since they are not centralized, it is hard to know if a reference exists already, leading to duplicates which then have to be merged manually.
- Perhaps a way of referring to undefined references by name is needed, allowing you to actually define the reference at the bottom next to the references section. This would be the simplest meeting of both worlds.
- Only the first <ref> note with the same name attribute (e.g. <ref name="foo">) is used to determine the content of a footnote. Edits to an article can inadvertently put an empty named reference before one with content and/or put differing content in multiple named references (hence hiding all non-first note contents).
- If there is more than one <references/> section, each repeats all the <ref> tags used in the article. For example, in this situation:
- First group of ref tags
- References section (renders the above set of tags)
- Second group of ref tags
- Second references section (renders all ref tags from both sections)
- This is problematic in these situations:
- transcluding pages that have references
- documenting the references system (note that this page can not actually demonstrate references in action, for this reason)
- very large pages that have several different topics on them
- One possible solution would be a <clearrefs/> tag, that clears the current collection of stored references. See bugzilla bug bugzilla:5810, and User:Stevage/bug5810 and User:Stevage/bug5810a for examples. Stevage 13:06, 9 May 2006 (UTC)
- "Pipe trick" incompatibility, see Help:pipe trick#Cite.php footnotes and the pipe trick.
See also
- Wikipedia:Verifiability, which is policy.
- Wikipedia:Citing sources, the relevant style guide.
- 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; note that several of these templates can easily be combined with "footnote3" footnotes, see Gymnopédie#Notes and References for an example.
- Wikipedia:WikiProject Wikicite: Proposal for use of database of citations.
- Wikipedia:WikiProject Fact and Reference Check
- Other types of numbered footnotes:
- Wikipedia:Footnote1, a very old, manually-numbered footnote system that should not be used.
- Wikipedia:Footnote2, another obsolete system that should not be used.
- Wikipedia:Footnote3, an automatically-numbered footnote system using templates, which is widely used but has been replaced by MediaWiki footnotes.
- Help:Footnotes
- meta:Cite.php - description of the <ref>...</ref>/<references/> system at metawiki
- meta:Biblio - Biblio.php, an extension of Mediawiki which provides a citation manager. (beta maturity)
Notes
- ^ The Footnote3 system created footnotes with the {{ref}}/{{note}} and the {{ref_label}}/{{note_label}} pairs of templates. The system is still operational, and may be encountered on many Wikipedia pages.
- ^ a b This footnote is used as an example in the "How to use" section.
- ^ a b c d e This is the convention used in the Chicago Manual of Style
- ^ "Note reference numbers. The superior numerals used for note reference numbers in the text should follow any punctuation marks except the dash, which they precede. The numbers should also be placed outside closing parentheses." (The Chicago Manual of Style, 14th ed. 1993, Clause 15.8, p. 494)
- ^ a b c Remember that when you refer to the same footnote multiple times, the text from the first reference is used.
- Additional references that aren't created with the extension (as per WP:CITE) do not continue the numbering.