Difference between revisions of "Template:Harvard citation"

From Chevy Wiki
Jump to navigation Jump to search
m (1 revision)
 
m (1 revision)
 
Line 1: Line 1:
<noinclude>{{Documentation subpage}}</noinclude>
<includeonly><cite class="inline">({{#ifeq:{{{Ref|}}}|none
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
  |{{#if:{{{5|}}}
 
      |{{{1|}}} et al. {{{5|}}}
{{tdeprecated|Harvard reference|Citation}}  
      |{{#if:{{{4|}}}
{{esoteric}}
          |{{{1|}}}, {{{2|}}} &amp; {{{3|}}} {{{4|}}}
 
          |{{#if:{{{3|}}}
The '''Harvard reference''' template is a versatile template for citing books, periodicals, chapters in compilations, and web-sites. It follows the [[Harvard referencing]] style, and it has a special "linking functionality" that allows inline harvard citations to link to the reference via the [[:Template:Harvard citation]] template. As the Harvard referencing style is an "surname-year" format, the only mandatory parameters are '''last''' (or '''surname''') and '''year'''. You may include as many authors or editors as necessary (via the '''last1''', '''editor-last3''', etc. tags), although only three of each will display.
            |{{{1|}}} &amp; {{{2|}}} {{{3|}}}
 
            |{{{1|}}} {{{2|}}}
The template knows whether you are citing a book, periodical, or a chapter in a compilation. The citation will be formatted as a periodical if you include a '''periodical''' or '''journal''' parameter. The citation will be formatted as a chapter or compilation in a larger book if you use the '''chapter''' or '''contribution''' parameter. In all other cases, the citation will have a standard format appropriate for books, web pages, and anything with an '''author''', a '''year''', and optionally a '''title'''.
          }}
 
        }}
==Citation of books==
    }}
<pre>{{Harvard reference
  |[[#{{#if:{{{Ref|}}}
| last=
      |{{{Ref}}}
| first=
      |CITEREF{{{1|}}}{{{2|}}}{{{3|}}}{{{4|}}}{{{5|}}}
| authorlink=
      }}|{{#if:{{{5|}}}
| year=
          |{{{1|}}} et al. {{{5|}}}
| date=
          |{{#if:{{{4|}}}
| title=
            |{{{1|}}}, {{{2|}}} &amp; {{{3|}}} {{{4|}}}
| place=
            |{{#if:{{{3|}}}
| publisher=
                |{{{1|}}} &amp; {{{2|}}} {{{3|}}}
| edition=
                |{{{1|}}} {{{2|}}}
| volume=
            }}
| id=
          }}
| url=
    }}]]
| access-date=
}}{{#if:{{{loc|}}}
}}</pre>
  |, {{{loc|}}}
 
  |{{#if:{{{p|}}}
===Parameters===
    |, p.&nbsp;{{{p|}}}
* '''last''' (''required''): The author's surname or last name. (This parameter may also be called '''surname''', '''surname1''', '''author''', or '''author1''').
    |{{#if:{{{pp|}}}
** '''first''' (''optional''): The author's first or given name(s). In formal Harvard style references, this should include only the initials. (This parameter may also be called '''given''').
        |, pp.&nbsp;{{{pp|}}}
* '''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.
}})</cite></includeonly><noinclude>
* '''title''' (''optional''): Title of the book.
{{pp-template|small=yes}}
* '''edition''' (''optional''): Number or name of the edition, if not the first; for example: ''edition''=2nd.
{{documentation}}
* '''volume''' (''optional''): The volume number of a multi-volume book.
</noinclude>
* '''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''): If an [[url]] is included, the date on which the url was last accessed.
 
===Examples===
====One author====
<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
}}.
 
====Three authors, a volume, and an edition====
<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
| volume=XII
| edition=2nd
| 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
| volume=XII
| edition=2nd
| year=2007
}}.
 
===Minimal reference===
<pre>
{{Harvard reference
| last=Jones
| year=2006
}}.
</pre>
 
'''Result:'''
{{Harvard reference
| last=Jones
| year=2006
}}.
 
==Citation of periodicals==
<pre>{{Harvard reference
| last=
| first=
| authorlink=
| year=
| title=
| periodical=
| volume=
| issue=
| pages=
| url=
| access-date=
}}</pre>
 
===Parameters===
* '''last''' (''required''): The author's surname or last name. (This parameter may also be called '''surname''', '''surname1''', '''author''', or '''author1''').
** '''first''' (''optional''): The author's first or given name(s). In formal Harvard style references, this should include only the initials. (This parameter may also be called '''given''').
* '''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. If the periodical is a newspaper or a magazine with a particular date, this tag should always be used.
* '''title''' (''optional''): Title of the article.
* '''periodical''' (''optional''): Name of the journal or periodical. (This parameter may also be called '''journal''', '''newspaper''', or '''magazine''').
* '''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.
 
===Journal article===
<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
}}.
 
===Newspaper article===
<pre>
{{Harvard reference
| last=Smith
| first=Joseph III
| authorlink=Joseph Smith III
| title=Last Testimony of Sister Emma
| newspaper=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
| newspaper=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
}}.
 
==Citation of chapers or contributions in a larger work==
<pre>{{Harvard reference
| last=
| first=
| authorlink=
| year=
| chapter=
| editor-last=
| editor-first=
| editorlink=
| title=
| edition=
| place=
| publisher=
| publication-year=
| volume=
| pages=
| id=
| url=
| access-date=
}}</pre>
 
===Parameters===
* '''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''').
** '''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.
 
