Help:Footnotes and endnotes

←

Footnotes and endnotes

→

sister projects: Wikipedia article, definition, Wikidata item, Meta

Best practice for implementing footnotes on Wikisource

Note: Wikisource has a universal approach to our presentation of footnotes and endnotes. We do not implement custom styles.

Introduction to Wikisource's presentation style

English Wikisource has many works with footnotes or endnotes, commonly also known as references. Whether the work is a book, a document, a press release, or the many other available types of work, they can contain these notes, in a myriad of styles utilised by publishers through the ages in the placement of these notes, their style, or, their presentation, in whatever the published work. So in tune with the general guidance in our style guide there is a general means to present notes in our works.

Wikisource remains true to the publishing of these notes from works, however, due to metamorphosis of these works to the web, and the mediawiki platform that we utilise, we do not present footnotes on basis of per page of the original work. Wikisource instead aims to present these notes as endnotes at the end of the presented pages—work or subpage of the work. As part of this approach, and from our experience, there is both a need and a wish to standardise the presentation of the style of endnotes, rather than replicate the styles utilised by each publisher at that time of original publication.

If the work only uses special symbols in one symbol set, the house style is to instead use incremental numbers.

Types of footnote

In publishing there are, and have been, various methods of printing notes: either as notes at the bottom of the page, or aggregated at the end of a chapter or section. Sometimes all notes are accumulated as lists at the end of the book.

Footnotes are often indicated by numbers or typographical symbols: such as the section §, the Pilcrow or paragraph mark ¶, the single and double daggers † ‡, and the asterisk *.

Adding footnotes

On Wikisource all footnotes should be implemented with <ref> tags. These can be automatically collected and listed by another tag at the bottom of the page: either <references/> {{reflist}} or {{smallrefs}}.

Footnotes

Instead of putting the footnote text at the bottom of the page, it should be placed immediately following the noted text (ie. where the note indicator is in the text) wrapped in <ref> ... </ref> tags.

For example, if the printed page contains the following text:

And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.⁴

For which the accompanying footnote at the base of the page is:

⁴ Revue des Deux Mondes, February 15, 1872.

When rendering this into wikitext while proofreading, it should look like:

And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.<ref>''Revue des Deux Mondes'', February 15, 1872.</ref>

Once saved, this will appear as:

And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.^[1]

For reference: this example is based on Page:Popular Science Monthly Volume 1.djvu/13; which can be seen as part of "The Study of Sociology I," an article published in Popular Science Monthly in May 1872.

Displaying the footnotes

The most basic way of displaying footnotes is with the <references/> tag. This should be placed:

At the bottom of the page in the main namespace, immediately after the transcluded text and before the categories and other footer items.
In the "footer" field of each page in the Page namespace that contains footnotes. By default, all index pages automatically add this footer but this can be overridden manually at the index page.

This tag will automatically create a numbered list of all items in <ref> tags on the page. It does not matter if the tagged text has been directly written into the page by editing or if it has been transcluded from the Page namespace. The list will be sorted in the order the footnotes exist on the page (ie. first footnote is number 1, second footnote is number 2, etc).

Using the example above:

Wikitext	<references/>
Appearance	↑ Revue des Deux Mondes, February 15, 1872.

Optionally, instead of the <references/> tag, one of the following templates may be used instead:

{{reflist}}
{{smallrefs}}

Endnotes

If the original work put the notes at the end of the section or chapter and the full section or chapter will be transcluded into one subpage in the main namespace: use the method described above.

If the original work put the notes in a separate section, for example, collecting all footnotes for all chapters in one section or appendix at the back of the book, either:

Ignore the formatting of the original work and include all footnotes at the bottom of the section or chapter as described in the method above.
Create a separate subpage for the endnote section. See Alternatives for possible ways to link between note indicator and the footnote itself.

In some cases it is possible to turn endnotes into footnotes by using the advanced functionality described below at #Footnotes that continue over page breaks.

Advanced

Footnotes that continue over page breaks

Paragraphs in footnotes

Some sources have footnotes which contain multiple paragraphs, and text in <ref> tags does not currently support this in the same way as ordinary text.

For example:

