Help:Footnotes: Difference between revisions

From Meta, a Wikimedia project coordination wiki
Content deleted Content added
Omniplex (talk | contribs)
Omniplex (talk | contribs)
Reinsert synopsis from m:Cite.php
Line 3: Line 3:
:''This page gives general documentation valid for all MediaWiki installations which use the [http://meta.wikimedia.org/wiki/Help:Cite cite extension]. For use of this feature in the English Wikipedia see [[w:Wikipedia:Footnotes]]. That page also includes more examples.
:''This page gives general documentation valid for all MediaWiki installations which use the [http://meta.wikimedia.org/wiki/Help:Cite cite extension]. For use of this feature in the English Wikipedia see [[w:Wikipedia:Footnotes]]. That page also includes more examples.


== Synopsis ==
==Cite.php methos==
=== Synopsis ===
* <code>&lt;ref&gt;</code>Reference text<code>&lt;/ref&gt;</code>
* <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>
* <code>&lt;ref name="</code>''id''<code>"&gt;</code>Reference text<code>&lt;/ref&gt;</code>
Line 10: Line 11:
*: repeated use of same reference may be done as before or in this format with no need to repeat the reference text.
*: 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>
* <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.

== &lt;ref&gt; ==
<code>&lt;ref&gt;</code> defines inline citations that are collected for later insertion in the page using <code>&lt;references&gt;</code>. For instance, try typing the following in an edit box and clicking "Save page":

<blockquote style="border:1px solid black;padding:1em;">AIDS is a collection of symptoms and infections resulting from the specific damage to the immune system caused by infection with the human immunodeficiency virus (HIV).'''<code><nowiki><ref name=Marx>Marx, J. L. New disease baffles medical community. Science. 1982;217(4560):618–621.</ref></nowiki></code>'''
<p>Most researchers believe that HIV originated in sub-Saharan Africa '''<code><nowiki><ref name=NYT>''New York Times''. [[January 14]], [[2010]] issue, page 16</ref></nowiki></code>'''; it is now a global epidemic. Some authorities '''<code><nowiki><ref>UNAIDS</ref></nowiki></code>''' estimate that AIDS has killed more than 25 million people since it was first recognized on December 1, 1981, making it one of the most destructive epidemics in recorded history. The folks at the NYT are worried sick about this.'''<code><nowiki><ref name=NYT/></nowiki></code>'''
</blockquote>
will result in the following text on the article page:

<blockquote style="padding:1em;">AIDS is a collection of symptoms and infections resulting from the specific damage to the immune system caused by infection with the human immunodeficiency virus (HIV).<ref name=Marx>Marx, J. L. New disease baffles medical community. Science. 1982;217(4560):618–621.</ref>
<p>Most researchers believe that HIV originated in sub-Saharan Africa;<ref name=NYT>''New York Times''. [[January 14]], [[2010]] issue, page 16</ref> it is now a global epidemic. Some authorities<ref>UNAIDS</ref> estimate that AIDS has killed more than 25 million people since it was first recognized on December 1, 1981, making it one of the most destructive epidemics in recorded history. The folks at the NYT are worried sick about this.<ref name=NYT/>
</blockquote>

Note that references may be cited more than once using <code>&lt;ref name="</code>''id''<code>"/&gt;</code>. In the example above, the ''New York Times'' article is cited twice. In the second instance, instead of typing out the full reference (<code><nowiki><ref name=NYT>''New York Times''. [[January 14]], [[2010]] issue, page 16</ref></nowiki></code>), one may simply use <code><nowiki><ref name=NYT/></nowiki></code>. Be careful not to forget the <code>/</code>.


===Multiple insertion of the same reference===
===Multiple insertion of the same reference===


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



Revision as of 16:39, 17 May 2006

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 methos

Synopsis

  • <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. a b c 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.

Links to other help pages

Help contents
Meta · Wikinews · Wikipedia · Wikiquote · Wiktionary · Commons: · Wikidata · MediaWiki · Wikibooks · Wikisource · MediaWiki: Manual · Google
Versions of this help page (for other languages see further)
What links here on Meta or from Meta · Wikipedia · MediaWiki
Reading
Go · Search · Namespace · Page name · Section · Backlinks · Redirect · Category · Image page · Special pages · Printable version
Tracking changes
Recent changes (enhanced) | Related changes · Watching pages · Diff · Page history · Edit summary · User contributions · Minor edit · Patrolled edit
Logging in and preferences
Logging in · Preferences
Editing
Starting a new page · Advanced editing · Editing FAQ · Export · Import · Shortcuts · Edit conflict · Page size
Referencing
Links · URL · Interwiki linking · Footnotes
Style and formatting
Wikitext examples · CSS · Reference card · HTML in wikitext · Formula · Lists · Table · Sorting · Colors · Images and file uploads
Fixing mistakes
Show preview · Reverting edits
Advanced functioning
Expansion · Template · Advanced templates · Parser function · Parameter default · Magic words · System message · Substitution · Array · Calculation · Transclusion
Others
Special characters · Renaming (moving) a page · Preparing a page for translation · Talk page · Signatures · Sandbox · Legal issues for editors
Other languages: