Help:Index/Formatting/References: Difference between revisions
imported>John R. Brews mNo edit summary |
imported>John R. Brews (→Implementation: remove spaces interfering with copy & paste) |
||
(57 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
''See also'' [[CZ:List-defined references]] ''and'' [[CZ:Citation templates]] | ''See also'' [[CZ:List-defined references]] ''and'' [[CZ:Citation templates]] | ||
{{Image|References section.png|right| | {{Image|References section.png|right|475px|References section at bottom of an article (adapted from [[Catalytic_reforming#References|Catalytic reforming]]).}} | ||
{{TOC|right}} | {{TOC|right}} | ||
This article is about formatting '''embedded inline references''' (also called '''notes''' or '''footnotes''') in an article. They may provide sources where a reader can find discussion in more detail, or from a different background, or ramifications of the topic the article has not explored. Or, they may corroborate a specific word, statement, paragraph or even sub-section of an article by providing the readers of the article with the details of a book, journal, newspaper report or online website page that substantiates and validates the word, statement, paragraph or sub-section. The location of the word, statement, paragraph or subsection being referenced is marked with a superscript, bracketed number (colored blue) like this for a single reference<font color=blue><sup>[1]</sup></font> or this<font color=blue><sup>[2]</sup></font><font color=blue><sup>[3]</sup></font> for multiple references. All Citizendium article having a status of Developed or Approved should have a list of references in a "References" or "Footnotes" section at the end of the article. | This article is about formatting '''embedded inline references''' (also called '''notes''' or '''footnotes''') in an article. They may provide sources where a reader can find discussion in more detail, or from a different background, or ramifications of the topic the article has not explored. Or, they may corroborate a specific word, statement, paragraph or even sub-section of an article by providing the readers of the article with the details of a book, journal, newspaper report or online website page that substantiates and validates the word, statement, paragraph or sub-section. The location of the word, statement, paragraph or subsection being referenced is marked with a superscript, bracketed number (colored blue) like this for a single reference<font color=blue><sup>[1]</sup></font> or this<font color=blue><sup>[2]</sup></font><font color=blue><sup>[3]</sup></font> for multiple references. All Citizendium article having a status of Developed or Approved should have a list of references in a "References" or "Footnotes" section at the end of the article. | ||
Line 10: | Line 10: | ||
In contrast to notes directed at specific content, some authors use the word "references" to mean listing the details of sources (such as books or journals) that provided information, corroboration or substantiation of the article ''as a whole'' rather than any specific parts of the article. Such lists are placed at the end of the article with no indication as to what specific part of the article each listed source applies. Within the context of Citizendium, in most cases, such non-specific references are best placed in the "Bibliography" subpage rather than at the end of the article. If such reference lists include hyperlinks to online website pages, then they are best included in the "External Links" subpage. In some few cases, an article may benefit by having a short list of about 3 books in a section entitled "Further reading" in addition to the "References" or "Footnotes" section and the "Bibliography" subpage. | In contrast to notes directed at specific content, some authors use the word "references" to mean listing the details of sources (such as books or journals) that provided information, corroboration or substantiation of the article ''as a whole'' rather than any specific parts of the article. Such lists are placed at the end of the article with no indication as to what specific part of the article each listed source applies. Within the context of Citizendium, in most cases, such non-specific references are best placed in the "Bibliography" subpage rather than at the end of the article. If such reference lists include hyperlinks to online website pages, then they are best included in the "External Links" subpage. In some few cases, an article may benefit by having a short list of about 3 books in a section entitled "Further reading" in addition to the "References" or "Footnotes" section and the "Bibliography" subpage. | ||
Some authors also use embedded inline hyperlinks like this <font color=green>[ | Some authors also use embedded inline hyperlinks like this <font color=green>[<nowiki> http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed</nowiki>]</font> as references. Such references should '''''<u>not</u>''''' be used because they display a number in the text, like this [http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed], which will be confused with the numbered footnotes in the ''Reference section'' at the end of the article. If the ''url'' is followed by a space and a description as in <font color=green><nowiki>[http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed</nowiki> '''Pentane: C<sub>8</sub>H<sub>18</sub>''']</font>, only the words will show in the text: [http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed Pentane: C<sub>8</sub>H<sub>18</sub>]. The writer must decide whether to place such links on the ''External links'' subpage, whether to use an inline link as just described, or whether to use a true numbered footnote with the <nowiki>{{cite web...}}</nowiki> template found at [[CZ:Citation templates]], a more appropriate choice where the link is meant to support a specific item in the text. | ||
No rules or guidance about references are cast in stone and must absolutely be followed. However, following the methods and guidance in this article will result in consistency from one article to another and, for that reason, it is strongly recommended they be followed. | No rules or guidance about references are cast in stone and must absolutely be followed. However, following the methods and guidance in this article will result in consistency from one article to another and, for that reason, it is strongly recommended they be followed. | ||
Line 20: | Line 20: | ||
We must use reliable, credible sources such as published books, professional journals, mainstream press report , and reliable web sites. Blogs, MySpace, YouTube, fan sites and extreme minority material are not usually acceptable, nor are your own unpublished essays or research. Wikipedia articles or other Citizendium articles are not reliable sources. | We must use reliable, credible sources such as published books, professional journals, mainstream press report , and reliable web sites. Blogs, MySpace, YouTube, fan sites and extreme minority material are not usually acceptable, nor are your own unpublished essays or research. Wikipedia articles or other Citizendium articles are not reliable sources. | ||
==Inserting | ==Inserting embedded inline references== | ||
=== ''Single insertion of a reference:'' === | === ''Single insertion of a reference:'' === | ||
For the single insertion of a reference, | For the single insertion of a reference, <font color=green><nowiki><ref>{{cite </nowiki>''xxx'' <nowiki> |...}}</ref></nowiki></font> is inserted on the CZ article's edit page at the location of the reference, where ''<font color=green>xxx</font>'' is ''book'', ''journal'' or ''web''. This insertion will display a number in the text<font color=blue><sup>[1]</sup></font> linked to the corresponding numbered footnote in the ''References'' section. | ||
For example, insertion at a location in the text of: | For example, insertion at a location in the text of: | ||
::{|style="background: | ::{|style="background: #fffaf5; color: green" width=700 | ||
|<nowiki><ref></nowiki>  <nowiki>{{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}}</nowiki>  <nowiki></ref></nowiki> | |'''<nowiki><ref></nowiki>'''  <nowiki>{{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}}</nowiki>  '''<nowiki></ref></nowiki>''' | ||
|} | |} | ||
results in the | results in a footnote in the ''References'' section as follows: | ||
::1.<font color=blue>↑</font> {{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}} | ::1.<font color=blue>↑</font> {{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}} | ||
The writer has flexibility in how much detail is provided to the template. | The writer has flexibility in how much detail is provided to the template. It looks like a lot of input, but most of it is just copy and paste. | ||
=== ''Insertion of the same reference more than once:'' === | === ''Insertion of the same reference more than once:'' === | ||
Line 42: | Line 42: | ||
When the same reference is used several times, the reference tag <nowiki><ref></nowiki> is expanded to include a one-word name for the reference {{nowrap|<nowiki><ref name=xxxxx></nowiki>}}, where ''xxxx'' is an arbitrary choice by the writer, but may not include punctuation other than underscores '_'. This one-word name insertion is placed on the CZ article's edit page at the first insertion point of the reference: | When the same reference is used several times, the reference tag <nowiki><ref></nowiki> is expanded to include a one-word name for the reference {{nowrap|<nowiki><ref name=xxxxx></nowiki>}}, where ''xxxx'' is an arbitrary choice by the writer, but may not include punctuation other than underscores '_'. This one-word name insertion is placed on the CZ article's edit page at the first insertion point of the reference: | ||
:{|style="background: | :{|style="background: #fffaf5; color: green" width=95% | ||
|<nowiki><ref name=Speight></nowiki> | |'''<nowiki><ref name=Speight></nowiki>''' | ||
|- | |- | ||
|<nowiki>{{cite book | |<nowiki>{{cite book | ||
|author=J. G. Speight | |author=J. G. Speight | ||
|title=The Chemistry and Technology of Petroleum | |title=The Chemistry and Technology of Petroleum | ||
|pages=pp. 465 ''ff'' | |||
|chapter=Chapter 16: Distillation | |||
|edition=4th Edition | |edition=4th Edition | ||
|publisher=CRC Press | |publisher=CRC Press | ||
|url=http://books.google.com/books?id=ymL2S9RWzx4C& | |url=http://books.google.com/books?id=ymL2S9RWzx4C&pg=PA465 | ||
|year=2006 | |year=2006 | ||
| | |isbn= 0-8493-9067-2}}</nowiki> | ||
|- | |- | ||
|<nowiki></ref></nowiki>''' | |'''<nowiki></ref></nowiki>''' | ||
|} | |} | ||
where spaces are introduced just to make reading easier. At the second insertion point of the reference the insertion is made: | where spaces are introduced just to make reading easier. At the second insertion point of the reference the insertion is made: | ||
:::{|style="background: | :::{|style="background: #fffaf5; color: green" width=40% | ||
|<nowiki><ref name=Speight/></nowiki> | |<nowiki><ref name=Speight/></nowiki> | ||
|} | |} | ||
And at the third insertion point of the reference: | Notice the forward slash. And at the third insertion point of the reference: | ||
:::{|style="background: | :::{|style="background: #fffaf5; color: green" width=40% | ||
|<nowiki><ref name=Speight/></nowiki> | |<nowiki><ref name=Speight/></nowiki> | ||
|} | |} | ||
Line 70: | Line 72: | ||
and so forth, for further insertion points. With these three inserts in a line of text, the result is: | and so forth, for further insertion points. With these three inserts in a line of text, the result is: | ||
:{|style="background: | :{|style="background: #FFFDF5; " width=80% | ||
|- | |- | ||
| Petroleum is important.<font color=blue><sup>[1]</sup></font> It is used in plastics,<font color=blue><sup>[1]</sup></font> and for fuel.<font color=blue><sup>[1]</sup></font> | | Petroleum is important.<font color=blue><sup>[1]</sup></font> It is used in plastics,<font color=blue><sup>[1]</sup></font> and for fuel.<font color=blue><sup>[1]</sup></font> | ||
Line 78: | Line 80: | ||
|'''References''' | |'''References''' | ||
|- | |- | ||
|  1. <font color=blue>↑<sup> 1.0 1.1 1.2 </sup></font> {{cite book|author=J. G. Speight|title=The Chemistry and Technology of Petroleum|edition=4th Edition|publisher=CRC Press |url=http://books.google.com/books?id=ymL2S9RWzx4C& | |  1. <font color=blue>↑<sup> 1.0 1.1 1.2 </sup></font> {{cite book|author=J. G. Speight |title=The Chemistry and Technology of Petroleum |pages=pp. 465 ''ff'' |chapter=Chapter 16: Distillation|edition=4th Edition |publisher=CRC Press |url=http://books.google.com/books?id=ymL2S9RWzx4C&pg=PA465 |year=2006|isbn= 0-8493-9067-2}} | ||
|} | |} | ||
The ''References'' section at the end of the CZ article is discussed next. | The ''References'' section at the end of the CZ article is discussed next. | ||
== | == The ''References'' or ''Footnotes'' list == | ||
On the edit page of the CZ article, place either of these at the bottom of an article to produce a references or footnotes section: | On the edit page of the CZ article, place either of these at the bottom of an article to produce a references or footnotes section: | ||
::{|style="background: | ::{|style="background: #fffaf5; color: green" width=400 | ||
|- | |- | ||
|<nowiki>==References==</nowiki> || <nowiki>==Footnotes==</nowiki> | |<nowiki>==References==</nowiki> || <nowiki>==Footnotes==</nowiki> | ||
Line 95: | Line 97: | ||
|} | |} | ||
Either of the above formats produces a references or footnotes section at the bottom of the CZ article's main page containing a list such as just below | Either of the above formats produces a references or footnotes section at the bottom of the CZ article's main page containing a list such as shown in the boxed example just below. The item numbers in the list are generated automatically. | ||
{{reflist}} | {{reflist}} | ||
In some cases, when there are a large number of references and many of them are fairly short, space can be conserved by using '''<nowiki>{{reflist|2}}</nowiki>''', instead of '''<nowiki>{{reflist}}</nowiki>''', which splits the reference list into two columns. | In some cases, when there are a large number of references and many of them are fairly short, space can be conserved by using '''<nowiki>{{reflist|2}}</nowiki>''', instead of '''<nowiki>{{reflist}}</nowiki>''', which splits the reference list into two columns. | ||
== Where to place | ==Putting it together== | ||
An example shows how the insertion points and the reference list interact. | |||
=== ''Where to place insertion points'' === | |||
The correct placement of the reference insertions is illustrated by a realistic example: | The correct placement of the reference insertions is illustrated by a realistic example: | ||
{|style="background: | :{|style="background: #FFFDF5; " width=90% | ||
|The crude oil distillation unit is the first processing unit in a petroleum crude oil refinery.<ref name=Speight> | |The crude oil distillation unit is the first processing unit in a petroleum crude oil refinery.<ref name=Speight> | ||
{{cite book|author=J. G. Speight|title=The Chemistry and Technology of Petroleum|edition=4th Edition|publisher=CRC Press |url=http://books.google.com/books?id=ymL2S9RWzx4C& | {{cite book|author=J. G. Speight|title=The Chemistry and Technology of Petroleum |pages=pp. 465 ''ff'' | ||
|chapter=Chapter 16: Distillation|edition=4th Edition |publisher=CRC Press |url=http://books.google.com/books?id=ymL2S9RWzx4C&pg=PA465|year=2006|isbn= 0-8493-9067-2}} | |||
</ref> It separates the crude oil into petroleum naphtha<ref name=Speight/> and other intermediate refinery products.<ref name=Speight/> Those intermediate products are subsequently further processed in other units so as to produce sales products such as gasoline,<ref name=Speight/><ref> | </ref> It separates the crude oil into petroleum naphtha<ref name=Speight/> and other intermediate refinery products.<ref name=Speight/> Those intermediate products are subsequently further processed in other units so as to produce sales products such as gasoline,<ref name=Speight/><ref> | ||
Line 116: | Line 122: | ||
</ref> diesel oil, fuel oils and asphalt. | </ref> diesel oil, fuel oils and asphalt. | ||
|- | |- | ||
| | |  | ||
|- | |- | ||
|'''References''' | |'''References''' | ||
|- | |- | ||
| | |{{reflist|close=1}} | ||
|} | |} | ||
Line 130: | Line 136: | ||
* Two or more references at the same point of insertion are placed immediately next to each other with no space between the references. | * Two or more references at the same point of insertion are placed immediately next to each other with no space between the references. | ||
== How to use the links == | === ''How to use the links'' === | ||
* Clicking on the superscript footnote number in the main text <font color=blue><sup>1, 2, ...</sup></font> causes the screen display to scroll down far enough to display that reference in the ''References'' list. | * Clicking on the superscript footnote number in the main text <font color=blue><sup>[1], [2], ...</sup></font> causes the screen display to scroll down far enough to display that reference in the ''References'' list. | ||
* Clicking on the blue superscript <font color=blue><sup>1.0</sup></font> in the ''References'' list causes the screen display to scroll back up to the point where the first reference to Speight's book was inserted. Clicking on the blue superscript <font color=blue><sup>1.1</sup></font> causes the screen display to scroll back up to the point where the second reference to Speight's book was inserted. Clicking on the blue superscript <font color=blue><sup>1.2</sup></font> causes the screen display to scroll back up to the point where the third reference to Speight's was inserted ... and so forth. | * Clicking on the blue superscript <font color=blue><sup>1.0</sup></font> in the ''References'' list causes the screen display to scroll back up to the point where the first reference to Speight's book was inserted. Clicking on the blue superscript <font color=blue><sup>1.1</sup></font> causes the screen display to scroll back up to the point where the second reference to Speight's book was inserted. Clicking on the blue superscript <font color=blue><sup>1.2</sup></font> causes the screen display to scroll back up to the point where the third reference to Speight's was inserted ... and so forth. | ||
* Clicking on any up arrow (<font color=blue>↑</font>) in the reference list that has no associated superscripts causes the screen display to scroll back up to the point where that single-use references was inserted. | * Clicking on any up arrow (<font color=blue>↑</font>) in the reference list that has no associated superscripts causes the screen display to scroll back up to the point where that single-use references was inserted. | ||
Try it out! | Try it out with the boxed example above! | ||
===''Implementation''=== | |||
Of course, one just can type in the information ''<font color=green>xxx</font>'' in <font color=green><nowiki><ref name = MyRefName></nowiki> ''xxx'' <nowiki></ref></nowiki></font>, but an alternative is to copy and paste one of the listings below and fill it in by copying and pasting the information. | |||
{{col-begin|width=90%}} | |||
{{col-break|width=20%}} | |||
{{tl|cite book}}   | |||
<br/><font color=green>°°°°°°°°°°°°°°°°°°°°</font> | |||
<br/><nowiki>{{</nowiki>cite book | |||
<br/><nowiki>|</nowiki> author = | |||
<br/><nowiki>|</nowiki> editor = | |||
<br/><nowiki>|</nowiki> title = | |||
<br/><nowiki>|</nowiki> chapter = | |||
<br/><nowiki>|</nowiki> edition = | |||
<br/><nowiki>|</nowiki> publisher = | |||
<br/><nowiki>|</nowiki> year = | |||
<br/><nowiki>|</nowiki> pages = | |||
<br/><nowiki>|</nowiki> url = | |||
<br/><nowiki>|</nowiki> isbn = | |||
<br/>}} | |||
{{col-break|width=20%}} | |||
{{tl|cite journal}} | |||
<br/><font color=green>°°°°°°°°°°°°°°°°°°°°</font> | |||
<br/><nowiki>{{</nowiki>cite journal | |||
<br/><nowiki>|</nowiki> author= | |||
<br/><nowiki>|</nowiki> title = | |||
<br/><nowiki>|</nowiki> journal = | |||
<br/><nowiki>|</nowiki> volume = | |||
<br/><nowiki>|</nowiki> issue = | |||
<br/><nowiki>|</nowiki> pages = | |||
<br/><nowiki>|</nowiki> date = | |||
<br/><nowiki>|</nowiki> url = | |||
<br/><nowiki>|</nowiki> doi = | |||
<br/>}} | |||
{{col-break|width=20%}} | |||
{{tl|cite web}} | |||
<br/><font color=green>°°°°°°°°°°°°°°°°°°°°</font> | |||
<br/>{{cite web | |||
<br/><nowiki>|</nowiki> author = | |||
<br/><nowiki>|</nowiki> title = | |||
<br/><nowiki>|</nowiki> work = | |||
<br/><nowiki>|</nowiki> publisher = | |||
<br/><nowiki>|</nowiki> date = | |||
<br/><nowiki>|</nowiki> url = | |||
<br/><nowiki>|</nowiki> doi = | |||
<br/><nowiki>|</nowiki> accessdate = | |||
<br/>}} | |||
{{col-end}} | |||
One fills in the fields one wants to use, and leaves the rest blank. Other fields can be found in [[CZ:Citation templates]]. More details and some alternatives to using templates are descirbed next. | |||
== Books, journals and the web== | |||
The following examples do not cover every method of referencing books and articles. But they do provide enough information so that beginners can produce satisfactory references. | A number of approaches are available for the text between the '''<nowiki><ref></nowiki> – <nowiki></ref></nowiki>''' tags. The following examples do not cover every method of referencing books and articles. But they do provide enough information so that beginners can produce satisfactory references. Quite complicated templates are available as well, and it is probably best for new authors to use simpler approaches. Some examples are given below using these templates, and experienced writers may wish to explore all their features described at {{tl|cite book}} or {{tl|cite journal}}, or {{tl|cite web}}. | ||
===''Referencing books''=== | ===''Referencing books''=== | ||
This is example template of a simple book reference that provides the needed essentials: | This is example template of a simple book reference that provides the needed essentials: | ||
:{|style="background: #fffaf5; color: green" width=95% | |||
|'''<nowiki><ref></nowiki>''' <nowiki>{{cite book|author=|title=|edition=|publisher=|year=|pages=|isbn= XXXX }}</nowiki>'''<nowiki></ref></nowiki>''' | |||
|} | |||
and this is how it would appear on a CZ article's edit page: | and this is how it would appear on a CZ article's edit page: | ||
:{|style="background: #fffaf5; color: green" width=95% | |||
|'''<nowiki><ref></nowiki>'''<nowiki>{{cite book|author=Thomas Paine |title=The Age of Reason |edition=Republication of 1794 edition |publisher=Forgotten Books |year=2008 |isbn=1-60620-853-5}}</nowiki>'''<nowiki></ref></nowiki>''' | |||
|} | |||
which automatically produces this in the references list at the bottom of a CZ article's main page: | |||
: | :{{cite book|author=Thomas Paine |title=The Age of Reason|edition=Republication of 1794 edition |publisher=Forgotten Books|year=2008|isbn=1-60620-853-5}}. | ||
If the edition is unknown, then simply leave it blank; if a ''url'' is discovered, put it in. Thus on a CZ article's edit page: | |||
: | :{|style="background: #fffaf5; color: green" width=95% | ||
|'''<nowiki><ref></nowiki>'''<nowiki>{{cite book|author=Thomas Paine |title=The Age of Reason |publisher=Forgotten Books |year=2008 |isbn=1-60620-853-5 |url=http://books.google.com/books/p/pub-4297897631756504?id=fFMMMmQk1CsC&printsec=frontcover&dq=Thomas+Paine&cd=1#v=onepage&q&f=false}}</nowiki>'''<nowiki></ref></nowiki>''' | |||
|} | |||
and in the ''References'' section: | |||
: | :{{cite book|author=Thomas Paine |title=The Age of Reason |publisher=Forgotten Books |year=2008 |isbn=1-60620-853-5 |url=http://books.google.com/books/p/pub-4297897631756504?id=fFMMMmQk1CsC&printsec=frontcover&dq=Thomas+Paine&cd=1#v=onepage&q&f=false}} | ||
Here is a somewhat more elaborate example in vertical format (the order does not matter; the template sorts the results): | Here is a somewhat more elaborate example in vertical format (the order does not matter; the template sorts the results): | ||
:{|style="background: #fffaf5; color: green" width=75% | |||
|'''<nowiki><ref name=Halmos>{{</nowiki>''' cite book | |||
|- | |||
|<nowiki>|title=Naive set theory </nowiki> | |||
|- | |||
|<nowiki>|author=Paul Richard Halmos </nowiki> | |||
|- | |||
|<nowiki>|chapter=Section 9: Families </nowiki> | |||
|- | |||
|<nowiki>|url=<nowiki>http://books.google.com/books?id=x6cZBQ9qtgoC&pg=PA34</nowiki> | |||
|- | |||
|<nowiki>|pages=pp. 34 </nowiki>''ff'' | |||
|- | |||
|<nowiki>|isbn= 0387900926</nowiki> | |||
|- | |||
|<nowiki>|publisher=Springer </nowiki> | |||
|- | |||
|<nowiki>|year=1998 </nowiki> | |||
|- | |||
|<nowiki>|edition=Reprint of 1960 ed</nowiki> '''<nowiki>}}</ref></nowiki>''' | |||
|- | |||
|} | |||
A single-line format works just as well. This insertion in the text of the article results in an entry at the <nowiki>{{Reflist}}</nowiki> location: | A single-line format works just as well. This insertion in the text of the article results in an entry at the <nowiki>{{Reflist}}</nowiki> location: | ||
Line 182: | Line 250: | ||
|url=http://books.google.com/books?id=x6cZBQ9qtgoC&pg=PA34 | |url=http://books.google.com/books?id=x6cZBQ9qtgoC&pg=PA34 | ||
|pages=pp. 34 ''ff'' | |pages=pp. 34 ''ff'' | ||
|isbn= | |isbn= 0387900926 | ||
|publisher=Springer | |publisher=Springer | ||
|year=1998 | |year=1998 | ||
|edition=Reprint of 1960 ed }} | |edition=Reprint of 1960 ed }} | ||
In this example, a link to [http://books.google.com/advanced_book_search Google books] is provided. This link is truncated at the page number, which makes the ''url'' shorter at the cost of eliminating the highlighting of the search terms in the retrieved page. Because the reference has been named, it can be referred to again somewhere else in the article using the insertion in the text <nowiki><ref name=Halmos/></nowiki> with a forward slash. | In this example, a link to [http://books.google.com/advanced_book_search Google books] is provided. This link is truncated at the page number, which makes the ''url'' shorter at the cost of eliminating the highlighting of the search terms in the retrieved page. Because the reference has been named, it can be referred to again somewhere else in the article using the insertion in the text <font color=green>{{nowrap|<nowiki><ref name=Halmos/></nowiki>}}</font> with a forward slash. As with all these templates, the writer has the flexibility to cherry-pick which entries to include, and most of the input is copy and paste. | ||
=== ''Referencing journals'' === | === ''Referencing journals'' === | ||
There exist a huge number of formats for citing journal articles, and to obtain consistency across CZ it seems reasonable here to follow the practice implemented in the template {{tl|cite journal}}. It includes the following information: the author's name; followed by the year in parenthesis and a period; the article title in quotation marks, also followed by a period; the name of the journal in italic font, and not followed by a period; the journal's volume number in bold font; followed by the issue number in plain font (not bold and not italic) in parentheses; followed by the pages of the article in plain font. Below is an example of how this recipe appears upon a CZ article's edit page: | |||
:{|style="background: #fffaf5; color: green" width=95% | |||
|'''<nowiki><ref></nowiki>''' James A. Bierlein, Webster B. Kay (1953). "Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide." ''Industrial Engineering & Chemistry'' '''45'''(3): 618-624 '''<nowiki></ref></nowiki>''' | |||
|} | |||
which produces the following entry in the ''References'' list at the bottom of a CZ article's main page: | |||
: | :1. <font color=blue>↑ </font> James A. Bierlein, Webster B. Kay (1953). "Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide." ''Industrial Engineering & Chemistry'' '''45'''(3): 618-624 | ||
Writers used to other formats will have to be careful if they are to be consistent with this specific style guide: their habits may take over and lead to formats that vary in order, font and punctuation. It requires no attention to a style guide if one uses the {{tl|cite journal}} template found at [[CZ: Citation templates]]: | |||
: | :{|style="background: #fffaf5; color: green" width=75% | ||
|'''<nowiki><ref>{{</nowiki>''' cite journal | |||
|- | |||
|<nowiki>|author=James A. Bierlein, Webster B. Kay</nowiki> | |||
|- | |||
|<nowiki>|title=Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide </nowiki> | |||
|- | |||
|<nowiki>|journal=Ind. Eng. Chem. </nowiki> | |||
|- | |||
|<nowiki>|volume=45 </nowiki> | |||
|- | |||
|<nowiki>|issue= 3 </nowiki> | |||
|- | |||
|<nowiki>|year=1953 </nowiki> | |||
|- | |||
|<nowiki>|pages=618–624</nowiki> | |||
|- | |||
|<nowiki>|doi=10.1021/ie50519a043 </nowiki> | |||
|- | |||
|<nowiki>|url=<nowiki>http://pubs.acs.org/doi/abs/10.1021/ie50519a043</nowiki>'''}}''' | |||
|- | |||
|'''</ref>''' | |||
|} | |||
which may be strung out in a single line, if so desired. Regardless of the order of the items, the template produces an entry using a <u>standardized format</u> in the ''References'' list at the bottom of a CZ article's main page, namely: | |||
: | :1. <font color=blue>↑ </font>{{cite journal |author=James A. Bierlein, Webster B. Kay |title=Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide |journal=Ind. Eng. Chem. |volume=45 |issue= 3 |year= 1953 |pages=618–624 |doi=10.1021/ie50519a043 |url=http://pubs.acs.org/doi/abs/10.1021/ie50519a043}} | ||
This entry also is likely to be more complete (as it is here) because the template suggests useful information to the writer that may prove helpful to a reader. The ''doi'' is the [[digital object identifier]] for the document, not available for some older documents. | |||
===''Referencing online website pages''=== | ===''Referencing online website pages''=== | ||
The simplest correct way to reference material from an online website page is to start with square bracket, followed by the url of the website page, followed by a single space, followed by a title for the material and ended with another square bracket. For example, enter this on the CZ article's edit page: | The simplest correct way to reference material from an online website page is to start with square bracket, followed by the url of the website page, followed by a single space, followed by a title for the material and ended with another square bracket. For example, enter this on the CZ article's edit page: | ||
:{|style="background: #fffaf5; color: green" width=95% | |||
|'''<nowiki><ref></nowiki>'''<nowiki>[http://www.eia.doe.gov/energyexplained/index.cfm?page=gasoline_where Where our gasoline comes from]</nowiki>'''<nowiki></ref></nowiki>''' | |||
|} | |||
which produces this in the references list at the bottom of a CZ article's main page: | which produces this in the references list at the bottom of a CZ article's main page: | ||
Line 227: | Line 309: | ||
It is preferable to use the <nowiki>{{cite web... }}</nowiki> template found at [[CZ: Citation templates]], which prompts for relevant information about the source: | It is preferable to use the <nowiki>{{cite web... }}</nowiki> template found at [[CZ: Citation templates]], which prompts for relevant information about the source: | ||
:{|style="background: #fffaf5; color: green" width=75% | |||
|'''<nowiki><ref>{{</nowiki>''' cite web | |||
|- | |||
|<nowiki>|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html</nowiki> | |||
|- | |||
|<nowiki>|title=Gasoline explained: Where our gasoline comes from</nowiki> | |||
|- | |||
|<nowiki>|date= April 2008 </nowiki> | |||
|- | |||
|<nowiki>|publisher=U.S. Energy Information Administration </nowiki> | |||
|- | |||
|<nowiki>|work=Energy Explained</nowiki> | |||
|- | |||
|<nowiki>|accessdate=2011-05-14'''}}</nowiki> | |||
|- | |||
|'''</ref>''' | |||
|- | |||
|} | |||
which may be strung out on a single line, if one wishes. This insertion produces this in the references list at the bottom of a CZ article's main page: | which may be strung out on a single line, if one wishes. This insertion produces this in the references list at the bottom of a CZ article's main page: | ||
:1. <font color=blue>↑ </font>{{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Gasoline explained: Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}} | :1. <font color=blue>↑ </font>{{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Gasoline explained: Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}} | ||
It is strongly recommended that, under no circumstances, should a references ever include a un-bracketed "bare" url . In other words, references on a CZ article's edit page should '''never''' be formatted like this: | It is strongly recommended that, under ''no'' circumstances, should a references ''ever'' include a un-bracketed "bare" url . In other words, references on a CZ article's edit page should '''never''' be formatted like this: | ||
:{|style="background: #fffaf5; color: green" width=95% | |||
|'''<nowiki><ref></nowiki>''' <nowiki>http://www.eia.doe.gov/energyexplained/index.cfm?page=gasoline_where</nowiki> Where our gasoline comes from '''<nowiki></ref></nowiki>''' | |||
|} | |||
which would produce this undesirable reference format in the references list at the bottom of a CZ article's main page: | which would produce this undesirable reference format in the references list at the bottom of a CZ article's main page: | ||
Latest revision as of 01:27, 19 May 2011
This is a Citizendium help page |
This help page is meant for help and guidance only. It can be edited by any Citizen and, whilst we try to ensure it is accurate, it may not fully represent current policy. |
Further guidance can be found at the Citation style page. |
See also CZ:List-defined references and CZ:Citation templates
This article is about formatting embedded inline references (also called notes or footnotes) in an article. They may provide sources where a reader can find discussion in more detail, or from a different background, or ramifications of the topic the article has not explored. Or, they may corroborate a specific word, statement, paragraph or even sub-section of an article by providing the readers of the article with the details of a book, journal, newspaper report or online website page that substantiates and validates the word, statement, paragraph or sub-section. The location of the word, statement, paragraph or subsection being referenced is marked with a superscript, bracketed number (colored blue) like this for a single reference[1] or this[2][3] for multiple references. All Citizendium article having a status of Developed or Approved should have a list of references in a "References" or "Footnotes" section at the end of the article.
In Citizendium and many other Wikis, the Wiki markup coding of embedded inline references on the edit page of an article always begins with the tag <ref> and ends with the tag </ref>. For that reason, the Wiki markup coding of embedded inline references is often referred to as the <ref> </ref> method.
In contrast to notes directed at specific content, some authors use the word "references" to mean listing the details of sources (such as books or journals) that provided information, corroboration or substantiation of the article as a whole rather than any specific parts of the article. Such lists are placed at the end of the article with no indication as to what specific part of the article each listed source applies. Within the context of Citizendium, in most cases, such non-specific references are best placed in the "Bibliography" subpage rather than at the end of the article. If such reference lists include hyperlinks to online website pages, then they are best included in the "External Links" subpage. In some few cases, an article may benefit by having a short list of about 3 books in a section entitled "Further reading" in addition to the "References" or "Footnotes" section and the "Bibliography" subpage.
Some authors also use embedded inline hyperlinks like this [ http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed] as references. Such references should not be used because they display a number in the text, like this [1], which will be confused with the numbered footnotes in the Reference section at the end of the article. If the url is followed by a space and a description as in [http://webbook.nist.gov/cgi/cbook.cgi?Name=Isooctane&Units=SI&cTC=on#Thermo-Condensed Pentane: C8H18], only the words will show in the text: Pentane: C8H18. The writer must decide whether to place such links on the External links subpage, whether to use an inline link as just described, or whether to use a true numbered footnote with the {{cite web...}} template found at CZ:Citation templates, a more appropriate choice where the link is meant to support a specific item in the text.
No rules or guidance about references are cast in stone and must absolutely be followed. However, following the methods and guidance in this article will result in consistency from one article to another and, for that reason, it is strongly recommended they be followed.
Valid, reliable references
A reference must be accurate, reliable and it must support the text. To elaborate upon, or to validate or corroborate the statement that "Mike Brown climbed Mount Everest", referencing a publication about Mount Everest is no good if Mike Brown isn't mentioned. Similarly, referencing an article about Mike Brown is also no good if it doesn't mention that he climbed Mount Everest. The referenced source must relate to Mike's achievement, and if corroboration is sought, say specifically what is to be verified.
We must use reliable, credible sources such as published books, professional journals, mainstream press report , and reliable web sites. Blogs, MySpace, YouTube, fan sites and extreme minority material are not usually acceptable, nor are your own unpublished essays or research. Wikipedia articles or other Citizendium articles are not reliable sources.
Inserting embedded inline references
Single insertion of a reference:
For the single insertion of a reference, <ref>{{cite xxx |...}}</ref> is inserted on the CZ article's edit page at the location of the reference, where xxx is book, journal or web. This insertion will display a number in the text[1] linked to the corresponding numbered footnote in the References section.
For example, insertion at a location in the text of:
<ref> {{cite web|url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14}} </ref>
results in a footnote in the References section as follows:
- 1.↑ Where our gasoline comes from. Energy Explained. U.S. Energy Information Administration (April 2008). Retrieved on 2011-05-14.
The writer has flexibility in how much detail is provided to the template. It looks like a lot of input, but most of it is just copy and paste.
Insertion of the same reference more than once:
When the same reference is used several times, the reference tag <ref> is expanded to include a one-word name for the reference <ref name=xxxxx>, where xxxx is an arbitrary choice by the writer, but may not include punctuation other than underscores '_'. This one-word name insertion is placed on the CZ article's edit page at the first insertion point of the reference:
<ref name=Speight> {{cite book |author=J. G. Speight |title=The Chemistry and Technology of Petroleum |pages=pp. 465 ''ff'' |chapter=Chapter 16: Distillation |edition=4th Edition |publisher=CRC Press |url=http://books.google.com/books?id=ymL2S9RWzx4C&pg=PA465 |year=2006 |isbn= 0-8493-9067-2}} </ref>
where spaces are introduced just to make reading easier. At the second insertion point of the reference the insertion is made:
<ref name=Speight/>
Notice the forward slash. And at the third insertion point of the reference:
<ref name=Speight/>
and so forth, for further insertion points. With these three inserts in a line of text, the result is:
Petroleum is important.[1] It is used in plastics,[1] and for fuel.[1] .................................................................................................. References 1. ↑ 1.0 1.1 1.2 J. G. Speight (2006). “Chapter 16: Distillation”, The Chemistry and Technology of Petroleum, 4th Edition. CRC Press, pp. 465 ff. ISBN 0-8493-9067-2.
The References section at the end of the CZ article is discussed next.
The References or Footnotes list
On the edit page of the CZ article, place either of these at the bottom of an article to produce a references or footnotes section:
==References== ==Footnotes== {{reflist}} {{reflist}}
Either of the above formats produces a references or footnotes section at the bottom of the CZ article's main page containing a list such as shown in the boxed example just below. The item numbers in the list are generated automatically.
In some cases, when there are a large number of references and many of them are fairly short, space can be conserved by using {{reflist|2}}, instead of {{reflist}}, which splits the reference list into two columns.
Putting it together
An example shows how the insertion points and the reference list interact.
Where to place insertion points
The correct placement of the reference insertions is illustrated by a realistic example:
The crude oil distillation unit is the first processing unit in a petroleum crude oil refinery.[1] It separates the crude oil into petroleum naphtha[1] and other intermediate refinery products.[1] Those intermediate products are subsequently further processed in other units so as to produce sales products such as gasoline,[1][2] diesel oil, fuel oils and asphalt. References - ↑ 1.0 1.1 1.2 1.3 J. G. Speight (2006). “Chapter 16: Distillation”, The Chemistry and Technology of Petroleum, 4th Edition. CRC Press, pp. 465 ff. ISBN 0-8493-9067-2.
- ↑ Where our gasoline comes from. Energy Explained. U.S. Energy Information Administration (April 2008). Retrieved on 2011-05-14.
Note the placement of the references in the above example. These are the "rules":
- A reference for a sentence is inserted immediately after the period at the end of the sentence, with no space between the period and the reference.
- A reference for a single word (that is not followed by a comma) is inserted immediately after the word, with no space between the word and the reference.
- A reference for a single word (that is followed by a comma) is inserted immediately after the comma, with no space between the word and the comma.
- Two or more references at the same point of insertion are placed immediately next to each other with no space between the references.
How to use the links
- Clicking on the superscript footnote number in the main text [1], [2], ... causes the screen display to scroll down far enough to display that reference in the References list.
- Clicking on the blue superscript 1.0 in the References list causes the screen display to scroll back up to the point where the first reference to Speight's book was inserted. Clicking on the blue superscript 1.1 causes the screen display to scroll back up to the point where the second reference to Speight's book was inserted. Clicking on the blue superscript 1.2 causes the screen display to scroll back up to the point where the third reference to Speight's was inserted ... and so forth.
- Clicking on any up arrow (↑) in the reference list that has no associated superscripts causes the screen display to scroll back up to the point where that single-use references was inserted.
Try it out with the boxed example above!
Implementation
Of course, one just can type in the information xxx in <ref name = MyRefName> xxx </ref>, but an alternative is to copy and paste one of the listings below and fill it in by copying and pasting the information.
{{cite book}}
|
{{cite journal}}
|
{{cite web}}
|
One fills in the fields one wants to use, and leaves the rest blank. Other fields can be found in CZ:Citation templates. More details and some alternatives to using templates are descirbed next.
Books, journals and the web
A number of approaches are available for the text between the <ref> – </ref> tags. The following examples do not cover every method of referencing books and articles. But they do provide enough information so that beginners can produce satisfactory references. Quite complicated templates are available as well, and it is probably best for new authors to use simpler approaches. Some examples are given below using these templates, and experienced writers may wish to explore all their features described at {{cite book}} or {{cite journal}}, or {{cite web}}.
Referencing books
This is example template of a simple book reference that provides the needed essentials:
<ref> {{cite book|author=|title=|edition=|publisher=|year=|pages=|isbn= XXXX }}</ref>
and this is how it would appear on a CZ article's edit page:
<ref>{{cite book|author=Thomas Paine |title=The Age of Reason |edition=Republication of 1794 edition |publisher=Forgotten Books |year=2008 |isbn=1-60620-853-5}}</ref>
which automatically produces this in the references list at the bottom of a CZ article's main page:
- Thomas Paine (2008). The Age of Reason, Republication of 1794 edition. Forgotten Books. ISBN 1-60620-853-5. .
If the edition is unknown, then simply leave it blank; if a url is discovered, put it in. Thus on a CZ article's edit page:
<ref>{{cite book|author=Thomas Paine |title=The Age of Reason |publisher=Forgotten Books |year=2008 |isbn=1-60620-853-5 |url=http://books.google.com/books/p/pub-4297897631756504?id=fFMMMmQk1CsC&printsec=frontcover&dq=Thomas+Paine&cd=1#v=onepage&q&f=false}}</ref>
and in the References section:
- Thomas Paine (2008). The Age of Reason. Forgotten Books. ISBN 1-60620-853-5.
Here is a somewhat more elaborate example in vertical format (the order does not matter; the template sorts the results):
<ref name=Halmos>{{ cite book |title=Naive set theory |author=Paul Richard Halmos |chapter=Section 9: Families |url=<nowiki>http://books.google.com/books?id=x6cZBQ9qtgoC&pg=PA34 |pages=pp. 34 ff |isbn= 0387900926 |publisher=Springer |year=1998 |edition=Reprint of 1960 ed }}</ref>
A single-line format works just as well. This insertion in the text of the article results in an entry at the {{Reflist}} location:
- 1. ↑ Paul Richard Halmos (1998). “Section 9: Families”, Naive set theory, Reprint of 1960 ed. Springer, pp. 34 ff. ISBN 0387900926.
In this example, a link to Google books is provided. This link is truncated at the page number, which makes the url shorter at the cost of eliminating the highlighting of the search terms in the retrieved page. Because the reference has been named, it can be referred to again somewhere else in the article using the insertion in the text <ref name=Halmos/> with a forward slash. As with all these templates, the writer has the flexibility to cherry-pick which entries to include, and most of the input is copy and paste.
Referencing journals
There exist a huge number of formats for citing journal articles, and to obtain consistency across CZ it seems reasonable here to follow the practice implemented in the template {{cite journal}}. It includes the following information: the author's name; followed by the year in parenthesis and a period; the article title in quotation marks, also followed by a period; the name of the journal in italic font, and not followed by a period; the journal's volume number in bold font; followed by the issue number in plain font (not bold and not italic) in parentheses; followed by the pages of the article in plain font. Below is an example of how this recipe appears upon a CZ article's edit page:
<ref> James A. Bierlein, Webster B. Kay (1953). "Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide." Industrial Engineering & Chemistry 45(3): 618-624 </ref>
which produces the following entry in the References list at the bottom of a CZ article's main page:
- 1. ↑ James A. Bierlein, Webster B. Kay (1953). "Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide." Industrial Engineering & Chemistry 45(3): 618-624
Writers used to other formats will have to be careful if they are to be consistent with this specific style guide: their habits may take over and lead to formats that vary in order, font and punctuation. It requires no attention to a style guide if one uses the {{cite journal}} template found at CZ: Citation templates:
<ref>{{ cite journal |author=James A. Bierlein, Webster B. Kay |title=Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide |journal=Ind. Eng. Chem. |volume=45 |issue= 3 |year=1953 |pages=618–624 |doi=10.1021/ie50519a043 |url=<nowiki>http://pubs.acs.org/doi/abs/10.1021/ie50519a043}} </ref>
which may be strung out in a single line, if so desired. Regardless of the order of the items, the template produces an entry using a standardized format in the References list at the bottom of a CZ article's main page, namely:
- 1. ↑ James A. Bierlein, Webster B. Kay (1953). "Phase-Equilibrium Properties of System Carbon Dioxide-Hydrogen Sulfide". Ind. Eng. Chem. 45 (3): 618–624. DOI:10.1021/ie50519a043. Research Blogging.
This entry also is likely to be more complete (as it is here) because the template suggests useful information to the writer that may prove helpful to a reader. The doi is the digital object identifier for the document, not available for some older documents.
Referencing online website pages
The simplest correct way to reference material from an online website page is to start with square bracket, followed by the url of the website page, followed by a single space, followed by a title for the material and ended with another square bracket. For example, enter this on the CZ article's edit page:
<ref>[http://www.eia.doe.gov/energyexplained/index.cfm?page=gasoline_where Where our gasoline comes from]</ref>
which produces this in the references list at the bottom of a CZ article's main page:
It is preferable to use the {{cite web... }} template found at CZ: Citation templates, which prompts for relevant information about the source:
<ref>{{ cite web |url=http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html |title=Gasoline explained: Where our gasoline comes from |date= April 2008 |publisher=U.S. Energy Information Administration |work=Energy Explained |accessdate=2011-05-14'''}} </ref>
which may be strung out on a single line, if one wishes. This insertion produces this in the references list at the bottom of a CZ article's main page:
- 1. ↑ Gasoline explained: Where our gasoline comes from. Energy Explained. U.S. Energy Information Administration (April 2008). Retrieved on 2011-05-14.
It is strongly recommended that, under no circumstances, should a references ever include a un-bracketed "bare" url . In other words, references on a CZ article's edit page should never be formatted like this:
<ref> http://www.eia.doe.gov/energyexplained/index.cfm?page=gasoline_where Where our gasoline comes from </ref>
which would produce this undesirable reference format in the references list at the bottom of a CZ article's main page:
- 1. ↑ http://www.eia.doe.gov/bookshelf/brochures/gasoline/index.html Where our gasoline comes from
Take the time to correctly format references to online website pages.
Summary
This article is based on "boiling down" the many other CZ "help", "how to" and "style" articles containing guidance on how to format and use references or citations (not all of which are inter-consistent) into one single, coherent article devoted completely to explaining how to format references. It is also based on a great deal of experience in formatting references for CZ and other Wiki articles.
Click here to return to main help page. |
Citizens, we need your help! |
These help pages are a work in progress and need developing. Some topics are not written at all yet. Feel free to edit this page, or any other within the help system, and contribute towards making this a useful tool to all. |