Template:Harvard citation documentation: Difference between revisions

m
1 revision
m (1 revision)
 
m (1 revision)
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:


In the body of the article:
In the body of the article:
: <code><nowiki>{{</nowiki>'''{{{1}}}''' | last name(s) of author(s) | year | p=page number</code> ''or'' <code>pp=page range</code> ''or'' <code>loc=other location <nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>'''{{{1}}}''' | last name(s) of author(s) | year | p=page number</code> ''or'' <code>pp=page range</code> ''or'' <code>loc=other location <nowiki>}}</nowiki></code>
'''If more than four authors, truncate the list to the first four.'''<br />
{{#ifeq:{{{1}}}|sfn|In a section for citations, usually under the heading '''Notes''':
{{#ifeq:{{{1}}}|sfn|In a section for citations, usually under the heading '''Notes''':
: <code><nowiki>{{reflist}}</nowiki></code>}}
: <code><nowiki>{{reflist}}</nowiki></code>}}
In the references section (or in an earlier footnote):
In the references section (or in an earlier footnote):
: <code><nowiki>{{</nowiki>cite book</code> ''or'' <code>cite journal</code>'', etc'' | <code>'''ref=harv'''</code> | ''... other appropriate parameters ...'' <code><nowiki>}}</nowiki></code>
: <code><nowiki>{{</nowiki>[[Template:cite book|cite book]]</code> ''or'' <code>[[Template:cite journal|cite journal]]</code>'', etc'' | <code>'''ref=harv'''</code> | ''... other appropriate parameters ...'' <code><nowiki>}}</nowiki></code>
or
or
: <code><nowiki>{{</nowiki>citation |</code> ''... other appropriate parameters ...'' <code><nowiki>}}</nowiki></code> ({{para|ref|harv}} is not required when using {{tl|Citation}})
: <code><nowiki>{{</nowiki>[[Template:citation|citation]] |</code> ''... other appropriate parameters ...'' <code><nowiki>}}</nowiki></code> ({{para|ref|harv}} is not required when using {{tl|Citation}})


==Parameters==
==Parameters==
Line 458: Line 459:


===More than one work in a year===
===More than one work in a year===
Where there is a need to cite more than one work ''by the same author published in the same year'', the standard way to differentiate such works is to put a lowercase letter after the year (e.g. putting {{para|year|2006a}} and {{para|year|2006b}} in the citation templates and using {{code|<nowiki>{{sfn|Smith|2006a}}</nowiki>}} and {{code|<nowiki>{{sfn|Smith|2006b}}</nowiki>}}in the article body).
Where there is a need to cite more than one work ''by the same author published in the same year'', the standard way to disambiguate such works is to add a letter suffix after the year element of the {{tld|sfn}} template (e.g. {{code|<nowiki>{{sfn|Smith|2006a}}</nowiki>}} and {{code|<nowiki>{{sfn|Smith|2006b}}</nowiki>}}).


{{As of|2013|October|17}} there is a bug in the template handling software which requires a work-around. For authors who have published more than one work in the same year, use {{em|both}} {{para|date}} and {{para|year}} in the citation template.  The {{para|date}} parameter value will be displayed in the rendered citation and the {{para|year}} value will be used to create the CITEREF anchor. Add a lowercase letter suffix to the {{para|year}} value (e.g. {{para|year|2006a}} and {{para|year|2006b}}). Use {{code|<nowiki>{{sfn|Smith|2006a}}</nowiki>}} and {{code|<nowiki>{{sfn|Smith|2006b}}</nowiki>}} in the article body. Do not add a letter suffix to the {{para|date}} value because doing so will corrupt the citation's [[COinS]] metadata. Similarly, using a suffixed {{para|year}} value without providing {{para|date}} will also corrupt the COinS metadata.
====CS1 templates that use Module:Citation/CS1====
When{{tld|sfn}} is used with {{cs1}} templates that use the [[Module:Citation/CS1]] engine,{{efn|name=module|Citation templates using [[Module:Citation/CS1]] are: {{tlx|citation}}, {{tlx|cite AV media}}, {{tlx|cite book}}, {{tlx|cite conference}}, {{tlx|cite encyclopedia}}, {{tlx|cite journal}}, {{tlx|cite news}}, {{tlx|cite podcast}}, {{tlx|cite press release}}, {{tlx|cite sign}}, {{tlx|cite speech}}, {{tlx|cite techreport}}, {{tlx|cite thesis}}, and {{tlx|cite web}}.}} a year-suffix letter may be added to {{para|date}} for all accepted date formats except year initial numeric ([[ISO 8601]]).  It is not necessary to include both {{para|year}} and {{para|date}} (if both are included, {{para|year}} is ignored}.
:{{xt|{{para|date|2013a}}}} – simple year only dates
:{{xt|{{para|date|Jan 2013b}}}} or {{xt|{{para|date|Winter 2013b}}}} – month or season and year dates
:{{xt|{{para|date|9 November 2013b}}}} or {{xt|{{para|date|November 9, 2013b}}}} – full dates
:{{xt|{{para|date|June–July 2013c}}}} or {{xt|{{para|date|Winter–Spring 2013c}}}} – month or season ranges and year dates
:{{xt|{{para|date|c. 2013d}}}} – circa year dates
:{{xt|{{para|date|n.d.e}}}} – no date (n.d.)
:{{!xt|{{para|date|2013x-11-09}}}} – not supported


