View source for Template:Harvard reference/doc

<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{esoteric}}
==Reference to a book, one author==
 '''<nowiki>{{Harvard reference|Surname=|Given=|Authorlink=|Year=|Title=|Place=|Publisher=|ID=|URL=}}</nowiki>'''

* '''Surname''' (''required''): The author's surname or last name. (This parameter may also be called '''Last''').
** '''Given''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First''' or '''Initials''').
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
* '''Year''' (''required''): Year of publication.
** '''Date''' (''optional''): While the ''Year'') tag is mandatory, use of the ''Date'' parameter will override how the date is displayed in the reference.
* '''Title''' (''optional''): Title of the book.
* '''Edition''' (''optional''): Number or name of the edition, if not the first; for example: ''Edition=2nd''.
* '''Place''' (''optional''): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: <code>Place=Paris, TX</code> (no period at the end).  Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
* '''Publisher''' (''optional''): The name of the publisher. Omit terms such as ''Publishers'', ''Co.'', ''Inc.'', ''Ltd.'', etc., but retain the words ''Books'' or ''Press''.
* '''ID''' (''optional''): Identifier such as ''<nowiki>ISBN 1-111-22222-9</nowiki>''
** '''ISBN''' (''optional''): Use this parameter if the book has an ISBN.
* '''URL''' (''optional''): An [[url]] of an online location where the book can be found.
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.

==Reference to an article in a periodical, one author==
 '''<nowiki>{{Harvard reference|Surname=|Given=|Authorlink=|Year=|Title=|Journal=|Volume=|Issue=|Pages=|URL=}}</nowiki>'''

* '''Surname''' (''required''): The author's surname or last name. (This parameter may also be called '''Last''').
** '''Given''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First''' or '''Initials''').
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
* '''Year''' (''required''): Year of publication in the journal.
** '''Date''' (''optional''): While the ''Year'') tag is mandatory, use of the ''Date'' parameter will override how the date is displayed in the reference.
* '''Title''' (''optional''): Title of the article.
* '''Journal''' (''optional''): Name of the journal or periodical. (This parameter may also be called '''Periodical''').
* '''Volume''' (''optional''): The volume number of the journal.
* '''Issue''' (''optional''): The issue number of the journal. (This parameter may also be called '''Number''').
* '''Pages''' (''optional''): The pages in the issue where the article may be found. (If the article is on only one page, use the parameter '''Page''' instead).
* '''URL''' (''optional''): An [[url]] of an online location where the article can be found.
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.

==Reference to a contribution or chapter in a book, one author and one editor==
 '''<nowiki>{{Harvard reference|Surname=|Given=|Authorlink=|Year=|Chapter=|Editor=|Title=|Place=|Publisher=|Pages=
|ID=|URL=}}</nowiki>'''

* '''Surname''' (''required''): The author's surname or last name. (This parameter may also be called '''Last''').
** '''Given''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First''' or '''Initials''').
** '''Author''' (''optional''): While the ''Surname'' (or ''Last'') tag is mandatory for referencing purposes, use of the ''Author'' parameter will override how the author's name is displayed in the reference.
* '''Authorlink''' (''optional''): Title of a Wikipedia article about author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
* '''Year''' (''required''): Year of publication.
** '''Date''' (''optional''): While the ''Year'') tag is mandatory, use of the ''Date'' parameter will override how the date is displayed in the reference.
* '''Chapter''' (''required for chapters''): Title of the contribution in the book. (This parameter may also be called '''Contribution''').
* '''Editor''' (''optional''): Name of the editor or editors.
* '''Title''' (''required for chapters''): Title of the book.
* '''Edition''' (''optional''): Number or name of the edition, if not the first; for example: ''Edition=2nd''.
* '''Place''' (''optional''): The city of publication. If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: <code>Place=Paris, TX</code> (no period at the end).  Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter.
* '''Publisher''' (''optional''): The name of the publisher. Omit terms such as ''Publishers'', ''Co.'', ''Inc.'', ''Ltd.'', etc., but retain the words ''Books'' or ''Press''.
* '''Pages''' (''optional''): The pages in the book where the chapter or contribution may be found. (If the contribution is on only one page, use the parameter '''Page''' instead).
* '''ID''' (''optional''): Identifier such as ''<nowiki>ISBN 1-111-22222-9</nowiki>''
** '''ISBN''' (''optional''): Use this parameter if the book has an ISBN.
* '''URL''' (''optional''): An [[url]] of an online location where the book can be found.
* '''Access-date''' (''optional''): The date on which the [[url]] was last accessed.

==Book or periodical, multiple authors, up to four==
 '''<nowiki>{{Harvard reference|Surname1=|Given1=|Authorlink1=|Surname2=|Given2=|Authorlink2=|Surname3=|Given3=
|Authorlink3=|Surname4=|Given4=|Authorlink4=|Year=|Title=|Place=|Publisher=|ID=|URL=}}</nowiki>'''

* '''Surname1''' (''required''): The first author's surname or last name. (This parameter may also be called '''Last1''').
** '''Given1''' (''optional''): The author's first or given name. In formal Harvard style references, this should include only the initials. (This parameter may also be called '''First1''' or '''Initials1''').
** '''Author1''' (''optional''): While the ''Surname1'' (or ''Last1'') tag is mandatory for referencing purposes, use of the ''Author1'' parameter will override how the first author's name is displayed in the reference.
* '''Authorlink1''' (''optional''): Title of a Wikipedia article about the first author. Article must already exist. <!-- Should not create redlinks to every non-notable author. -->
*Other authors: use ''Surname2'', ''Surname3'', etc.

==Examples==
===Books===
<pre>
{{ Harvard reference
 | Surname=Turner
 | Given=O.
 | Title=History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve
 | Publisher=William Alling
 | Place=[[Rochester, New York]]
 | Year=1851
 | URL=http://olivercowdery.com/texts/1851Trn1.htm#turn1851
 }}.
</pre>

'''Result:'''
{{ Harvard reference
 | Surname=Turner
 | Given=O.
 | Title=History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve
 | Publisher=William Alling
 | Place=[[Rochester, New York]]
 | Year=1851
 | URL=http://olivercowdery.com/texts/1851Trn1.htm#turn1851
 }}.

===Periodicals===
<pre>
{{Harvard reference
 | Last=Hill
 | First=Marvin S.
 | Title=Joseph Smith and the 1826 Trial: New Evidence and New Difficulties
 | Journal=BYU Studies
 | Volume=12
 | Issue=2
 | Year=1976
 | Pages=1&ndash;8
 | URL=https://byustudies.byu.edu/shop/PDFSRC/12.2Hill.pdf
 }}.
</pre>

'''Result:'''
{{Harvard reference
 | Last=Hill
 | First=Marvin S.
 | Title=Joseph Smith and the 1826 Trial: New Evidence and New Difficulties
 | Journal=BYU Studies
 | Volume=12
 | Issue=2
 | Year=1976
 | Pages=1&ndash;8
 | URL=https://byustudies.byu.edu/shop/PDFSRC/12.2Hill.pdf
 }}.

===Newspapers===
<pre>
{{Harvard reference
 | Last=Smith
 | First=Joseph III
 | Authorlink=Joseph Smith III
 | Title=Last Testimony of Sister Emma
 | Journal=The Saints' Herald
 | Volume=26
 | Issue=19
 | Date=[[October 1]], [[1879]]
 | Year=1879
 | Month=October
 | Page=289
 | URL=http://www.sidneyrigdon.com/dbroadhu/IL/sain1872.htm#100179
 }}.
</pre>

'''Result:'''
{{Harvard reference
 | Last=Smith
 | First=Joseph III
 | Authorlink=Joseph Smith III
 | Title=Last Testimony of Sister Emma
 | Journal=The Saints' Herald
 | Volume=26
 | Issue=19
 | Date=[[October 1]], [[1879]]
 | Year=1879
 | Month=October
 | Page=289
 | URL=http://www.sidneyrigdon.com/dbroadhu/IL/sain1872.htm#100179
 }}.

===Minimal reference===
<pre>
{{Harvard reference
 | Last=Jones
 | Year=2006
 }}.
</pre>

'''Result:'''
{{Harvard reference
 | Last=Jones
 | Year=2006
 }}.

===Multiple authors===
<pre>
{{Harvard reference
 | Surname1=Lincoln
 | Given1=A.
 | Surname2=Washington
 | Given2=G.
 | Surname3=Adams
 | Given3=J.
 | Title=All the Presidents' Names
 | Publisher=The Pentagon
 | Place=Home Base, New York
 | Year=2007
 }}.
</pre>

'''Result:'''
{{Harvard reference
 | Surname1=Lincoln
 | Given1=A.
 | Surname2=Washington
 | Given2=G.
 | Surname3=Adams
 | Given3=J.
 | Title=All the Presidents' Names
 | Publisher=The Pentagon
 | Place=Home Base, New York
 | Year=2007
 }}.

===Citation examples===
These examples of citation within the text are based on related citation template [[Template:Harvard citation]], which automatically creates a one-directional link to the first matching Harvard reference on the same page:

'''Markup in main text:'''
*<nowiki>{{</nowiki>[[Template:Harvard citation|Harvard citation]]<nowiki>|Turner|1851|pp=10-11}}</nowiki> (full cite format)
*<nowiki>{{</nowiki>[[Template:Harv|Harv]]<nowiki>|Smith|1879|p=289}}</nowiki> (short format)
*<nowiki>{{</nowiki>[[Template:Harv|Harv]]<nowiki>|Jones|2006|loc=section 5|Ref=none}}</nowiki> (non-linking)
*<nowiki>{{</nowiki>[[Template:Harv|Harv]]<nowiki>|Lincoln|Washington|Adams|2007|pp=88-89}}</nowiki> (multi-author)

'''Results:'''
*{{Harvard citation|Turner|1851|pp=10-11}}
*{{Harv|Smith|1879|p=289}}
*{{Harv|Jones|2006|loc=section 5|Ref=none}}
*{{Harv|Lincoln|Washington|Adams|2007|pp=88-89}}

===Notes===
*Because the [[Harvard referencing]] style is based on ''Surname'' and ''Year'', these items are mandatory in both the citation and the reference.
*If there is only one author, the parameters ''Surname'' and ''Given'' may be replaced with ''Last'' and ''First'', respectively.
*Template is generally compatible with [[Template:Cite book]] and [[Template:Cite journal]].

==See also==
* [[Centiare:Cite sources]]: Style guide
* [[Centiare:Template messages/Sources of articles/Generic citations]]: Related templates

<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Templates using ParserFunctions|{{PAGENAME}}]]

<!-- ADD INTERWIKIS BELOW THIS LINE -->
</includeonly>