===Work included in a compilation===
<pre>
{{Harvard reference
| last=Bidamon
| first=Emma Smith
| authorlink=Emma Hale Smith
| chapter=Letter to Emma S. Pilgrim
| date=[[March 27]] [[1876]]
| year=1876
| editor-surname=Vogel
| editor-first=Dan
| title=Early Mormon Documents
| volume=1
| publisher=Signature Books
| publication-year=1996
| isbn=1-56085-072-8
}}.
</pre>
 
'''Result:'''
{{Harvard reference
| last=Bidamon
| first=Emma Smith
| authorlink=Emma Hale Smith
| chapter=Letter to Emma S. Pilgrim
| date=March 27, 1876
| year=1876
| editor-surname=Vogel
| editor-first=Dan
| title=Early Mormon Documents
| volume=1
| publisher=Signature Books
| publication-year=1996
| isbn=1-56085-072-8
}}.
 
===Untitled work quoted or included in a journal article===
<pre>
{{Harvard reference
| last=Knight
| first=Joseph, Sr.
| year=1833
| editor-last=Jessee
| editor-first=Dean
| title=Joseph Knight's Recollection of Early Mormon History
| journal=BYU Studies
| volume=17
| issue=1
| publication-year=1976
| page=35
| url=https://byustudies.byu.edu/shop/PDFSRC/17.1Jessee.pdf
}}.
</pre>
 
'''Result:'''
{{Harvard reference
| last=Knight
| first=Joseph, Sr.
| year=1833
| editor-last=Jessee
| editor-first=Dean
| title=Joseph Knight's Recollection of Early Mormon History
| journal=BYU Studies
| volume=17
| issue=1
| publication-year=1976
| page=35
| url=https://byustudies.byu.edu/shop/PDFSRC/17.1Jessee.pdf
}}.
 
===Multiple authors and multiple editors===
<pre>
{{Harvard reference
| last1=Schmidt
| first1=J.
| last2=Piper
| first2=P.
| chapter=Letter to Home
| date=[[March 27]] [[1996]]
| year=2006
| editor1-last=Grimm
| editor1-first=P.
| editor2-last=Bob
| editor2-first=T.
| title=Jonesing for Jones
| volume=12
| place=New York
| publisher=Fred Books
| publication-year=2006
| isbn=1-55555-555-5
}}.
</pre>
 
'''Result:'''
{{Harvard reference
| last1=Schmidt
| first1=J.
| last2=Piper
| first2=P.
| chapter=Letter to Home
| date=March 27, 1996
| year=2006
| editor1-last=Grimm
| editor1-first=P.
| editor2-last=Bob
| editor2-first=T.
| title=Bookskrieg Bliss
| volume=12
| place=New York
| publisher=Aunt Jemima Books
| publication-year=2006
| isbn=1-55555-555-5
}}.
 
==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==
* [[Wikipedia:Cite sources]]: Style guide
* [[Wikipedia:Template messages/Sources of articles/Generic citations]]: Related templates
 
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Citation templates|{{PAGENAME}}]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[ja:Template:Harvard reference]]
</includeonly>

Latest revision as of 14:55, 3 February 2009

[edit] Template-info.svg Template documentation

Harvard citation templates

The templates for using Harvard citations are:

This page describes the first 3; for the others see their documentation pages.

Usage

{{Harvard citation |Last name of author(s)|Year| loc = Location in the text}}

Instead of using the optional loc parameter, you may also use one of the following parameters:

  • p = page
  • pp = pages
Notes
  • The abbreviation Harv may be used.
  • The first parameter is the author's last name.
  • Up to four authors can be given as parameters (see the examples). If there are more than 4 authors only the first 4 should be listed; listing more will cause odd things to happen.
  • The next parameter is the year of publication.
  • The year and author name(s) must not have extra space before and after, else the generated links will not work. (BUG)
  • The "loc = " parameter is the location of the cited material within the reference. This parameter is optional.
  • The parameter p is an optional page parameter; thus "{{Harv|Smith|2006| p=25}}" yields "(Smith 2006, p. 25)".
  • The parameter pp is an optional page range parameter; thus "{{Harv|Smith|2006| pp=25&ndash;26}}" yields "(Smith 2006, pp. 25–26)".
  • If Ref=none, then no hyperlink is created.
  • To avoid the brackets surrounding the citation, use {{Harvard citation no brackets}} or {{Harvnb}}.
  • To use the author name(s) in the text, use {{Harvard citation text}} or {{Harvtxt}}.
  • For more complicated Harvard citations with multiple links use {{Harvard citations}} or its abbreviation {{harvs}}.
  • For authors who have published more than one work in the same year, the standard way to differentiate such works is to put a lowercase letter after the year (e.g. year=2006a and year=2006b).