{{markup
{{markup
Line 467: Line 476:


==Notes==
==Notes==
{{reflist}}
{{reflist |close=1}}


==References==
==References==
Line 473: Line 482:
|last=Smith
|last=Smith
|first=Karen
|first=Karen
|date=1993
|date=January 1993a
|year=1993a
|title=Smith's first paper
|title=Smith's first paper
|journal=Important Journal
|journal=Important Journal
Line 482: Line 490:
|last=Smith
|last=Smith
|first=Karen
|first=Karen
|date=1993
|date=Spring–Summer 1993b
|year=1993b
|title=Smith's second paper
|title=Smith's second paper
|journal=Another Important Journal
|journal=Another Important Journal
Line 494: Line 501:
|last=Smith
|last=Smith
|first=Karen
|first=Karen
|date=1993
|date=January 1993a
|year=1993a
|title=Smith's first paper
|title=Smith's first paper
|journal=Important Journal
|journal=Important Journal
Line 503: Line 509:
|last=Smith
|last=Smith
|first=Karen
|first=Karen
|date=1993
|date=Spring–Summer 1993b
|year=1993b
|title=Smith's second paper
|title=Smith's second paper
|journal=Another Important Journal
|journal=Another Important Journal
|ref =harv
}}}}}}
====CS1 templates that use citation/core====
For those templates that use {{tlx|citation/core}},{{efn|name=citecore|Citation templates using {{tlx|citation/core}}are: {{tlx|cite AV media notes}}, {{tlx|cite DVD-notes}}, {{tlx|cite episode}}, {{tlx|cite interview}}, {{tlx|cite mailing list}}, {{tlx|cite map}}, {{tlx|cite music release notes}}, {{tlx|cite newsgroup}}, and {{tlx|cite serial}}.}} limitations in the template handling software require a work-around. For authors who have published more than one work in the same year, use {{em|both}} {{para|date}} and {{para|year}} in the citation template.  The {{para|date}} parameter value will be displayed in the rendered citation and the {{para|year}} value will be used to create the CITEREF anchor. Add a lowercase letter suffix to the {{para|year}} value (e.g. {{para|year|2006a}} and {{para|year|2006b}}). Use {{code|<nowiki>{{sfn|Jones|2006a}}</nowiki>}} and {{code|<nowiki>{{sfn|Jones|2006b}}</nowiki>}} in the article body. Letter suffixes added to the {{para|date}} value is ignored.
{{markup
|<nowiki>Article text.{{sfn |Jones|1993a| p=25}}
More text.{{sfn |Jones|1993b| p=32}}
==Notes==
{{reflist|close=1}}
==References==
* {{cite speech
|last=Jones
|first=Robert
|date=April 1993
|year=1993a
|title=Jones's first speech
|event=Important Conference
|ref=harv
}}
* {{cite speech
|last=Jones
|first=Robert
|date=June 1993
|year=1993b
|title=Jones's second speech
|event=Another Important Conference
|ref =harv
}}</nowiki>
|{{fake notes and references
|Article text.{{sfn |Jones|1993a| p=25}}
More text.{{sfn |Jones|1993b| p=32}}
|* {{cite speech
|last=Jones
|first=Robert
|date=April 1993
|year=1993a
|title=Jones's first speech
|event=Important Conference
|ref=harv
}}
* {{cite speech
|last=Jones
|first=Robert
|date=June 1993
|year=1993b
|title=Jones's second speech
|event=Another Important Conference
|ref =harv
|ref =harv
}}}}}}
}}}}}}
Line 812: Line 868:
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
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
{{markup
|<nowiki>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.&amp;nbsp;844}}; {{Harvnb|Misner|Thorne|Wheeler|1973|loc=p.&amp;nbsp;41}}).
|<nowiki>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|p=844}}; {{Harvnb|Misner|Thorne|Wheeler|1973|p=41}}).


