Editing Template:Harvard citation documentation (section)

==Usage==
{{{1}}} generates an "author-date" style short-cite from the following parameters:

<div style="margin-left: 2em"><code>{{#if:{{{noref|}}}||<nowiki><ref></nowiki>}}{{{{{1}}} | &lt;{{var|last1}}*> | &lt;{{var|last2}}> | &lt;{{var|last3}}> | &lt;{{var|last4}}> | &lt;{{var|year}}*> | p= &lt;{{var|page}}> | loc= &lt;{{var|location}}> &#125;&#125;{{#if:{{{noref|}}}||<nowiki></ref></nowiki>}}</code></div>

with
* &lt;{{var|last1}}> – required; surname of first author or corporate author
* &lt;{{var|last2}}>–&lt;{{var|last4}}> – positional parameters; surnames of next three authors; required if available in the full citation
* &lt;{{var|year}}> – required; four-digit year; may have a lowercase disambiguation letter, like {{pval|2012a}}
* {{para|p}} – specific page referenced in the source (alias: {{para|page}}{{hairspace}})
* {{para|pp}} – comma-separated list of [[Template:Csdoc#pages|individual pages and / or range(s) of pages]] referenced in the source  (alias: {{para|pages}}{{hairspace}})
* {{para|loc}} – in-source location when {{para|p}} and {{para|pp}} are inappropriate; may be used to supplement {{para|p}} and {{para|pp}}; information such as a section or figure number. (alias: {{para|at}}{{hairspace}})

Typical usage is shown in the example below. The text and the footnote are connected by a bi-directional link – clicking on the superscript takes the reader to the footnote, clicking on the footnote number takes them back to the superscript. The clicking on the short citation takes them to the full citation in the references section.

{{#if:{{{noref|}}}|

Template {{{1}}} is not placed inside {{tag|ref}} tags and generates the footnote internally. (To place {{{1}}} in a footnote, see [[#A citation inside an explanatory footnote|putting a citation inside a footnote]], below.)
{{markup|<nowiki>
Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}
More article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}
Still more article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=26}}

==Notes==
{{reflist}}

==References==
* {{cite book
 | last = Smith | first = John
 | date = 2020
 | title = Smith's Book
}}
</nowiki>|
Article text.{{{{{1}}}|Smith|2020|p=25}}
More article text.{{{{{1}}}|Smith|2020|p=25}}
Still more article text.{{{{{1}}}|Smith|2020|p=26}}

{{fake notes and references||}}
{{cite book
 | last = Smith | first = John
 | date = 2020
 | title = Smith's Book
}}}}|

Template {{{1}}} is placed inside {{tag|ref}} tags to create {{sfnote|lc=y}}. Using {{{1}}} outside of {{tag|ref}} tags is deprecated in [[#Parenthetical references are deprecated|some contexts]].
{{markup|<nowiki>
Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</ref>
More article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</ref>
Still more article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=26}}</ref>

==Notes==
{{reflist}}

==References==
* {{cite book
 | last = Smith | first = John
 | date = 2020
 | title = Smith's Book
}}
</nowiki>|
Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=25}}}}
More article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=25}}}}
Still more article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=26}}}}

{{fake notes and references||}}
*{{cite book
 | last = Smith | first = John
 | date = 2020
 | title = Smith's Book
}}
*{{cite book|last1=Smith|last2=Jones|date=2020|title=Book by Smith and Jones}}
*{{cite book|last1=Smith|last2=Jones|last3=Brown|date=2020|title=Book by Smith and Jones and Brown}}
*{{cite book|last1=Smith|last2=Jones|last3=Brown|last4=Black|date=2020|title=Book by Smith and Jones and Brown and Black}}
}}

}}

===Parameters===

====Author(s) and year====
The first four author surnames (or all authors if fewer than four; use the values from {{para|last''N''}} or {{para|author''N''}}{{hairspace}}) are required, followed by the year of publication (from {{para|year}} or {{para|date}}). Authors past the fourth must be omitted or an error will result.

The [[#Possible issues|possible issues]] section below describes workarounds for various common problems, such as [[#Large number of authors|large number of authors]], [[#No author name in citation template|no author name]], [[#More than one work in a year|multiple works in the same year]], [[#More than one author with the same last name|multiple authors with same last name]] and others.

{{#if:{{{noref|}}}|
{{markup
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|p=25}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|2020|p=25}}</nowiki>
|Article text.{{{{{1}}}|Smith|Jones|2020|p=25}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|Brown|2020|p=25}}</nowiki>
|Article text.{{{{{1}}}|Smith|Jones|Brown|2020|p=25}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|Brown|Black|2020|p=25}}</nowiki>
|Article text.{{{{{1}}}|Smith|Jones|Brown|Black|2020|p=25}}<br />
{{reflist}}
}}
|
{{markup
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=25}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|2020|p=25}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|Jones|2020|p=25}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|Brown|2020|p=25}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|Jones|Brown|2020|p=25}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|Jones|Brown|Black|2020|p=25}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|Jones|Brown|Black|2020|p=25}}}}<br />
{{reflist}}
}}
}}

====Location in the source text====
The optional parameters {{para|p}}, {{para|pp}} and {{para|loc}} can be used to indicate the location in the source, such as page numbers. For single pages, use {{para|p}}; for multiple pages (such as ranges), use {{para|pp}}. Use of {{para|p}} for multiple pages or {{para|pp}} for single pages can cause [[Help:Cite errors/Cite error references duplicate key|cite errors]]. {{para|loc}} can be used to specify a location in the source in another way, such as section numbers or chapters. It can also be combined with {{para|p}} or {{para|pp}}. The parameters {{para|page}} and {{para|pages}} exist as aliases for {{para|p}} and {{para|pp}}, respectively.

{{#if:{{{noref|}}}|
{{markup
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|p=25}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|pp=25–26}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|pp=25–26}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|loc=ch. 3}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|loc=ch. 3}}<br />
{{reflist}}
|<nowiki>Article text.{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25|loc=n. 14}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|p=25|loc=n. 14}}<br />
{{reflist}}
}}
|
{{markup
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=25}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|pp=25–26}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|pp=25–26}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|loc=ch. 3}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|loc=ch. 3}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|p=25|loc=n. 14}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|p=25|loc=n. 14}}}}<br />
{{reflist}}
}}
}}

====Additional text====
The optional parameter {{para|postscript}} or {{para|ps}} can be used to change the text which appears at the end of the note in the reference list. (See [[#Additional comments or quotes|§ Adding additional comments or quotes]] and [[#No closing period|§ No closing period]], below.) Subsequent invocations of {{tl2|sfn}} with the same author, year, page, and location values but a different value for this parameter with produce a cite error about multiple definition.

====Hard-coded link names====
''Not available in {{tl2|sfn}} and similar templates.''

The optional parameter {{para|ref}} is used to create an unusually named link from the short citation to the full citation. This parameter is usually not necessary, and it is more common to use {{tl2|sfnRef}} or {{tl2|harvid}} in the reference section. If you specify {{para|ref|none}}, no hyperlink is created. However, if one does not want the link, it is always possible to simply use plain text instead of the template. The parameter {{para|Ref}} is an alias for {{para|ref}}.