Difference between revisions of "Help:References"

Jump to navigation Jump to search
m
Protected "Help:References": Guideline/policy page ([Edit=Allow only keepers] (indefinite) [Move=Allow only keepers] (indefinite))
m
m (Protected "Help:References": Guideline/policy page ([Edit=Allow only keepers] (indefinite) [Move=Allow only keepers] (indefinite)))
 
(7 intermediate revisions by 4 users not shown)
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 for more background on how templates work.
 
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> and <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]].
 
;General Book {{t|book ref}}
: Looks like: <code><nowiki>{{book ref |BOOK |CHAPTER}}</nowiki></code>, where:
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
:* If you're referencing an interlude, include <code><nowiki>|i</nowiki></code> between the book and chapter parameters.
:* For the [[Stormlight Archive]] prelude and all [[Ars Arcanum|Ars Arcana]] use <code><nowiki>part=prelude</nowiki></code> and <code><nowiki>part=ars</nowiki></code> respectively in place of the chapter number.
 
;EpigraphsEpigraph {{t|epigraph ref}}
: Looks like: <code><nowiki>{{epigraph ref |BOOK |CHAPTER}}</nowiki></code>, where:
:* <code>BOOK</code> is the full book name or [[:Template:B|abbreviation]]
:* <code>CHAPTER</code> is the chapter number, "prologue", or "epilogue"
 
;Mistborn<nowiki>:</nowiki> Secret History {{t|msh ref}}
: Looks like: <code><nowiki>{{msh ref |PART |CHAPTER}}</nowiki></code>, where:
:* <code>PART</code> is the part number or "epilogue"
:* <code>CHAPTER</code> is the chapter number; leave blank if <code>PART</code> is "epilogue"
 
;The Emperor's Soul {{t|tes ref}}
: Looks like: <code><nowiki>{{tes ref |DAY}}</nowiki></code>, where:
:* <code>DAY</code> is the day number, "prologue", or "epilogue"
 
;Arcanum Unbounded {{t|au ref}}
: Looks like: <code><nowiki>{{au ref |SYSTEM/STORY}}</nowiki></code>, where:
:* <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]]
 
;General URL {{t|url ref}}
: 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>text=</code> should be followed with a description of the information
 
;Arcanum {{t|wob ref}}
: Looks like: <code><nowiki>{{wob ref |ENTRY |EVENT |date=}}</nowiki></code>, where:
:* <code>ENTRY</code> is the entry number--the number following "#e" in the url
:* Note: After saving your edits, this will generate a red link for the reference in the Notes section. Following that link will allow you to create a page with the reference's metadata.
:* <code>EVENT</code> is the title of the event
:* <code>date=</code> should be followed with the date of the information ("yyyy-mm-dd")
 
;Others
;17th Shard {{t|17s ref}}
: Arcanum is the preferred source when possible, but additional url references include:
: Looks like: <code><nowiki>{{17s ref |TYPE |ID |DESCRIPTION |date=}}</nowiki></code>, where:
:* '''Brandon's Website''' {{t|Bws ref}}}
:* <code>TYPE</code> is the type of content referenced: "post", "topic", "user", etc.
;:* '''17th Shard''' {{t|17s ref}}
:* <code>ID</code> is the last unique number in the link
:* '''Reddit''' {{t|Reddit ref}}
:* <code>DESCRIPTION</code> is a description of the information
:* '''Twitter''' {{t|Tweet ref}}
:* <code>date=</code> should be followed with the date of the information ("yyyy-mm-dd")
:* '''Tor''' {{t|Tor ref}}
:* '''Wikipedia''' {{t|Wp ref}}
 
=== Files ===
;Theoryland Interview Database {{t|qa ref}}
You may wish to reference a file hosted by Coppermind, such as artwork or a map. For general files use <code><nowiki>{{file ref}}</nowiki></code>; for maps we prefer use of <code><nowiki>{{map ref}}</nowiki></code>.
: 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>QUESTION</code> is the question number
:* <code>DESCRIPTION</code> is a description of the information
:* <code>date=</code> should be followed with the date of the information ("yyyy-mm-dd")
 
;RedditGeneral File {{t|redditfile ref}}
: Looks like: <code><nowiki>{{redditfile ref |SUBREDDIT |POST |COMMENT |text= FILE|date=DESCRIPTION}}</nowiki></code>, where:
:* <code>SUBREDDITFILE</code> is the subredditfile name, (ommitincluding the "/r/")extension
:* <code>POSTDESCRIPTION</code> is thea alphanumericbrief IDdescription of thewhat post--the firstfile number in the permalinkis
:* <code>COMMENT</code> is the alphanumeric ID of the comment--the second number in the permalink
:* <code>text=</code> should be followed with a description of the information
:* <code>date=</code> should be followed with the date of the information ("yyyy-mm-dd")
:* If linking to a post instead of a particular comment, ommit the <code>|COMMENT</code> parameter
 
;TwitterMap {{t|tweetmap ref}}
: Looks like: <code><nowiki>{{tweetmap ref |ID |DESCRIPTION |date=MAP}}</nowiki></code>, where:
:* <code>IDMAP</code> is the tweet[[:Template:Map|map ID numbername]]
:* Append an optional <code><nowiki>|DESCRIPTION</nowiki></code> isparameter aif descriptionthe wording of the informationreference is awkward.
:* <code>date=</code> should be followed with the date of the information ("yyyy-mm-dd")
 
=== Footnotes ===
 
== Named References ==
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 canuse the basic {{t|ref}} template and omit all the other parameters besides <code>|name=</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 section. Then you can call them out in the body of the article with the names alone!
| width=50%|
<pre>
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-101-101|name=coppermind}}
</references>
</pre>
|
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-101-101|name=coppermind}}
</references>
|}

Navigation menu