Editors editing this template are requested to make parallel changes to the other versions.

Examples

Markup Result
{{Harv |Smith|2006| loc=&sect;8.5}} (Smith 2006, §8.5)
{{Harv |Smith|2006| p=25}} (Smith 2006, p. 25)
{{Harv |Smith|2006| pp=25&ndash;26}} (Smith 2006, pp. 25–26)
{{Harv |Smith|2006| pp=25&ndash;26 | Ref=none}} (Smith 2006, pp. 25–26)
{{Harv |Smith|Jones|2006| p=25}} (Smith & Jones 2006, p. 25)
{{Harv |Smith|Jones|Brown|2006| p=25}} (Smith, Jones & Brown 2006, p. 25)
{{Harv |Smith|Jones|Brown|Black|2006| p=25}} (Smith et al. 2006, p. 25)
{{Harvnb |Smith|2006| p=25}} Smith 2006, p. 25
{{Harvtxt |Smith|2006| p=25}} Smith (2006, p. 25)

Recommended style

The recommended Harvard referencing style potentially uses all four templates. Each automatically generates a hypertext link based on the name(s) and date. Here is an example

Markup
Some works on gravitation are so massive they warp spacetime themselves {{Harv|Misner|Thorne|Wheeler|1973}}; yet {{Harvtxt|Einstein|1915}} presented essential equations with notable brevity. The essential ingredients are the curvature tensor and the stress-energy tensor ({{Harvnb|Einstein|1915|loc=p.&nbsp;844}}; {{Harvnb|Misner|Thorne|Wheeler|1973|loc=p.&nbsp;41}}).
Result
Some works on gravitation are so massive they warp spacetime themselves (Misner, Thorne & Wheeler 1973); yet Einstein (1915) presented essential equations with notable brevity. The two ingredients are the curvature tensor and the stress-energy tensor (Einstein 1915, p. 844; Misner, Thorne & Wheeler 1973, p. 41).

In short:

  1. For a single work with no author in the text (the most common case), use {{Harv}}.
  2. For a single work with the author named in the text, use {{Harvtxt}}.
  3. For multiple works at the same point, use explicit parentheses and {{Harvnb}} separated by semicolons.
  4. For anything more complicated use {{Harvs}}.

#CITEREF

More exotic Harvard citations can be constructed using the {{harvs}} template. If even this is not enough, then as a last resort one can use #CITEREF as in the following example:

[[Property (T)]] was introduced by [[David Kazhdan]] ([[Property T#CITEREFKazhdan1967|1967]]).

which produces

Property (T) was introduced by David Kazhdan (1967)

with a link to the author, and a link to a citation on a different page. #CITEREF should be followed by the last names of up to 4 authors and the year (with no spaces), and if the link is to a different page it should be preceded by the name of the page (with spaces allowed). The citation template marks the reference using #CITEREF; see the source of template:citation/core for details.

Use with {{Citation}}

The {{Citation}} template can be used to format the citations in the References section. Links from the Harvard citation to the Citation are provided using a #CITEREF link. The {{Harvard citation}} template creates a link #CITEREF followed by the concatenation of the author names and the year. {{Citation}} creates an anchor <a name="CITEREF"></a> followed by the concatenation of the following parameters:

  • last or last1 or surname or surname1 or author or author1 or authors,
  • last2 or surname2 or author2,
  • last3 or surname3 or author3,
  • last4 or surname4 or author4,
  • editor-last or editor-surname or editor1-last or editor1-surname or editor or editors,
  • editor2-last or editor2-surname,
  • editor3-last or editor3-surname,
  • editor4-last or editor4-surname,
  • year or date.

For example {{Harv|Smith|2006| p=25}} produces a link #CITEREFSmith2006 and {{Citation|last=Smith|first=John|year=2006|title=My Life}} produces an anchor CITEREFSmith2006.

References

  • Smith, John (2006), My Life 
  • Smith, John; Jones, Jack (2006), Our life together 
  • Smith; Jones; Brown (2006), Three's a crowd 
  • Smith; Jones; Brown; Black (2006), All together now 
  • Misner, Charles W.; Thorne, Kip S.; Wheeler, John Archibald (September 1973), Gravitation, San Francisco: W. H. Freeman, ISBN 0-7167-0344-0 
  • Einstein, Albert (1915), "Die Feldgleichungen der Gravitation (The Field Equations of Gravitation)", Koniglich Preussische Akademie der Wissenschaften: 844–847 

fr:Template:Référence Harvard ja:Template:Harv