Template:Citation/doc
From charlesreid1
40px | This is a documentation subpage for Template:Citation (see that page for the template itself). It contains usage information, categories, interlanguage links and other content that is not part of the original template page. |
Template:For2 The Citation template generates a citation for a book, periodical, contribution in a collective work, patent, or a web page. It determines the citation type by examining which parameters are used.
If invoked with the right parameters, this template produces output identical to that of the Cite templates, such as {{cite book}} and {{cite web}}. The default behavior sometimes differs from that of the Cite templates; for example, this template by default generates anchors for Harvard references whereas the Cite templates do not (although they can be made to do so), and this template by default uses commas to separate some fields that the Cite templates separate with periods (full stops).
All parameter names are lowercase.
Contents
- 1 Anchored citations
- 2 Citing books
- 3 Citing journals, newspapers, magazines, or other periodicals
- 4 Citing edited books, or parts of edited books, including encyclopedias and encyclopedia articles
- 5 Citing contributions, republications, or edited quotations in a periodical article
- 6 Citing patents
- 7 Dates
Anchored citations
This template can generate a citation that can be combined with shortened footnotes or parenthetical referencing. It does this by creating an HTML anchor containing an ID. The special parameter Template:Para generates an ID suitable for Harvard referencing templates such as {{harv}} as specified in the next section; this is the default for the {{citation}} template. If an empty Template:Para is given, no anchor is generated; this is the default for the Cite templates such as {{cite book}} and {{cite news}}. You can also specify the ID directly, using the Template:Para parameter. For example, suppose an article's References section contains the markup:
{{Citation |author=Sigmund Freud |title=Civilization and Its Discontents |year=1930 |ref=CivDis}}
which generates the citation:
- Sigmund Freud (1930), Civilization and Its Discontents
Then, the markup "([[#CivDis|Freud 1930]])
" generates a parenthetical reference "(Freud 1930)" containing a wikilink to the citation (try clicking on the wikilink).
Anchors for Harvard referencing templates
IDs compatible with Harvard referencing templates such as {{harv}} are computed from the last names of the authors and the year of the cited source. For example, the markup "{{harv|Wright|Evans|1851|p=ix}}
" generates the Harvard reference "Template:Harv", which wikilinks to the citation whose markup and appearance are shown below:
{{Citation |last1=Wright |first1=Thomas |last2=Evans |first2=R.H. |title=Historical and Descriptive Account of the Caricatures of James Gillray |location=London |publisher=Henry G. Bohn |year=1851 |oclc=59510372 }}
- Wright, Thomas; Evans, R.H. (1851), Historical and Descriptive Account of the Caricatures of James Gillray, London: Henry G. Bohn, OCLC 59510372
In this example the {{citation}} template defines, and the {{harv}} template uses, the HTML ID "CITEREFWrightEvans1851
", composed by concatenating the string "CITEREF
" with the last names of the authors and the year. The {{harvid}} template can be used to generate such IDs, for example, {{harvid|Wright|Evans|1851}}
generates "Template:Harvid
".
The names of only the first four authors are used; other author names are not concatenated to the ID. If no author names are given, editor names are used instead. For patents, inventor names are used instead of authors or editors. If these names are not given, this template does not generate an anchor.
Last names are used, as specified by the parameters Template:Para (or Template:Para), Template:Para, Template:Para, and Template:Para, and similarly for Template:Para etc. and for Template:Para etc. If a full name is given but no last name is specified, this template falls back on the full name, but this usage is not recommended. For example, in "{{Citation |author=Sigmund Freud |title=The Ego and the Id |year=1923}}
" no last name is given, so this citation cannot be combined with the Harvard reference "{{harv|Freud|1923}}
". To make these {{citation}} and {{harv}} invocations compatible, either replace "Template:Para" with "Template:Para Template:Para", or add "Template:Para" to the {{citation}} invocation, or add the same ref parameter (say, "Template:Para") to both the {{citation}} and the {{harv}} invocations.
Similarly, the year is used, as specified by Template:Para. If no year is given, this template attempts to derive the year from Template:Para (or, if no date is given, from Template:Para) by applying the MediaWiki #time function. This heuristic works with many common date formats (American, International and YYYY-MM-DD as listed in WP:MOS) but may not work as expected with other formats, so when in doubt it may be safer to use Template:Para. Note that if only a year, say 2005, is known you must use Template:Para rather than Template:Para.
IDs must be unique
Names, years, and hand-specified IDs must be chosen so that the IDs are unique within a page; otherwise the HTML will not conform to the W3C standards, and any references to the citations will not work reliably. For example, suppose a page contains the following two citations with {{harv}}-compatible IDs:
- Montes, G; Halterman, JS (2008a), "Association of childhood autism spectrum disorders and loss of family income", Pediatrics 121 (4): e821–6, doi:10.1542/peds.2007-1594, PMID 18381511, http://pediatrics.aappublications.org/cgi/content/full/121/4/e821
- Montes, G; Halterman, JS (2008b), "Child care problems and employment among families with preschool-aged children with autism in the United States", Pediatrics 122 (1): e202–8, doi:10.1542/peds.2007-3037, PMID 18595965, http://pediatrics.aappublications.org/cgi/content/full/122/1/e202
If these citations were altered to say "2008" rather than "2008a" and "2008b", the resulting page would not work, because the two different citations would both attempt to use the ID "CITEREFMontesHalterman2008
". To avoid this problem, distinguish the citations by appending suffixes to the years, e.g., "Template:Para" and "Template:Para", as was done above. Any Harvard references to these citations should use years with the same suffixes.
It is good practice to verify that a page does not contain duplicate IDs by using the W3C Markup Validation Service; see External links.
Citing books
Parameters (all are optional)
{{Citation |last= |first= |author= |authorlink= |coauthors= |firstn=,lastn=,authorn= |author-separator= |editor= |editorn= |editorn-last= |editorn-first= |editor-link= |editorn-link= |others= |title= |url= |archiveurl= |archivedate= |format= |accessdate= |edition= |series= |volume= |date= |origyear= |year= |month= |publisher= |location= |language= |isbn= |oclc= |doi= |doi_inactivedate= |bibcode= |id= |page= |pages= |nopp= |at= |chapter= |chapterurl= |quote= |laysummary= |laydate= |separator= |postscript= |lastauthoramp= |ref= }} |
|
Examples
One author | {{ Citation | last=Turner | first=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 }} |
Turner, O. (1851), History of the Pioneer Settlement of Phelps and Gorham's Purchase, and Morris' Reserve, Rochester, New York: William Alling, http://olivercowdery.com/texts/1851Trn1.htm#turn1851 |
Three authors, a volume, and an edition. Ampersand (&) forced before final author's name. | {{ Citation | last1=Lincoln | first1=A. | last2=Washington | first2=G. | last3=Adams | first3=J. | lastauthoramp=yes | title=All the Presidents' Names | publisher=The Pentagon | place=Home Base, New York | volume=XII | edition=2nd | year=2007 }} |
Lincoln, A.; Washington, G. & Adams, J. (2007), All the Presidents' Names, XII (2nd ed.), Home Base, New York: The Pentagon |
Citing journals, newspapers, magazines, or other periodicals
Parameters
{{Citation | last = | first = | author-link = | publication-date = | date = | year = | title = | periodical = | series = | publication-place = | place = | publisher = | volume = | issue = | pages = | page = | at = | url = | archiveurl = | archivedate = | issn = | pmid = | pmc = | doi = | oclc = | accessdate = | postscript = | ref = }} |
Template:Citation parameter legend |
Examples
Journal article | {{Citation | 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–8 | url=https://byustudies.byu.edu/ shop/PDFSRC/12.2Hill.pdf }} |
Hill, Marvin S. (1976), "Joseph Smith and the 1826 Trial: New Evidence and New Difficulties", BYU Studies 12 (2): 1–8, https://byustudies.byu.edu/shop/PDFSRC/12.2Hill.pdf |
Newspaper article | {{Citation | last=Smith | first=Joseph III | author-link=Joseph Smith III | title=Last Testimony of Sister Emma | newspaper=The Saints' Herald | publication-place=Plano, IL | volume=26 | issue=19 | date=October 1, 1879 | year=1879 | month=October | page=289 | url=http://www.sidneyrigdon.com/ dbroadhu/IL/sain1872.htm#100179 }} |
Smith, Joseph III (October 1, 1879), "Last Testimony of Sister Emma", The Saints' Herald (Plano, IL) 26 (19): 289, http://www.sidneyrigdon.com/dbroadhu/IL/sain1872.htm#100179 |
Citing edited books, or parts of edited books, including encyclopedias and encyclopedia articles
Parameters
{{Citation | last = | first = | author-link = | last2 = | first2 = | author2-link = | year = | date = | publication-date = | contribution = | contribution-url = | editor-last = | editor-first = | editor-link = | editor2-last = | editor2-first = | editor2-link = | title = | edition = | series = | place = | publication-place = | publisher = | volume = | pages = | id = | isbn = | doi = | oclc = | url = | ref = }} |
|
Examples
Manuscript published in an edited compilation | {{Citation | last=Bidamon | first=Emma Smith | author-link=Emma Hale Smith | chapter=Letter to Emma S. Pilgrim | date=March 27, 1876 | year=1876 | editor-last=Vogel | editor-first=Dan | title=Early Mormon Documents | volume=1 | publisher=Signature Books | publication-date=1996 | isbn=1–56085–072–8 }} |
Bidamon, Emma Smith (March 27, 1876), "Letter to Emma S. Pilgrim", in Vogel, Dan, Early Mormon Documents, 1, Signature Books, 1996, ISBN 1–56085–072–8 |
Work with an editor but no author | {{Citation | editor-last=Vogel | editor-first=Dan | title=Early Mormon Documents | volume=1 | publisher=Signature Books | publication-date=1996 | isbn=1–56085–072–8 }} |
Vogel, Dan, ed. (1996), Early Mormon Documents, 1, Signature Books, ISBN 1–56085–072–8 |
Encyclopedia article by a named author | {{Citation | last = Kramer | first = Martin | author-link = Martin Kramer | contribution = Bernard Lewis | editor-last = Boyd | editor-first = Kelley | title = Encyclopedia of Historians and Historical Writing | volume = 1 | pages = 719–720 | publisher = Fitzroy Dearborn | place = London | publication-date = 1999 | contribution-url = http:// www.geocities.com/martinkramerorg/ BernardLewis.htm }} |
Kramer, Martin (1999), "Bernard Lewis", in Boyd, Kelley, Encyclopedia of Historians and Historical Writing, 1, London: Fitzroy Dearborn, pp. 719–720, http://www.geocities.com/martinkramerorg/BernardLewis.htm |
Encyclopedia article with no named author | {{Citation | contribution = Bernard Lewis | editor-last = Boyd | editor-first = Kelley | title = Encyclopedia of Historians and Historical Writing | volume = 1 | pages = 719–720 | publisher = Fitzroy Dearborn | place = London | year = 1999 | contribution-url = http:// www.geocities.com/martinkramerorg/ BernardLewis.htm }} |
Boyd, Kelley, ed. (1999), "Bernard Lewis", Encyclopedia of Historians and Historical Writing, 1, London: Fitzroy Dearborn, pp. 719–720, http://www.geocities.com/martinkramerorg/BernardLewis.htm |
Citing contributions, republications, or edited quotations in a periodical article
Parameters
{{Citation | last = | first = | author-link = | last2 = | first2 = | author2-link = | year = | date = | publication-date = | contribution = | contribution-url = | editor-last = | editor-first = | editor-link = | editor2-last = | editor2-first = | editor2-link = | title = | periodical = | series = | volume = | issue = | pages = | place = | publication-place = | publisher = | id = | issn = | doi = | oclc = | url = | accessdate = | ref = }} |
|
Examples
Manuscript edited and published in a journal | {{Citation | 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-date=1976 | pages=35 | url=https://byustudies.byu.edu/ shop/PDFSRC/17.1Jessee.pdf }} |
Knight, Joseph, Sr. (1833), Jessee, Dean, ed., "Joseph Knight's Recollection of Early Mormon History", BYU Studies 17 (1): 35, 1976, https://byustudies.byu.edu/shop/PDFSRC/17.1Jessee.pdf |
Manuscript written at one date and place, then published in a periodical at a different date and place with commentary by the editor. | {{Citation | last=Klingensmith | first=Philip | contribution=Affidavit | year=1872 | date=September 5, 1872 | place=Lincoln County, Nevada | title=Mountain Meadows Massacre | editor-last=Toohy | editor-first=Dennis J. | journal=Corinne Daily Reporter | publication-date=September 24, 1872 | publication-place=Corinne, Utah | volume=5 | issue=252 | pages=1 | contribution-url=http:// udn.lib.utah.edu/u?/corinne,5359 }} |
Klingensmith, Philip (September 5, 1872), Affidavit, written at Lincoln County, Nevada, in Toohy, Dennis J., "Mountain Meadows Massacre", Corinne Daily Reporter (Corinne, Utah) 5 (252): 1, September 24, 1872, http://udn.lib.utah.edu/u?/corinne,5359 |
Citing patents
Parameters (all are optional)
{{Citation | inventor-last = | inventor-first = | inventorlink = | inventor2-last = | inventor2-first = | inventorlink2 = | publication-date = | issue-date = | title = | country-code = | description = | patent-number = }} |
|
Examples
United States patent with multiple inventors | {{Citation | inventor1-last = Degermark | inventor1-first = Mikael | inventor2-last = Brodnik | inventor2-first = Andrej | inventor3-last = Carlsson | inventor3-first = Svante | inventor4-last = Pink | inventor4-first = Stephen | title = Fast routing lookup system using complete prefix tree, bit vector, and pointers in a routing table for determining where to route IP datagrams | issue-date = 2001 | patent-number = 6266706 | country-code = US}} |
Template:Citation/patent |
Dates
<references group="n"><ref name="dates" group="n">
- The format of dates in the references of an article should use a consistent and unambiguous style. Example formats used in Wikipedia citations include:
- 2009
- 2009-09-14
- 14 September 2009
- September 14, 2009 (with comma)
- 2009 Sep 14
- September 2009
- Sept./Oct. 2009
- As indicated above, month names are sometimes abbreviated (e.g., September to "Sept" or "Sept." or "Sep" or "Sep.")
- Dates should not be linked in references.
- Please see Wikipedia:Manual of Style (dates and numbers)#Dates for more guidance about formatting dates.
</ref></references>