User:Milton Beychok/Sandbox: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Milton Beychok
No edit summary
imported>Milton Beychok
Line 17: Line 17:
==Inserting the embedded inline references==   
==Inserting the embedded inline references==   


'''Multiple insertion of the same reference'''
<font size=3>'''''Multiple insertion of the same reference:'''''</font>


On the Edit page, this is placed at the first insertion point of citation:<br>
On the edit page of an article, this is placed at the first insertion point of citation:<br>


:'''<nowiki><ref name=Perry>Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref></nowiki>'''
:'''<nowiki><ref name=Speight>{{cite book|author=J. G. Speight|title=The Chemistry and Technology of Petroleum|edition=4th Edition|publisher=CRC Press |year=2006|id=ISBN 0-8493-9067-2}}</ref></nowiki>'''


This is placed at the second insertion point of citation:<br>
This is placed at the second insertion point of citation:<br>
:'''<nowiki><ref name=Perry/></nowiki>'''
:'''<nowiki><ref name=Speight/></nowiki>'''


This is placed at the third insertion point of citation:<br>
And this is placed at the third insertion point of citation:<br>
:'''<nowiki><ref name=Perry/></nowiki>''' ..... and so forth for further insertion points<br><br>
:'''<nowiki><ref name=Speight/></nowiki>''' ..... and so forth for further insertion points<br>


'''Single insertion of a reference'''
<font size=3>'''''Single insertion of a reference:'''''</font>


For the single insertion of a reference, the "name" parameter is not needed. On the Edit page, this is placed at the insertion point of citation:<br>
For the single insertion of a reference, the "name" parameter is not needed. On the Edit page, this is placed at the insertion point of citation:<br>
Line 35: Line 35:
:'''<nowiki><ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref></nowiki>'''
:'''<nowiki><ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref></nowiki>'''


'''What is produced at the points of insertion'''
<font size=3>'''''What is produced at the points of insertion:'''''</font>


These are what is produced and note that the reference numbers in blue are automatically generated. Clicking on any one of the reference numbers causes the screen display to scroll down to that reference number in the Reference List section:<br>
These are what is produced and note that the reference numbers in blue are automatically generated. Clicking on any one of the reference numbers causes the screen display to scroll down to that reference number listed in the References section at the end of the article:<br>


:First <ref name="Perry">Perry's  Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref> text word referenced to Perry's Handbook
:First<ref name="Perry">Perry's  Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref> text word referenced to Speight's book


:Second <ref name="Perry"/> text word referenced to Perry's Handbook
:Second<ref name="Perry"/> text word referenced to Speight's book


:Third <ref name="Perry"/> text word referenced to Perry's Handbook
:Third<ref name="Perry"/> text word referenced to Speight's book


:The only <ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref> text word referenced to the Excel book.
:The only <ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref> text word referenced to the Excel book.


'''Producing the reference or footnote list'''
<font size=3>'''''Producing the reference or footnote list:'''''</font>


On the Edit page, place this at the bottom of an article to produce a references (or footnotes) section:<br>
On the edit page of the article, place either of these at the bottom of an article to produce a references or footnotes section:<br>
:'''<nowiki>==References (or Footnotes)==</nowiki>'''
:'''<nowiki>==References==</nowiki>''' &nbsp; &nbsp; &nbsp; &nbsp; '''<nowiki>==Footnotes==</nowiki>'''      
:'''<nowiki>{{reflist}}</nowiki>'''<br>
:'''<nowiki>{{reflist}}</nowiki>''' &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; '''<nowiki>{{reflist}}</nowiki>''' <br>


This is what it produces and note that the list numbers are automatically generated:<br>
This is the list  produced in the references or footnotes section and note that the list numbers are automatically generated:<br>
{{reflist}}
{{reflist}}


'''Notes on using the reference list'''
==Notes on using the reference or footnotes list==


* Clicking on the blue superscript <font color=blue><sup>1.0</sup></font> causes the screen display to scroll back up to the point where the first  reference to Perry's Handbook 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 the second reference to Perry's Handbook 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 the third reference to Perry's Handbook was inserted ... and so forth.
* Clicking on the blue superscript <font color=blue><sup>1.0</sup></font> 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 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 the third reference to Speight's was inserted ... and so forth.


* Clicking on any up arrow (<font color=blue>↑</font>) that has no associated superscripts cause 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>) that has no associated superscripts cause the screen display to scroll back up to the point where that single-use references was inserted.


'''Using templates to insert reference text'''
==Using templates to insert reference text==


A number of templates, such {{tl|cite book}}, are available to format the text between the <nowiki><ref></nowiki> and <nowiki></ref></nowiki> tags in a more structured way.
A number of templates, such {{tl|cite book}}, are available to format the text between the <nowiki><ref></nowiki> and <nowiki></ref></nowiki> tags in a more structured way.

Revision as of 23:08, 31 July 2010

CZ:Formatting of embedded inline references

This article is about formatting embedded inline references (also called notes or footnotes) in an article. Embedded inline references are references that are meant to 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.

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.

By contrast, 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 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.

Some authors also use embedded inline hyperlinks like this [1] or this [2] as references. Such references should not be used. When used in an article that is also using the <ref> </ref> method, confusion will arise between the numbering of the embedded inline hyperlinks and the embedded inline references.\

Valid, reliable references

A reference must be accurate, reliable and it must corroborate the statement in the text. 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 corroborate that Mike's achievement is true.

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 the embedded inline references

Multiple insertion of the same reference:

On the edit page of an article, this is placed at the first insertion point of citation:

<ref name=Speight>{{cite book|author=J. G. Speight|title=The Chemistry and Technology of Petroleum|edition=4th Edition|publisher=CRC Press |year=2006|id=ISBN 0-8493-9067-2}}</ref>

This is placed at the second insertion point of citation:

<ref name=Speight/>

And this is placed at the third insertion point of citation:

<ref name=Speight/> ..... and so forth for further insertion points

Single insertion of a reference:

For the single insertion of a reference, the "name" parameter is not needed. On the Edit page, this is placed at the insertion point of citation:

<ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref>

What is produced at the points of insertion:

These are what is produced and note that the reference numbers in blue are automatically generated. Clicking on any one of the reference numbers causes the screen display to scroll down to that reference number listed in the References section at the end of the article:

First[1] text word referenced to Speight's book
Second[1] text word referenced to Speight's book
Third[1] text word referenced to Speight's book
The only [2] text word referenced to the Excel book.

Producing the reference or footnote list:

On the edit page of the article, place either of these at the bottom of an article to produce a references or footnotes section:

==References==         ==Footnotes==
{{reflist}}                     {{reflist}}

This is the list produced in the references or footnotes section and note that the list numbers are automatically generated:

  1. 1.0 1.1 1.2 Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.
  2. Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.

Notes on using the reference or footnotes list

  • Clicking on the blue superscript 1.0 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 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 the third reference to Speight's was inserted ... and so forth.
  • Clicking on any up arrow () that has no associated superscripts cause the screen display to scroll back up to the point where that single-use references was inserted.

Using templates to insert reference text

A number of templates, such {{cite book}}, are available to format the text between the <ref> and </ref> tags in a more structured way.