==References==
==References==
Line 825: Line 881:
  | publisher=W. H. Freeman
  | publisher=W. H. Freeman
  | location = San Francisco
  | location = San Francisco
  | year = 1973
  | date = September 1973
  | month = September
  | isbn = 0-7167-0344-0 }}
| id = ISBN 0-7167-0344-0 }}
*{{Citation
*{{Citation
  | last =Einstein
  | last =Einstein
Line 836: Line 891:
  | year =1915
  | year =1915
}}</nowiki>
}}</nowiki>
|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 two 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}}).
|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 two ingredients are the curvature tensor and the stress-energy tensor ({{Harvnb|Einstein|1915|p=844}}; {{Harvnb|Misner|Thorne|Wheeler|1973|p=41}}).


{{fake heading|sub=3|References}}
{{fake heading|sub=3|References}}
Line 849: Line 904:
  | publisher=W. H. Freeman
  | publisher=W. H. Freeman
  | location = San Francisco
  | location = San Francisco
  | year = 1973
  | date = September 1973
  | month = September
  | isbn = 0-7167-0344-0 }}
| id = ISBN 0-7167-0344-0 }}
*{{Citation
*{{Citation
  | last =Einstein
  | last =Einstein
Line 873: Line 927:
{{See also|Wikipedia:Citation templates and reference anchors}}
{{See also|Wikipedia:Citation templates and reference anchors}}


The most common citation templates are {{cs1}} or {{cs2}}. If {{para|ref|harv}} is set, then {{tl|Citation/core}} creates an [[HTML element#Links and anchors|anchor]] {{tag|a|o|params=name="CITEREF"}} followed by the concatenation of the following parameters:
The most common citation templates are {{cs1}} or {{cs2}}. If {{para|ref|harv}} is set, then [[Module:Citation/CS1]] and {{tl|Citation/core}} create an [[HTML element#Links and anchors|anchor]] {{tag|a|o|params=name="CITEREF"}} followed by the concatenation of the following parameters:
* '''last''' or '''last1''' or '''surname''' or '''surname1''' or '''author''' or '''author1''' or '''authors''',
* '''last''' or '''last1''' or '''surname''' or '''surname1''' or '''author''' or '''author1''' or '''authors''',
* '''last2''' or '''surname2''' or '''author2''',
* '''last2''' or '''surname2''' or '''author2''',
Line 889: Line 943:
Please note that the above list does ''not'' include the '''coauthor''' parameter, which is ignored in generating the citation's CITEREF anchor. It is recommended that, when used with the harv family templates, citation templates always use the numbered '''last''' parameters instead of '''coauthor''' so that a more accurate CITEREF anchor may be generated. If '''coauthor''' is used, it will not be possible to generate a Harvard citation that displays the authors' names correctly and that generates a link to the correct CITEREF anchor.
Please note that the above list does ''not'' include the '''coauthor''' parameter, which is ignored in generating the citation's CITEREF anchor. It is recommended that, when used with the harv family templates, citation templates always use the numbered '''last''' parameters instead of '''coauthor''' so that a more accurate CITEREF anchor may be generated. If '''coauthor''' is used, it will not be possible to generate a Harvard citation that displays the authors' names correctly and that generates a link to the correct CITEREF anchor.


Use of the '''date''' parameter in place of the '''year''' parameter in citation templates is preferred when full dates are known. The date parameter should not be used to simply encode a year, as this can fail to generate a viable {{code|#CITEREF}} link.
Use of the '''date''' parameter in place of the '''year''' parameter in citation templates is preferred when full dates are known. For {{tlx|citation/core}}-based{{efn|name=citecore}} CS1 templates only: the date parameter should not be used to simply encode a year, as this can fail to generate a viable {{code|#CITEREF}} link.


===Harvard citation [[wikilink]]===
===Harvard citation [[wikilink]]===
Line 912: Line 966:
==Notes==
==Notes==
{{reflist|group=note}}
{{reflist|group=note}}
 
{{notelist}}
{{Wikipedia referencing}}
{{Wikipedia referencing}}


14,070

edits