Lorem<ref>Example footnote paragraph 1. Example footnote paragraph 2. Example footnote paragraph 3.</ref> <references />

Will appear as:

Lorem^[1] ↑ Example footnote paragraph 1. Example footnote paragraph 2. Example footnote paragraph 3.

While <br/> or <p></p> tags could be used to separate the paragraphs, these do not always work well when exporting to PDF or eBook formats. Instead, use {{Paragraph break}} (or its shortcuts {{pbr}} / {{parabr}}) between the paragraphs.

For example:

Lorem<ref>Example footnote paragraph 1. {{paragraph break}} Example footnote paragraph 2. {{paragraph break}} Example footnote paragraph 3.</ref> <references />

Will appear as:

Lorem^[1] ↑ Example footnote paragraph 1. Example footnote paragraph 2. Example footnote paragraph 3.

Grouped footnotes

It may sometimes be necessary to split footnotes into different sections. Different footnotes may be listed in more than one place or there may be different types of footnote, each with its own list at the end. In these cases, the different sets of footnotes should be grouped.

When using the <ref> tags add the "group" parameter. The name of the group used can be chosen by the individual proofreader but note that it will be visible on the page as part of the numeric indicator for the footnote. All tags in a specific group must have the same "group" parameter.

Each <references/> tag must also have the same "group" parameter. Each tag will only list footnotes that have the same group name.

For example:

Lorem<ref group="A">Foo</ref> Ispum<ref group="B">Bar</ref> Dolar<ref group="A">Baz</ref> Group "A": <references group="A" /> Group "B": <references group="B" />

This will appear as:

Lorem^{[A 1]} Ipsum^{[B 1]} Dolar^{[A 2]} Group "A": ↑ Foo ↑ Baz Group "B": ↑ Bar

Nested footnotes

There is a known limitation in mediawiki that certain tags such as <ref> are parsed in a linear rather than hierarchic fashion, resulting in constructions such as:

This is a basic<ref>Not<ref>Here is an opportunity for a really bad pun.</ref> the computer language!</ref> statement.<references/>

unexpectedly resulting in…

This is a basicCite error: Closing </ref> missing for <ref> tag the computer language!</ref> statement.

…due to the parser attempting to match the first occurrence of </ref> back to the first occurrence of <ref> instead of to the innermost occurrence and generally thereafter becoming confused.

In these instances, the template {{refn}} may be used. This same sequence may be re-expressed as:

This is a basic{{refn|Not<ref>Here is an opportunity for a really bad pun.</ref> the computer language!}} statement.<references/>

which produces something closer to the expected result:

This is a basic^[2] statement.

↑ Here is an opportunity for a really bad pun.
↑ Not^[1] the computer language!

—but sadly, the footnotes are still "out-of-order" with regards to normal expectation.

In order to fix this, we can use the parameters name and follow with {{refn}} as follows:

This is a basic{{refn|name=dummy}}{{refn|Not<ref>Here is an opportunity for a really bad pun.</ref> the computer language!|follow=dummy}} statement. <references/>

This results in:

This is a basic^[1] statement.

↑ Not^[2] the computer language!
↑ Here is an opportunity for a really bad pun.

We may also apply this to nested grouped footnotes:

This is a basic{{refn|Not<ref group="B">Here is an opportunity for a really bad pun.</ref> the computer language!|group="A"}} statement.
Group "A": <references group="A" />

Group "B": <references group="B" />

This new coding results in:

This is a basic^{[A 1]} statement. Group "A":

↑ Not^{[B 1]} the computer language!

Group "B":

↑ Here is an opportunity for a really bad pun.

Multiple references that point to the same footnote

Sometimes two or more references may point to the same footnote, for example.

Text	Here is one reference^[1] and here is another^[1] pointing to the same footnote. Here is one more^[1]
Footnote	↑ ^1.0 ^1.1 ^1.2 This is the footnote that can be reached by the three different reference tags

This is accomplished by using the "name" parameter. Give the first reference a unique name, in our example it is ref and each subsequent reference that points to the same footnote is tagged <ref name= /> where you want the references to appear. In our example it is <ref name=ref />

Here is one reference<ref name=ref>This is the footnote that can be reached by the three different reference tags</ref> and here is another<ref name=ref /> pointing to the same footnote. Here is one more<ref name=ref />

