Difference between revisions of "Help:References"

From The Coppermind
Jump to navigation Jump to search
(References & citations)
 
m
Line 9: Line 9:
 
To create references you will use a '''reference template'''. Templates are a useful trick that simplify the work involved. While not necessary to understand the basics, it may be helpful to take a look at the [[:Help:Templates]] article before continuing.
 
To create references you will use a '''reference template'''. Templates are a useful trick that simplify the work involved. While not necessary to understand the basics, it may be helpful to take a look at the [[:Help:Templates]] article before continuing.
   
A ''basic'' reference template looks like this: <code><nowiki>{{ref|text=This is a reference.}}</nowiki></code>. Notice that it's enclosed by double curly braces (<code>{{}}</code>). The ''template name'' comes first ("ref"), followed by ''parameters'', all separated by vertical bars (<code>|</code>). Named parameters, like "text=" require the parameter name and equals sign along with your input, as shown above. Unnamed parameters (you'll see these below, in all caps) should be completely replaced by your input. When placed in the text of an article, it will be automatically rendered as a superscript, bracketed number: <code>{{ref|text=This is a reference.}}</code>. It links to the bottom of the page, where you'll see that same number along with the text: <references />
+
A ''basic'' reference template looks like this: <code><nowiki>{{ref |text=This is a reference.}}</nowiki></code>. Notice that it's enclosed by double curly braces (<code>{{}}</code>). The ''template name'' comes first ("ref"), followed by ''parameters'', all separated by vertical bars (<code>|</code>). Named parameters, like "text=" require the parameter name and equals sign along with your input, as shown above. Unnamed parameters (you'll see these below, in all caps) should be completely replaced by your input. When placed in the text of an article, it will be automatically rendered as a superscript, bracketed number: <code>{{ref |text=This is a reference.}}</code>. It links to the bottom of the page, where you'll see that same number along with the text: <references />
   
 
There are a LOT of reference templates to choose from. The right one for the job depends on what the source is. Here are some of the most commonly used reference templates and the parameters they require. For a complete list of all reference templates see [[:Category:Reference templates]].
 
There are a LOT of reference templates to choose from. The right one for the job depends on what the source is. Here are some of the most commonly used reference templates and the parameters they require. For a complete list of all reference templates see [[:Category:Reference templates]].
Line 17: Line 17:
   
 
;General Book {{t|book ref}}
 
;General Book {{t|book ref}}
: Looks like: <code><nowiki>{{book ref|BOOK|CHAPTER}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{book ref |BOOK |CHAPTER}}</nowiki></code>, where:
 
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
 
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
 
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
 
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
Line 23: Line 23:
   
 
;Epigraphs {{t|epigraph ref}}
 
;Epigraphs {{t|epigraph ref}}
: Looks like: <code><nowiki>{{epigraph ref|BOOK|CHAPTER}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{epigraph ref |BOOK |CHAPTER}}</nowiki></code>, where:
 
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
 
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
 
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
 
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
   
 
;Mistborn<nowiki>:</nowiki> Secret History {{t|msh ref}}
 
;Mistborn<nowiki>:</nowiki> Secret History {{t|msh ref}}
: Looks like: <code><nowiki>{{msh ref|PART|CHAPTER}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{msh ref |PART |CHAPTER}}</nowiki></code>, where:
 
:* <code>PART</code> is the part number or "epilogue"
 
:* <code>PART</code> is the part number or "epilogue"
 
:* <code>CHAPTER</code> is the chapter number; leave blank if <code>PART</code> is "epilogue"
 
:* <code>CHAPTER</code> is the chapter number; leave blank if <code>PART</code> is "epilogue"
   
 
;The Emperor's Soul {{t|tes ref}}
 
;The Emperor's Soul {{t|tes ref}}
: Looks like: <code><nowiki>{{tes ref|DAY}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{tes ref |DAY}}</nowiki></code>, where:
 
:* <code>DAY</code> is the day number, "prologue", or "epilogue"
 
:* <code>DAY</code> is the day number, "prologue", or "epilogue"
   
 
;Arcanum Unbounded {{t|au ref}}
 
;Arcanum Unbounded {{t|au ref}}
: Looks like: <code><nowiki>{{au ref|SYSTEM/STORY}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{au ref |SYSTEM/STORY}}</nowiki></code>, where:
 
