Template:Harvard citation year brackets

Template documentationviewedithistorypurge

Template harvp creates a short author–date citation with a one-directional link to the first matching citation template on the same page. Functionally identical to the {{harvnb}} template, harvp puts parentheses () around the year so that it stylistically mimics Citation Style 1 citations.

It is used to create shortened footnotes, a citation style which pairs a short, author-date citation in a footnote with a complete citation in the references section at the end of the article (see example below). This citation style is used to simplify multiple citations to the same source and to reduce clutter in the edit window.

harvp is a stylistic alternative to {{sfn}}. When placed in <ref>...</ref> tags, it behaves the same way as {{sfn}} but formats the short citation slightly differently.

Markup	Renders as
Article text.{{sfn|Smith|2020|p=25}} {{reflist}}	Article text.
Article text.<ref>{{harvp|Smith|2020|p=25}}</ref> {{reflist}}	Article text.

Unlike {{sfn}}, identical short footnotes with harvp are not automatically combined.

{{Sfn}}'s documentation includes an extensive collection of workarounds and solutions to common problems, and these will work equally well with harvp.

harvp should not appear within the body text of an article outside of <ref>...</ref> tags. Inline parenthetical references have been deprecated on Wikipedia since September 2020. Any usage of parenthetical references in the body of an article can be converted to footnotes by placing harvp into <ref>...</ref> tags.

Note that the use (or even non-use) of these templates is an element of citation "style", and adding or removing them in articles with an established style should be consistent with that style. See WP:CITEVAR.

Usage

harvp generates an "author-date" style short-cite from the following parameters:

<ref>{{harvp | <last1*> | <last2> | <last3> | <last4> | <year*> | p= <page> | loc= <location> }}</ref>

with

• <last1> – required; surname of first author or corporate author
• <last2>–<last4> – positional parameters; surnames of next three authors; required if available in the full citation
• <year> – required; four-digit year; may have a lowercase disambiguation letter, like 2012a
• |p= – specific page referenced in the source (alias: |page= )
• |pp= – comma-separated list of individual pages or range(s) of pages referenced in the source (alias: |pages= )
• |loc= – in-source location when |p= and |pp= are inappropriate; may be used to supplement |p= and |pp=; information such as a section or figure number. (alias: |at= )

Example

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.

Template harvp is placed inside <ref>...</ref> tags to create shortened footnotes. (As discussed above, using harvp outside of <ref>...</ref> tags is deprecated in almost all cases.)

Markup	Renders as
Article text.<ref>{{harvp|Smith|2020|p=25}}</ref> More article text.<ref>{{harvp|Smith|2020|p=25}}</ref> Still more article text.<ref>{{harvp|Smith|2020|p=26}}</ref> ==Notes== {{Reflist}} ==References== * {{cite book | last = Smith | first = John | date = 2020 | title = Smith's Book }}	Article text. More article text. Still more article text. Notes References Smith, John (2020). Smith's Book.

Parameters

Author(s) and year

The first four author surnames (or all authors if fewer than four; use the values from |lastN= or |authorN= ) are required, followed by the year of publication (from |year= or |date=). Authors past the fourth must be omitted or an error will result.

The possible issues section in {{sfn}} describes workarounds for various common problems, such as large number of authors, no author name, multiple works in the same year, two sources with same last names and years and others.

Markup	Renders as
Article text.<ref>{{harvp|Smith|1994|p=25}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|Jones|1994|p=25}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|Jones|Brown|1994|p=25}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|Jones|Brown|Black|1994|p=25}}</ref>	Article text.

Location in the source text

|p= and |pp= can be used to indicate the location in the source, such as page numbers. For single pages, use |p=; for multiple pages (such as ranges), use |pp=. Use of |p= for multiple pages or |pp= for single pages can cause cite errors.

|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 |p= or |pp=.

Markup	Renders as
Article text.<ref>{{harvp|Smith|2020|p=25}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|2020|pp=25–26}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|2020|loc=ch. 3}}</ref>	Article text.
Article text.<ref>{{harvp|Smith|2020|p=25|loc=n. 14}}</ref>	Article text.

Other variations

This section is an excerpt from Template:Sfn/doc § With templates.[edit]

These alternative templates change the appearance of the author-date citation

Purpose	Markup	Renders as
The most common format, used 200,000+ articles Has a final period	{{sfn|Smith|2020|p=25}}	Article text.
No final period	<ref>{{harvnb|Smith|2020|p=25}}</ref>	Article text.
No final period	{{sfn|Smith|2020|p=25|ps=none}}	Article text.
Parenthesis around year and page	<ref>{{harvtxt|Smith|2020|p=25}}</ref>	Article text.
Parenthesis around citation	<ref>{{harv|Smith|2020|p=25}}</ref>	Article text.
Parenthesis around year	<ref>{{harvp|Smith|2020|p=25}}</ref>	Article text.
Parenthesis around year	{{sfnp|Smith|2020|p=25|ps=none}}	Article text.
Parenthesis around year With final period	{{sfnp|Smith|2020|p=25}}	Article text.
Colon for page number	<ref>{{harvcolnb|Smith|2020|p=25}}</ref>	Article text.
Colon for page number, parenthesis around year and page	<ref>{{harvcoltxt|Smith|2020|p=25}}</ref>	Article text.
Colon for page number, parenthesis around citation	<ref>{{harvcol|Smith|2020|p=25}}</ref>	Article text.

---

Anchors for examples

• Smith (1994). Book by Smith.
• Smith; Jones (1994). Book by Smith and Jones.
• Smith; Jones; Brown (1994). Book by Smith, Jones and Brown.
• Smith; Jones; Brown; Black (1994). Book by Smith, Jones and Brown.

This template creates a short author–date citation with a one-directional link to the first matching citation template on the same page. Functionally identical to the {{tlb|harvnb}} template, '''harvp''' puts parentheses <code>()</code> around the year so that it stylistically mimics {{cs1}} citations.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
1	1	1st author's last name Example Smith	String	required
2	2	2nd author's last name or year of publication Example Williams or 2002	String	required
3	3	3rd author's last name or year of publication Example Jones or 2003	String	optional
4	4	4th author's last name or year of publication Example Brown or 2004	String	optional
5	5	Year of publication Example 2005	Number	optional
Reference value	ref Ref	Usual not used. Reference value that links the short citation to the full citation. If you specify |ref=none, no hyperlink is created. Example none	Unknown	optional
Location	loc at	Some other description of the location. Can be a URL in [ ]. Example [https://archive.org/stream/merriamwebsterdi00merr#page/253]	URL	optional
Page	p page	Single page number Example 374, xii, or A4	String	suggested
Pages	pp pages	range of page numbers or multiple separate page numbers Example 124–27 or 42,47,A113	String	optional
Quotes or additional comments	ps postscript	Used to add quotes or additional comments. Example Table 7.1	String	optional

The above documentation is transcluded from Template:Harvard citation year brackets/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.