Multiple pages that reference the same footnote

Sometimes, a page references a footnote located on another page earlier in the work. Here is one solution to make both pages and the whole transcluded document look right:

Page containing the footnote

The page containing the footnote should name the reference. Example:

This page references the footnote for the first time.<ref name="name-of-the-ref">This is the footnote that is referenced by multiple pages.</ref>

Other page referencing the footnote

In the body of the page, the reference should be given the name only. Example:

The other page referencing the footnote should only include its name in the body of the text.<ref name="name-of-the-ref" />

In the footer of the page, one of the following options must appear, depending on which reference format is being used elsewhere in the work:

With <references />:

<references>
<ref name="name-of-the-ref">This is the footnote that is referenced by multiple pages.</ref>
</references>

With {{smallrefs}}:

{{smallrefs|refx=
<ref name="name-of-the-ref">This is the footnote that is referenced by multiple pages.</ref>
}}

With {{reflist}}:

{{reflist|refs=
<ref name="name-of-the-ref">This is the footnote that is referenced by multiple pages.</ref>
}}

See Page:Oregon Historical Quarterly vol. 4.djvu/35 and Page:Oregon Historical Quarterly vol. 4.djvu/38 for a demonstration.

Alternatives

The preceding instructions are best practice for producing footnotes on Wikisource. However, in some rare cases it may be more appropriate to use one of the following methods instead.

Ref and Note templates

The reference indicator can be replaced with a {{Ref}} template, with the matching text following a {{Note}} template. This gives the proofreader more control over the placement of the footnote but it has the strong drawback of not being able to group footnotes when transcluded to the main namespace.

Using the example above, the main text will be written as:

And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.{{ref\|4}}

The footnote will be written as:

{{sup\|4}} {{note\|4}} ''Revue des Deux Mondes'', February 15, 1872.

The result is:

Text	And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.^[4]
Footnote	⁴ ↑ Revue des Deux Mondes, February 15, 1872.

When using this method, it is important to prepend the footnote the appropriate figure or symbol. This means the note can be found if it is being read from a printed copy instead of on a screen.

Endnotes with anchors

If the original work had endnotes at the back of the book (or other publication) it may sometimes be more appropriate to list all the footnotes in a special subpage. This subpage should ideally transclude the endnotes section from a scan of the original work.

In order to create the link from the indicator in the text to the footnote, wikilinks and anchors can be used. The indicator should be a wikilink in a format such as [[My book/endnotes#footnote4]]. The footnote should be preceded by a {{anchor}} template.

If the preceding example were in this format, with the footnote in another section, the text would appear as:

And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.{{sup\|[[Help:Footnotes and endnotes#footnote4\|4]]}}

Although, rather than this help page, the wikilink would look more like [[The Study of Sociology I/Endnotes#footnote4|4]].

The footnote would be written as:

{{anchor\|footnote4}}{{sup\|4}} ''Revue des Deux Mondes'', February 15, 1872.

The result is:

Text	And here it is doubtless thought by some, as it is in France by M. de Lagevenais, that Government, by supplying good music, should exclude the bad, such as that of Offenbach.⁴
Endnote	⁴ Revue des Deux Mondes, February 15, 1872.

v t e Proofreading
Summaries	Beginner's guide to proofreading Editing summary Proofreading summary
Basic help	Formatting conventions Index pages Page scans Page status Transclusion Layout
Specialised help	Block and inline elements Footnotes and endnotes Match and split Mathematics, fractions and functions Page breaks Page numbers Poetry Sidenotes Tables Typography templates Manuscripts
Reference	Style guide ProofreadPage extension Proofreading example
Collaboration	Monthly Challenge Proofread of the Month Works to be proofread WikiProject Proofreading

Help:Footnotes and endnotes

Contents

Introduction to Wikisource's presentation style

Types of footnote

Adding footnotes

Footnotes

Displaying the footnotes

Endnotes

Advanced

Footnotes that continue over page breaks

Paragraphs in footnotes

Grouped footnotes

Nested footnotes

Multiple references that point to the same footnote

Multiple pages that reference the same footnote

Alternatives

Ref and Note templates

Endnotes with anchors

See also