:* <code>SYSTEM/STORY</code> is the planetary system or world name
 
:* <code>SYSTEM/STORY</code> is the planetary system or world name
 
:* If you're referencing a story postscript, <code>SYSTEM/STORY</code> is the full story name or [[:Template:B|abbreviation]]
 
:* If you're referencing a story postscript, <code>SYSTEM/STORY</code> is the full story name or [[:Template:B|abbreviation]]
Line 45: Line 45:
   
 
;General URL {{t|url ref}}
 
;General URL {{t|url ref}}
: Looks like: <code><nowiki>{{url ref|url=|text=|site=|date=}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{url ref |url= |text= |site= |date=}}</nowiki></code>, where:
 
:* <code>url=</code> should be followed with the link URL ("http://...")
 
:* <code>url=</code> should be followed with the link URL ("http://...")
 
:* <code>text=</code> should be followed with a description of the information
 
:* <code>text=</code> should be followed with a description of the information
Line 52: Line 52:
   
 
;17th Shard {{t|17s ref}}
 
;17th Shard {{t|17s ref}}
: Looks like: <code><nowiki>{{17s ref|TYPE|ID|DESCRIPTION|date=}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{17s ref |TYPE |ID |DESCRIPTION |date=}}</nowiki></code>, where:
 
:* <code>TYPE</code> is the type of content referenced: "post", "topic", "user", etc.
 
:* <code>TYPE</code> is the type of content referenced: "post", "topic", "user", etc.
 
:* <code>ID</code> is the last unique number in the link
 
:* <code>ID</code> is the last unique number in the link
Line 59: Line 59:
   
 
;Theoryland Interview Database {{t|qa ref}}
 
;Theoryland Interview Database {{t|qa ref}}
: Looks like: <code><nowiki>{{qa ref|INTERVIEW|QUESTION|DESCRIPTION|date=}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{qa ref| INTERVIEW |QUESTION |DESCRIPTION |date=}}</nowiki></code>, where:
 
:* <code>INTERVIEW</code> is the interview number--the first number in the link
 
:* <code>INTERVIEW</code> is the interview number--the first number in the link
 
:* <code>QUESTION</code> is the question number
 
:* <code>QUESTION</code> is the question number
Line 66: Line 66:
   
 
;Reddit {{t|reddit ref}}
 
;Reddit {{t|reddit ref}}
: Looks like: <code><nowiki>{{reddit ref|SUBREDDIT|POST|COMMENT|text=|date=}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{reddit ref |SUBREDDIT |POST |COMMENT |text= |date=}}</nowiki></code>, where:
 
:* <code>SUBREDDIT</code> is the subreddit name (ommit the "/r/")
 
:* <code>SUBREDDIT</code> is the subreddit name (ommit the "/r/")
 
:* <code>POST</code> is the alphanumeric ID of the post--the first number in the link
 
:* <code>POST</code> is the alphanumeric ID of the post--the first number in the link
Line 75: Line 75:
   
 
;Twitter {{t|tweet ref}}
 
;Twitter {{t|tweet ref}}
: Looks like: <code><nowiki>{{tweet ref|ID|DESCRIPTION|date=}}</nowiki></code>, where:
+
: Looks like: <code><nowiki>{{tweet ref |ID |DESCRIPTION |date=}}</nowiki></code>, where:
 
:* <code>ID</code> is the tweet ID number
 
:* <code>ID</code> is the tweet ID number
 
:* <code>DESCRIPTION</code> is a description of the information
 
:* <code>DESCRIPTION</code> is a description of the information
Line 89: Line 89:
 
