Help:References: Difference between revisions

From Tolkien Gateway
m (Bot Message: re-linking)
(→‎Shortcuts: Added template)
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''References''' are the cornerstone of any serious encyclopedia. Though much of our old content remains without references, '''[[Tolkien Gateway: About|Tolkien Gateway]]''' wishes to properly credit its facts. This way, fanon and overinterpretation can be properly identified as such, and omitted.
'''References''' are the cornerstone of any serious encyclopedia. Though much of our old content remains without inline references, [[Tolkien Gateway]] wishes to properly credit its statements. This way, [[fanon]] and overinterpretation can be properly identified and omitted, and valid statements can be properly attributed to reliable sources.  
 
==General rules==
::''See also: [[Canon]]''
As to what counts as a reliable source, in the tightest sense it is simple: primary material. From there, we have secondary and "semi-secondary".
 
;Semi-secondary
Semi-secondary, as we call it for the sake of convenience, are texts by Tolkien that are about Middle-earth; these could be ''[[The Letters of J.R.R. Tolkien]]'', but also material published in ''[[Vinyar Tengwar]]'' or ''[[Parma Eldalamberon]]''.
;Secondary
Secondary texts are texts about Tolkien's work by other authors. We have a short rule for it: if they cite primary, we cite primary, and if they come up with original research, we cite them.  


==Referencing==
==Referencing==
===How To===
===How to===
[[Tolkien Gateway:About|Tolkien Gateway]] uses, like most wiki-based encyclopedia's, the [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite/Cite extension]. A short how-to:
Tolkien Gateway uses, like most wiki-based encyclopedia's, the [http://www.mediawiki.org/wiki/Extension:Cite/Cite.php Cite/Cite extension]. A short how-to:


With this method, sources are cited '''within''' the text. They appear wherever you type "<nowiki>{{references}}</nowiki>".
With this method, sources are cited '''within''' the text. The full citations appear wherever you type "<nowiki>{{references}}</nowiki>", which should generally be at the bottom of the page just above the categories.


<pre><nowiki>This is the text you type.<ref>And this is the source</ref></nowiki></pre>
<pre><nowiki>This is the text you type.<ref>And this is the source</ref></nowiki></pre>
Line 21: Line 11:
The text in between the <nowiki><ref></nowiki>-tags appears in the References section. These tags can be named for reuse:  
The text in between the <nowiki><ref></nowiki>-tags appears in the References section. These tags can be named for reuse:  


<pre><nowiki>This is the text you type.<ref name="One">And this is source number one</ref></nowiki>
<pre><nowiki>This is the text you type.<ref name=One>And this is source number one</ref></nowiki>


<nowiki>Then, you use something with another source,<ref>Like this one</ref>,</nowiki><nowiki> before returning  
<nowiki>Then, you use something with another source,<ref>Like this one</ref>,</nowiki><nowiki> before returning  
to the first one.<ref name="One"/></nowiki></pre>
to the first one.<ref name=One/></nowiki></pre>


===Shortcuts===
===Shortcuts===
:''See also [[:Category:Citation templates]]''
:''See also [[:Category:Citation templates]]''
The most common sources have templates that can be used to write out references automatically:
The most common sources have templates that can be used to write out references automatically. Generally, the format to use them is:
<pre><ref>{{T|chapter#}}</ref></pre>
But there will sometimes be additional options for sources with more complex structures. For detailed instructions on how to use an individual template, click on that template's link below.


'''Main works'''
* [[:Template:H|<nowiki>{{H}}</nowiki>]] = ''[[The Hobbit]]''
* [[:Template:H|<nowiki>{{H}}</nowiki>]] = ''[[The Hobbit]]''


Line 36: Line 29:
** [[:Template:TT|<nowiki>{{TT}}</nowiki>]] = ''[[The Two Towers]]''
** [[:Template:TT|<nowiki>{{TT}}</nowiki>]] = ''[[The Two Towers]]''
** [[:Template:RK|<nowiki>{{RK}}</nowiki>]] = ''[[The Return of the King]]''
** [[:Template:RK|<nowiki>{{RK}}</nowiki>]] = ''[[The Return of the King]]''
** [[:Template:App|<nowiki>{{App}}</nowiki>]] = the ''[[The Lord of the Rings Appendices|Appendices]]''
** [[:Template:App|<nowiki>{{App}}</nowiki>]] = ''[[The Lord of the Rings Appendices|Appendices]]''


* [[:Template:S|<nowiki>{{S}}</nowiki>]] = ''[[The Silmarillion]]''
* [[:Template:S|<nowiki>{{S}}</nowiki>]] = ''[[The Silmarillion]]''
* [[:Template:CH|<nowiki>{{CH}}</nowiki>]] = ''[[The Children of Húrin]]''
* [[:Template:BL|<nowiki>{{BL}}</nowiki>]] = ''[[Beren and Lúthien]]''
* [[:Template:UT|<nowiki>{{UT}}</nowiki>]] = ''[[Unfinished Tales]]''
* [[:Template:UT|<nowiki>{{UT}}</nowiki>]] = ''[[Unfinished Tales]]''
* [[:Template:RGEO|<nowiki>{{RGEO}}</nowiki>]] = ''[[The Road Goes Ever On (book)|The Road Goes Ever On]]''


* '''''[[The History of Middle-earth]]'''''
* '''''[[The History of Middle-earth]]'''''
** [[:Template:LT1|<nowiki>{{LT1}}</nowiki>]] = ''[[The Book of Lost Tales Part One]]''
** [[:Template:LT1|<nowiki>{{LT1}}</nowiki>]] = ''[[The Book of Lost Tales Part One]]''
** [[:Template:LT2|<nowiki>{{LT2}}</nowiki>]] = ''[[The Book of Lost Tales Part 2|The Book of Lost Tales Part II]]''
** [[:Template:LT2|<nowiki>{{LT2}}</nowiki>]] = ''[[The Book of Lost Tales Part Two]]''
** [[:Template:LB|<nowiki>{{LB}}</nowiki>]] = ''[[The Lays of Beleriand]]''
** [[:Template:SM|<nowiki>{{SM}}</nowiki>]] = ''[[The Shaping of Middle-earth]]''
** [[:Template:LR|<nowiki>{{LR}}</nowiki>]] = ''[[The Lost Road|The Lost Road and Other Writings]]''
** [[:Template:RS|<nowiki>{{RS}}</nowiki>]] = ''[[The Return of the Shadow]]''
** [[:Template:TI|<nowiki>{{TI}}</nowiki>]] = ''[[The Treason of Isengard]]''
** [[:Template:WR|<nowiki>{{WR}}</nowiki>]] = ''[[The War of the Ring]]''
** [[:Template:SD|<nowiki>{{SD}}</nowiki>]] = ''[[Sauron Defeated]]''
** [[:Template:MR|<nowiki>{{MR}}</nowiki>]] = ''[[Morgoth's Ring]]''
*** [[:Template:AA|<nowiki>{{AA}}</nowiki>]] = "[[The Annals of Aman]]"
** [[:Template:WJ|<nowiki>{{WJ}}</nowiki>]] = ''[[The War of the Jewels]]''
*** [[:Template:GA|<nowiki>{{GA}}</nowiki>]] = "[[The Grey Annals]]"
** [[:Template:PM|<nowiki>{{PM}}</nowiki>]] = ''[[The Peoples of Middle-earth]]''
** [[:Template:PM|<nowiki>{{PM}}</nowiki>]] = ''[[The Peoples of Middle-earth]]''
** ''[[The War of the Jewels]]''
 
*** [[:Template:GA|<nowiki>{{GA}}</nowiki>]] = "''[[The Grey Annals]]''"
* [[:Template:HH|<nowiki>{{HH}}</nowiki>]] = ''[[The History of The Hobbit]]''
** [[:Template:WR|<nowiki>{{WR}}</nowiki>]] = ''[[The War of the Ring]]''


* [[:Template:L|<nowiki>{{L}}</nowiki>]] = ''[[The Letters of J.R.R. Tolkien]]''
* [[:Template:L|<nowiki>{{L}}</nowiki>]] = ''[[The Letters of J.R.R. Tolkien]]''


Generally the format to use them is:
* [[:Template:CG|<nowiki>{{CG}}</nowiki>]] = ''[[The J.R.R. Tolkien Companion and Guide]]''
<pre><ref>{{T|chapter#}}</ref></pre>
 
But there will sometimes be additional options for sources with more complex structures. For detailed instructions see the individual template pages.
'''Other works'''
* [[:Template:AB|<nowiki>{{AB}}</nowiki>]] = ''[[The Adventures of Tom Bombadil|The Adventures of Tom Bombadil and Other Verses from the Red Book]]''
* [[:Template:Arthur|<nowiki>{{Arthur}}</nowiki>]] = ''[[The Fall of Arthur]]''
* [[:Template:Beowulf|<nowiki>{{Beowulf}}</nowiki>]] = ''[[Beowulf: A Translation and Commentary]]''
* [[:Template:HB|<nowiki>{{HB}}</nowiki>]] = ''[[The Homecoming of Beorhtnoth Beorhthelm's Son]]''
* [[:Template:LFC|<nowiki>{{LFC}}</nowiki>]] = ''[[Letters from Father Christmas]]''
* [[:Template:MC|<nowiki>{{MC}}</nowiki>]] = ''[[The Monsters and the Critics]]''
* [[:Template:RGEO|<nowiki>{{RGEO}}</nowiki>]] = ''[[The Road Goes Ever On (book)|The Road Goes Ever On]]''
* [[:Template:SG|<nowiki>{{SG}}</nowiki>]] = ''[[The Legend of Sigurd and Gudrún]]''
 
* [[:Template:PE|<nowiki>{{PE}}</nowiki>]] = ''[[Parma Eldalamberon]]''
* [[:Template:VT|<nowiki>{{VT}}</nowiki>]] = ''[[Vinyar Tengwar]]''
 
''Note:'' [[:Template:HM|<nowiki>{{HM}}</nowiki>]] is the old 'general-purpose' template, but it has been mostly superseded by the above templates, which offer more flexibility.
 
'''Internet sources'''
 
Additionally, the [[:Template:Webcite|<nowiki>{{Webcite}}</nowiki>]] template can be used to cite web sources. See the template page for instructions on how to use it.
 
===Page numbers===
Including page numbers in citations in generally preferred for paginated sources. However, because many works have multiple publishers and editions with varying page numbers, this is not always possible. Including publisher and edition information in citations is generally disfavored.
 
For the below works, follow these guidelines:


[[:Template:HM|<nowiki>{{HM}}</nowiki>]] is the old 'general-purpose' template, but it has been mostly superseded by the above templates, which offer more flexibility.
* ''[[The Hobbit]]'' - Do not include page numbers in citations.
* ''[[The Lord of the Rings]]'' - Do not include page numbers in citations unless you are citing to the [[The Lord of the Rings (50th Anniversary Edition)|50th Anniversary Edition]] (which is the edition favoured for citations in scholarly works)
* ''[[Unfinished Tales]]'' - Do not include page numbers in citations.
* ''[[The History of Middle-earth]]'' series - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt (all of which have the same pagination); otherwise, exclude page numbers.
* ''[[The Children of Húrin]]'' - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt; otherwise, exclude page numbers.
* ''[[Beren and Lúthien]]'' - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt; otherwise, exclude page numbers.


===Standards===
===Standards===
The following standards should be applied when writing references using "<nowiki><ref>...</ref></nowiki>":
The following standards should be applied when writing references using "<nowiki><ref>...</ref></nowiki>":


*Avoid adding a period/full stop at the end of the tag line ''(Example: "<nowiki><ref>{{HM|RC}}, p. 20</ref></nowiki>")''
*Place the tag line ''after'' the [[Wikipedia:Punctuation|punctuation mark]]. However, an exception could be if you want to give a reference for a certain linguistic form of a word (or something similar).
*Use "p." instead of "page" and "pp." instead of "pages" ''(Example: "pp. 20-2")''
*Use "p." instead of "page" and "pp." instead of "pages" ''(Example: "pp. 20-2")''
*Leave a space between "p." (or "pp.") and the page number ''(Example: "p. 20")''
*Leave a space between "p." (or "pp.") and the page number ''(Example: "p. 20")''
*Avoid adding a period/full stop at the end of the tag line ''(Example: "<nowiki><ref>{{HM|RC}}, p. 20</ref></nowiki>")''
 
*Place the tag line ''after'' the [[Wikipedia:Punctuation|punctuation mark]]. However, an exception could be if you want to give a reference for a certain linguistic form of a word (or something similar).
==Footnoting==
An explanatory footnote (i.e., a footnote used for some reason other than purely to provide a citation, such as to provide additional information or clarification) can be added to an article by using a <nowiki><ref></nowiki> tag with the "note" parameter:
 
<pre><nowiki>This is the text.<ref group=note>This is the explanatory footnote. See citation.</ref></nowiki></pre>
 
When placing the <nowiki>{{references}}</nowiki> template near the bottom of the article, it must include a "notes" parameter for these footnotes to appear on the page; to do so, use the code <nowiki>{{references|notes}}</nowiki> (instead of the usual "<nowiki>{{references}}</nowiki>" code).
 
Note that <nowiki><ref></nowiki> tags cannot be nested, meaning that you cannot include an inline citation within an explanatory footnote itself. In other words, placing <nowiki><ref>...</ref></nowiki> code ''inside'' of <nowiki><ref group=note> ...</ref></nowiki> code will ''not'' work. Therefore, to include a citation in an explanatory footnote, provide the citation in the text of the footnote itself (following whichever part of the footnote text that the citation supports), as indicated in the example above.


==Questionable statements==
==Questionable statements==
Questionable statements can be challenged with the <nowiki>{{fact}}</nowiki> template. Conjecture and interpretation should be marked with the [[Tolkien Gateway:Original research|<nowiki>{{or}}</nowiki>]]. Fanon, radical conjecture and overinterpretation that goes unreferenced should be moved to the Talk page.
Questionable statements can be challenged with the [[:Template:fact|<nowiki>{{fact}}</nowiki>]] template. [[Fanon]], conjecture, and overinterpretation that is unreferenced can be deleted on sight.
 
==See also==
*[[Tolkien Gateway:Manual of Style]]
*[[Tolkien Gateway:Canon policy]]


[[Category:Help]]
[[Category:Help]]

Revision as of 11:21, 25 August 2019

References are the cornerstone of any serious encyclopedia. Though much of our old content remains without inline references, Tolkien Gateway wishes to properly credit its statements. This way, fanon and overinterpretation can be properly identified and omitted, and valid statements can be properly attributed to reliable sources.

Referencing

How to

Tolkien Gateway uses, like most wiki-based encyclopedia's, the Cite/Cite extension. A short how-to:

With this method, sources are cited within the text. The full citations appear wherever you type "{{references}}", which should generally be at the bottom of the page just above the categories.

This is the text you type.<ref>And this is the source</ref>

The text in between the <ref>-tags appears in the References section. These tags can be named for reuse:

This is the text you type.<ref name=One>And this is source number one</ref>

Then, you use something with another source,<ref>Like this one</ref>, before returning 
to the first one.<ref name=One/>

Shortcuts

See also Category:Citation templates

The most common sources have templates that can be used to write out references automatically. Generally, the format to use them is:

<ref>{{T|chapter#}}</ref>

But there will sometimes be additional options for sources with more complex structures. For detailed instructions on how to use an individual template, click on that template's link below.

Main works

Other works

Note: {{HM}} is the old 'general-purpose' template, but it has been mostly superseded by the above templates, which offer more flexibility.

Internet sources

Additionally, the {{Webcite}} template can be used to cite web sources. See the template page for instructions on how to use it.

Page numbers

Including page numbers in citations in generally preferred for paginated sources. However, because many works have multiple publishers and editions with varying page numbers, this is not always possible. Including publisher and edition information in citations is generally disfavored.

For the below works, follow these guidelines:

  • The Hobbit - Do not include page numbers in citations.
  • The Lord of the Rings - Do not include page numbers in citations unless you are citing to the 50th Anniversary Edition (which is the edition favoured for citations in scholarly works)
  • Unfinished Tales - Do not include page numbers in citations.
  • The History of Middle-earth series - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt (all of which have the same pagination); otherwise, exclude page numbers.
  • The Children of Húrin - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt; otherwise, exclude page numbers.
  • Beren and Lúthien - Include page numbers in citations only if you are citing to an edition published by HarperCollins or Houghton Mifflin Harcourt; otherwise, exclude page numbers.

Standards

The following standards should be applied when writing references using "<ref>...</ref>":

  • Avoid adding a period/full stop at the end of the tag line (Example: "<ref>{{HM|RC}}, p. 20</ref>")
  • Place the tag line after the punctuation mark. However, an exception could be if you want to give a reference for a certain linguistic form of a word (or something similar).
  • Use "p." instead of "page" and "pp." instead of "pages" (Example: "pp. 20-2")
  • Leave a space between "p." (or "pp.") and the page number (Example: "p. 20")

Footnoting

An explanatory footnote (i.e., a footnote used for some reason other than purely to provide a citation, such as to provide additional information or clarification) can be added to an article by using a <ref> tag with the "note" parameter:

This is the text.<ref group=note>This is the explanatory footnote. See citation.</ref>

When placing the {{references}} template near the bottom of the article, it must include a "notes" parameter for these footnotes to appear on the page; to do so, use the code {{references|notes}} (instead of the usual "{{references}}" code).

Note that <ref> tags cannot be nested, meaning that you cannot include an inline citation within an explanatory footnote itself. In other words, placing <ref>...</ref> code inside of <ref group=note> ...</ref> code will not work. Therefore, to include a citation in an explanatory footnote, provide the citation in the text of the footnote itself (following whichever part of the footnote text that the citation supports), as indicated in the example above.

Questionable statements

Questionable statements can be challenged with the {{fact}} template. Fanon, conjecture, and overinterpretation that is unreferenced can be deleted on sight.

See also