Difference between revisions of "Help:Footnotes"

From Timelines
Jump to: navigation, search
(useful help)
(merged new stuff into master help page on Meta and copied that back)
Line 1: Line 1:
This page gives short introductions to two methods for making linked footnotes:
+
{{H:h}}[[Category:Editor handbook]]
* Cite.php method, explained in detail at [[wikipedia:footnotes]], wikipedia's current best practice for numbered footnotes;
+
:''This page gives general documentation valid for all MediaWiki installations which use the [[m:Cite|cite extension]].  For use of this feature in the English Wikipedia see [[w:Wikipedia:Footnotes]], that page also includes more examples.
* Semi-automatic templates, explained in detail at [[wikipedia:footnote3]], '''apart for Harvard references this method is obsolete'''
 
  
 
==Cite.php method==
 
==Cite.php method==
{{Help:How to use Cite.php references}}
+
* <code>&lt;ref&gt;</code>Reference text<code>&lt;/ref&gt;</code>
 +
* <code>&lt;ref name="</code>''id''<code>"&gt;</code>Reference text<code>&lt;/ref&gt;</code>
 +
*: the quotes are only needed if ''id'' contains spaces.
 +
* <code>&lt;ref name="</code>''id''<code>"/&gt;</code>
 +
*: repeated use of same reference may be done as before or in this format with no need to repeat the reference text.
 +
* <code>&lt;references/&gt;</code>
 +
*: inserts the full text of all pending inline citations defined by <code>&lt;ref&gt;</code>, anywhere on the page.
  
==Old system (with templates)==
+
===Multiple insertion of the same reference===
{{Ph:Footnotes}}
 
  
==See also==
+
References may be cited more than once using <code>&lt;ref name="</code>''id''<code>"/&gt;</code>.
*[[m:help:footnotes]] (cite.php method)
+
On the Edit page, 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>'''
 +
 
 +
This is placed at the second insertion point of citation:<br>
 +
:'''<nowiki><ref name=Perry/></nowiki>'''
 +
 
 +
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>
 +
 
 +
===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:<br>
 +
 
 +
:'''<nowiki><ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref></nowiki>'''
 +
 
 +
===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 in the Reference List section:<br>
 +
 
 +
:First <ref name="Perry">Perry's  Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref> text word referenced to Perry's Handbook
 +
 
 +
:Second <ref name="Perry"/> text word referenced to Perry's Handbook
 +
 
 +
:Third <ref name="Perry"/> text word referenced to Perry's Handbook
 +
 
 +
: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===
 +
 
 +
On the Edit page, this is placed in the References or the Footnotes section:<br />
 +
::'''<nowiki><references/></nowiki>'''<br />
 +
 
 +
This is what it produces and note that the list numbers are automatically generated:<br />
 +
<references/>
 +
 
 +
===Notes on the Cite.php method===
 +
 
 +
* Clicking on the blue superscript <font color="blue">a</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>b</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>c</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 any caret (<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.
 +
 
 +
{{H:f|langs=|enname=Footnotes}}

Revision as of 08:53, 17 May 2006

Template:H:h

This page gives general documentation valid for all MediaWiki installations which use the cite extension. For use of this feature in the English Wikipedia see w:Wikipedia:Footnotes, that page also includes more examples.

Cite.php method

  • <ref>Reference text</ref>
  • <ref name="id">Reference text</ref>
    the quotes are only needed if id contains spaces.
  • <ref name="id"/>
    repeated use of same reference may be done as before or in this format with no need to repeat the reference text.
  • <references/>
    inserts the full text of all pending inline citations defined by <ref>, anywhere on the page.

Multiple insertion of the same reference

References may be cited more than once using <ref name="id"/>. On the Edit page, this is placed at the first insertion point of citation:

<ref name=Perry>Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref>

This is placed at the second insertion point of citation:

<ref name=Perry/>

This is placed at the third insertion point of citation:

<ref name=Perry/> ..... 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 in the Reference List section:

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

Producing the reference or footnote list

On the Edit page, this is placed in the References or the Footnotes section:

<references/>

This is what it produces 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 the Cite.php method

  • Clicking on the blue superscript a 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 b 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 c 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 any caret (^) that has no associated superscripts cause the screen display to scroll back up to the point where that single-use references was inserted.

Template:H:f