If you're going use a particular reference multiple times, you may find '''named references''' useful. Just include the additional parameter <code>|name=</code> in the reference template. Whenever you want to reuse that reference, you can omit all the other parameters besides <code>|name=</code>.
 
If you're going use a particular reference multiple times, you may find '''named references''' useful. Just include the additional parameter <code>|name=</code> in the reference template. Whenever you want to reuse that reference, you can omit all the other parameters besides <code>|name=</code>.
   
For example, say you want to cite book X chapter 4. For the first reference use <code><nowiki>{{book ref|X|4|name=X4}}</nowiki></code>, and then for every other instance just use <code><nowiki>{{book ref|name=X4}}</nowiki></code>.
+
''Example:'' Say you want to cite book X chapter 4. For the first reference use <code><nowiki>{{book ref|X|4|name=X4}}</nowiki></code>, and then for every other instance just use <code><nowiki>{{book ref|name=X4}}</nowiki></code>.
   
 
In fact, you can ''really'' keep the article clean by putting long reference templates directly in the Notes section. Instead of <code><nowiki><references /></nowiki></code>, put all of your long citations (with names added) between <code><nowiki><references></nowiki></code> and <code><nowiki></references></nowiki></code> tags down in the Notes sectiom. Then you can call them out in the body of the article with the names alone!
 
In fact, you can ''really'' keep the article clean by putting long reference templates directly in the Notes section. Instead of <code><nowiki><references /></nowiki></code>, put all of your long citations (with names added) between <code><nowiki><references></nowiki></code> and <code><nowiki></references></nowiki></code> tags down in the Notes sectiom. Then you can call them out in the body of the article with the names alone!

Revision as of 15:07, 15 December 2016

It's important to provide references to the books or other source material so that facts can be confirmed and proven trustwothy. This is particularly true when a strong statement is being made, or when a fact is not well known. This page will tell you everything you need to know about citing references and making notes.

It's okay if you are unable to provide references. See the #Editorial Notations section below for other ways you can help.

Notes Section

Every page should have a Notes section at the very bottom. We want the references to appear there. This is done by including a <references /> tag first thing in the Notes section. For more on article structure, see Help:Guidelines#Article_Structure.

Reference Templates

To create references you will use a reference template. Templates are a useful trick that simplify the work involved. While not necessary to understand the basics, it may be helpful to take a look at the Help:Templates article before continuing.

A basic reference template looks like this: {{ref |text=This is a reference.}}. Notice that it's enclosed by double curly braces ({{}}). The template name comes first ("ref"), followed by parameters, all separated by vertical bars (|). Named parameters, like "text=" require the parameter name and equals sign along with your input, as shown above. Unnamed parameters (you'll see these below, in all caps) should be completely replaced by your input. When placed in the text of an article, it will be automatically rendered as a superscript, bracketed number: [1]. It links to the bottom of the page, where you'll see that same number along with the text:

  1. This is a reference.

There are a LOT of reference templates to choose from. The right one for the job depends on what the source is. Here are some of the most commonly used reference templates and the parameters they require. For a complete list of all reference templates see Category:Reference templates.

Books

For most books, you can use the general book template (listed first). However, some books use more specific templates because of the way they are structured. These templates will automatically generate links to the book's summary (or epigraphs) page.

General Book {{book ref}}
Looks like: {{book ref |BOOK |CHAPTER}}, where:
  • BOOK is the full book name or abbreviation
  • CHAPTER is the chapter number, "prologue", or "epilogue"
  • If you're referencing an interlude, include |i between the book and chapter parameters.
Epigraphs {{epigraph ref}}
Looks like: {{epigraph ref |BOOK |CHAPTER}}, where:
  • BOOK is the full book name or abbreviation
  • CHAPTER is the chapter number, "prologue", or "epilogue"
Mistborn: Secret History {{msh ref}}
Looks like: {{msh ref |PART |CHAPTER}}, where:
  • PART is the part number or "epilogue"
  • CHAPTER is the chapter number; leave blank if PART is "epilogue"
The Emperor's Soul {{tes ref}}
Looks like: {{tes ref |DAY}}, where:
  • DAY is the day number, "prologue", or "epilogue"
Arcanum Unbounded {{au ref}}
Looks like: {{au ref |SYSTEM/STORY}}, where:
  • SYSTEM/STORY is the planetary system or world name
  • If you're referencing a story postscript, SYSTEM/STORY is the full story name or abbreviation

Websites

A general URL ref is shown first, but use of the more specific templates is preferable.

General URL {{url ref}}
Looks like: {{url ref |url= |text= |site= |date=}}, where:
  • url= should be followed with the link URL ("http://...")
  • text= should be followed with a description of the information
  • site= should be followed with the name of the website
  • date= should be followed with the date of the information ("yyyy-mm-dd")
17th Shard {{17s ref}}
Looks like: {{17s ref |TYPE |ID |DESCRIPTION |date=}}, where:
  • TYPE is the type of content referenced: "post", "topic", "user", etc.
  • ID is the last unique number in the link
  • DESCRIPTION is a description of the information
  • date= should be followed with the date of the information ("yyyy-mm-dd")
Theoryland Interview Database {{qa ref}}
Looks like: {{qa ref| INTERVIEW |QUESTION |DESCRIPTION |date=}}, where:
  • INTERVIEW is the interview number--the first number in the link
  • QUESTION is the question number
  • DESCRIPTION is a description of the information
  • date= should be followed with the date of the information ("yyyy-mm-dd")
Reddit {{reddit ref}}
Looks like: {{reddit ref |SUBREDDIT |POST |COMMENT |text= |date=}}, where:
  • SUBREDDIT is the subreddit name (ommit the "/r/")
  • POST is the alphanumeric ID of the post--the first number in the link
  • COMMENT is the alphanumeric ID of the comment--the second number in the link
  • text= should be followed with a description of the information
  • date= should be followed with the date of the information ("yyyy-mm-dd")
  • If linking to a post instead of a particular comment, ommit the |COMMENT parameter
Twitter {{tweet ref}}
Looks like: {{tweet ref |ID |DESCRIPTION |date=}}, where:
  • ID is the tweet ID number
  • DESCRIPTION is a description of the information
  • date= should be followed with the date of the information ("yyyy-mm-dd")

Footnotes

Sometimes you may wish to provide a textual footnote. It's not a reference to some source--just a small note of clarification that maybe doesn't belong in the body of the article. To make a footnote, use the basic reference template described earlier on this page.

Additional Parameters

Most reference templates can make use of additional parameters not mentioned above. Visit the template pages to learn about these other parameter options, if needed.

Named References

If you're going use a particular reference multiple times, you may find named references useful. Just include the additional parameter |name= in the reference template. Whenever you want to reuse that reference, you can omit all the other parameters besides |name=.

Example: Say you want to cite book X chapter 4. For the first reference use {{book ref|X|4|name=X4}}, and then for every other instance just use {{book ref|name=X4}}.

In fact, you can really keep the article clean by putting long reference templates directly in the Notes section. Instead of <references />, put all of your long citations (with names added) between <references> and </references> tags down in the Notes sectiom. Then you can call them out in the body of the article with the names alone!

For example:

The Coppermind wiki is awesome.{{url ref|name=coppermind}} 

And here's another reference to that great website.{{url ref|name=coppermind}} 

== Notes ==
<references>
{{url ref|url=http://www.coppermind.net|text=A cool place.|site=Coppermind|date=2016-1-1|name=coppermind}}
</references>

The Coppermind wiki is awesome.[1]

And here's another reference to that great website.[1]

Notes

  1. a b [{{{url}}} {{{text}}}]
    — {{{site}}} ERROR: {{{url}}} cannot be hashed Cite error: Invalid <ref> tag; name "coppermind" defined multiple times with different content

Reference Groups

Regular citations always belong in the Notes section, but there may be occasion to list certain references higher up in the article. Particularly in the case of footnotes. This is accomplished with reference groups.

Include the additional parameter |group= in the reference templates that you want placed in a special location. In the location you want these references listed, add the same parameter and input to the <references /> tag.

It looks like this:

The Coppermind wiki is awesome.{{ref|text=It really is.|group=note}} You should visit.{{ref|text=A normal reference.}} 

<references group=note />

== Notes ==
<references />

The Coppermind wiki is awesome.[note 1] You should visit.[1]

  1. It really is.

Notes

  1. A normal reference.

Editorial Notations

Not sure about a particular reference? You can still help us out by identifying statements that may need some attention. Just insert the following templates, exactly as shown, after the statement.

Request Citation {{cite}}
{{cite}} acts as a placeholder for future citation. It let's others know that the preceding fact needs a reference.
Request Clarification {{clarify}}
{{clarify}} lets others know that the preceding statement is unclear and needs some work.
Disputed Warning {{disputed}}
{{disputed}} warns the reader that the preceding information may be incorrect or unverified. If you see something that doesn't sound correct (especially if it has no reference), use this.