「テンプレート:Harvard citation documentation」を編集中 (節単位)

==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
* &lt;{{var|year}}> – required; four-digit year; may have a lowercase disambiguation letter
* {{para|p}} – specific page referenced in the source
* {{para|pp}} – comma-separated list of individual pages and / or range(s) of pages referenced in the source 
* {{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.

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 [[WP:PARREF|was deprecated in September 2020]]).
{{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
}}}}

}}

===Parameters===

====Author(s) and year====
The author and the year of publication are the only required parameters. Up to four authors can be given as parameters. 

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. 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|loc=chpt. 3}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|loc=chpt. 3}}<br />
{{reflist}}
|<nowiki>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|loc=section 7}}</nowiki>
|Article text.{{{{{1}}}|Smith|2020|loc=section 7}}<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=chpt. 3}}</ref></nowiki>  
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|loc=chpt. 3}}}}<br />
{{reflist}}
|<nowiki>Article text.<ref>{{</nowiki>{{{1}}}<nowiki>|Smith|2020|loc=section 7}}</ref></nowiki>
|Article text.{{#tag:ref|{{{{{1}}}|Smith|2020|loc=section 7}}}}<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.) The postscript is only effective the first time {{tl2|sfn}} is used for a particular author, year and location.

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

The optional parameter {{para|ref}} is used to create a 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}}.