Template:Wikicite/doc: Difference between revisions

This is a documentation subpage for Template:Wikicite. It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 2,100 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses TemplateStyles: Template:Citation/styles.css

{{Wikicite}} creates an anchor, for use in a "References" section for books, journals, web references, etc. The anchor should be linked-to in the body of the article.

The reference text may be formatted manually, and the template merely adds an anchor for linking from in-text citations. This template is also useful when using a citation template that does not support the |ref= parameter (for example, {{ws}}).

This template is only needed for handwritten citations, or citations using non-standard citation templates, that are linked to by a shortened footnote or a parenthetical reference. If you don't mind using a citation template, it is more standard to use {{sfn}} or {{harv}} with a template such as {{citation}}, {{cite book}}, {{cite web}}, etc.

This template is not necessary if the citation uses a citation template (such as {{cite book}}). Use the |ref= parameter of the citation template to create the anchor. This template is also not necessary if the article does not contain a shortened footnote or parenthetical reference that creates a link (e.g. (Atwood 2003)). The anchor serves no purpose if nothing links to it.

Usage[edit]

Copy-'n'-paste.

{{wikicite | id = | reference = }}

or, alternatively (but not equivalently – see below)

{{wikicite | ref = | reference = }}

The first parameter is an alias for |reference=. The |id= or |ref= parameters are alternative unique identifiers used for the reference link on the page, compatible with some other reference templates. If both |id= and |ref= are provided, |id= is ignored. There are two differences between these:

• |id= automatically prefixes the link anchor with "Reference-", whereas |ref= does not
• |id= encloses the link anchor in double quotes, so these must not be provided by the editor; but if using |ref=, the specified content for this parameter must be enclosed in quotes unless it consists entirely of letters, figures, hyphens and periods. If it contains any other character - such as a blank or underscore - it must be quoted. (e.g., a ref anchor of Von Autor-2006 must be specified as |ref="Von Autor-2006")

Thus, these two forms

{{wikicite | id = Anchor 1 | reference = Reference text }}

{{wikicite | ref = "Reference-Anchor 1" | reference = Reference text }}

produce identical results.

The |reference= parameter is the actual reference text. It may be plain text, formatted text, or one of the citation templates.

Examples[edit]

Recommended formats.

According to Atwood, blah blah.<ref>[[#Atwood-2003|Atwood (2003)]], p. 29.</ref>

== Notes ==
{{reflist}}

== References ==
* {{wikicite | ref = Atwood-2003 | reference = Atwood, Margaret (2003). ''Oryx and Crake'', Toronto: McClelland & Stewart. {{ISBN|978-0-7710-0868-9}}. }}

According to Atwood, blah blah.<ref>[[#Reference-Atwood-2003|Atwood (2003)]], p. 29.</ref>

== Notes ==
{{reflist}}

== References ==
* {{wikicite | id = Atwood-2003 | reference = Atwood, Margaret (2003). ''Oryx and Crake'', Toronto: McClelland & Stewart. {{ISBN|978-0-7710-0868-9}}. }}

According to Atwood, blah blah.{{sfn|Atwood|2003|p=29}}

== Notes ==
{{reflist}}

== References ==
* {{wikicite | ref = {{sfnRef|Atwood|2003}} | reference = Atwood, Margaret (2003). ''Oryx and Crake'', Toronto: McClelland & Stewart. {{ISBN|978-0-7710-0868-9}}. }}

The parameter reference can be assigned templates as well as text. So if there is a template that is used for citations that does not support the usual {{Harvnb}} templates (see Help:CS1 and Help:CS2) the template can be passed into this template via the reference parameter. There is a template called {{ws}} that "places a wikisource icon before text". For example:

{{ws|[[s:Wellingon's Waterloo dispatch to Lord Bathurst, 19 June 1815|''The Waterloo dispatch'']]}} by the [[Duke of Wellington]] (19 June 1815)

would look like:

The Waterloo dispatch. by the Duke of Wellington (19 June 1815)

According to the ''[[Duke of Wellington]]'', blah blah.{{sfn|Wellington|1815}}

== Notes ==
{{reflist}}

== References ==
* {{wikicite
   | ref = {{sfnRef|Wellington|1815}}
   | reference ={{ws|[[s:Wellingon's Waterloo dispatch to Lord Bathurst, 19 June 1815|''The Waterloo dispatch'']]}} by the [[Duke of Wellington]] (19 June 1815)
  }}

However this is only one of several ways this particular text could be cited (see § Alternatives for more details):

• {{ws}} can take a template as a parameter itself, and then the citation can be linked using the standard {{harv}}-style footnotes:

• {{ws| {{citation |last=Wellington |first=Duke of |date=19 June 1815 |title=[[s:Wellingon's Waterloo dispatch to Lord Bathurst, 19 June 1815|''The Waterloo dispatch'']] }} }}
• Wellington, Duke of (19 June 1815), 'The Waterloo dispatch'  .

Features[edit]

• Compatible with any reference style: editor has 100% control of the format through a technology called editing wikitext

Technical features:

• Produces well-formed, accessible, semantically-correct HTML code
• Compatible with many other templates' in-text citation links (any id which starts with "Reference-")
• No conditionals
• No CSS hacks

Alternatives[edit]

Note that identical behavior can be achieved using the more standard {{Harvnb}} (or {{sfn}}) and {{Citation}}

In article body: {{Harv|Atwood|2003}}

In references section: * {{citation | last = Atwood | first = Margaret | year = 2003 | title = Oryx and Crake | location = Toronto | publisher = McClelland & Stewart | isbn = 978-0-7710-0868-9 }}

See also[edit]

• {{Citation}}
• {{Harvnb}}
• {{Sfn}}, an alternative method for creating shortened footnotes
• {{Citeref}}, alternative method to create links to citations
• Wikipedia:Citation templates
• Wikipedia:Citing sources
• Wikipedia:Citing sources/Further considerations#Using Wikicite
• T-34#References, example of usage