Template:Citation/doc: Difference between revisions
imported>Locos epraix (sorting) |
imported>Fullstop (+doc for at=, and link to subsection for dates) |
||
Line 72: | Line 72: | ||
* '''author2''', '''author3''', '''author4''': The second, third, and fourth authors' names, if applicable. |
* '''author2''', '''author3''', '''author4''': The second, third, and fourth authors' names, if applicable. |
||
* '''author2-link''', '''author3-link''', '''author4-link''': Title of an existing Wikipedia article about the second, third, and fourth author, if applicable. |
* '''author2-link''', '''author3-link''', '''author4-link''': Title of an existing Wikipedia article about the second, third, and fourth author, if applicable. |
||
* '''publication-date''' (or '''date'''): Date of publication. |
* '''publication-date''' (or '''date'''): Date<ref group="n" name="dates" /> of publication. |
||
* '''date''': Date of authorship, if different from date of publication. If only ''date'' is used, it will be treated as the date of publication. |
* '''date''': Date<ref group="n" name="dates" /> of authorship, if different from date of publication. If only ''date'' is used, it will be treated as the date of publication. |
||
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full ''date''.) |
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full ''date''.) |
||
* '''origyear''': Year of first publication, if different. |
* '''origyear''': Year of first publication, if different. |
||
Line 85: | Line 85: | ||
* '''pages''': For use when multiple pages are cited. Adds "pp." before the page numbers. Do not use with '''page'''. |
* '''pages''': For use when multiple pages are cited. Adds "pp." before the page numbers. Do not use with '''page'''. |
||
* '''page''': For use when one page is cited. Adds "p." before the page number. Do not use with '''pages'''. |
* '''page''': For use when one page is cited. Adds "p." before the page number. Do not use with '''pages'''. |
||
* '''at''': Position within the resource when <code>page=/pages=</code> is inappropriate, e.g. <code>at</code>=para. 14 (when citing a source without page numbers) or <code>at</code>=02:56 (a film or audio timestamp), or <code>at</code>=no. 456 (something in a numbered list). This parameter is ignored if <code>page=</code>/<code>pages=</code> is specified. |
|||
* '''id''': Identifier such as ''<nowiki>ISBN 1–111–22222–9</nowiki>'' |
* '''id''': Identifier such as ''<nowiki>ISBN 1–111–22222–9</nowiki>'' |
||
* '''isbn''': Use this parameter if the book has an ISBN. |
* '''isbn''': Use this parameter if the book has an ISBN. |
||
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
||
** '''doi_brokendate''': |
** '''doi_brokendate''': Date<ref group="n" name="dates" /> on which the DOI was observed to be not functioning. |
||
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
||
* '''url''': An [[url]] of an online location where the book can be found. |
* '''url''': An [[url]] of an online location where the book can be found. |
||
* '''archiveurl''': An [[url]] of an archived copy of the source url (for example via [[archive.org]] or [[WebCite]]). Use with archivedate. |
* '''archiveurl''': An [[url]] of an archived copy of the source url (for example via [[archive.org]] or [[WebCite]]). Use with archivedate. |
||
* '''archivedate''': Date of retrieval by the archiving service. Use with archiveurl. |
* '''archivedate''': Date<ref group="n" name="dates" /> of retrieval by the archiving service. Use with archiveurl. |
||
* '''accessdate''': Date when the url was accessed. |
* '''accessdate''': Date<ref group="n" name="dates" /> when the url was accessed. Accessdate should not be used for online versions of print publications. |
||
* '''separator''': specifies the punctuation mark used to separate certain fields. This defaults to a comma; the 'Cite xxx' family of templates uses a period. |
* '''separator''': specifies the punctuation mark used to separate certain fields. This defaults to a comma; the 'Cite xxx' family of templates uses a period. |
||
* '''laysummary''': URL of a lay summary, which could be in a popular science magazine or newspaper. |
* '''laysummary''': URL of a lay summary, which could be in a popular science magazine or newspaper. |
||
* '''laydate''': The date of publication or, where this is not available, date of retrieval of the lay summary. |
* '''laydate''': The date<ref group="n" name="dates" /> of publication or, where this is not available, date of retrieval of the lay summary. |
||
* '''postscript''': Set terminal punctuation. Leave blank to remove the trailing full stop. Punctuation specified by this parameter will appear within the cite span, and consequently before any icons added by metadata-using software (e.g. library browser plugins). Hence this parameter should be used instead of manually appending data to the citation. |
* '''postscript''': Set terminal punctuation. Leave blank to remove the trailing full stop. Punctuation specified by this parameter will appear within the cite span, and consequently before any icons added by metadata-using software (e.g. library browser plugins). Hence this parameter should be used instead of manually appending data to the citation. |
||
* '''lastauthoramp''': If supplied, whether or not assigned a value, places an ampersand (&) before the last name of final author, if more than one author is supplied. Recommended usage is ''lastauthoramp=yes''. |
* '''lastauthoramp''': If supplied, whether or not assigned a value, places an ampersand (&) before the last name of final author, if more than one author is supplied. Recommended usage is ''lastauthoramp=yes''. |
||
Line 116: | Line 117: | ||
| year=1851 |
| year=1851 |
||
| url = http://olivercowdery.com/texts/1851Trn1.htm#turn1851 |
| url = http://olivercowdery.com/texts/1851Trn1.htm#turn1851 |
||
| accessdate = January 1, 2008 |
|||
}} |
}} |
||
</pre> |
</pre> |
||
Line 127: | Line 127: | ||
| year=1851 |
| year=1851 |
||
| url = http://olivercowdery.com/texts/1851Trn1.htm#turn1851 |
| url = http://olivercowdery.com/texts/1851Trn1.htm#turn1851 |
||
| accessdate = 2008-01-28 |
|||
}} |
}} |
||
|- |
|- |
||
Line 206: | Line 205: | ||
* '''author2''', '''author3''', '''author4''', ..., '''author9''': Additional (up to nine) authors' names, if applicable. |
* '''author2''', '''author3''', '''author4''', ..., '''author9''': Additional (up to nine) authors' names, if applicable. |
||
* '''author2-link''', '''author3-link''', '''author4-link''', ..., '''author9-link''': Title of an existing Wikipedia article about additional (up to nine) authors, if applicable. |
* '''author2-link''', '''author3-link''', '''author4-link''', ..., '''author9-link''': Title of an existing Wikipedia article about additional (up to nine) authors, if applicable. |
||
* '''publication-date''' (or '''date'''): Date of publication. |
* '''publication-date''' (or '''date'''): Date<ref group="n" name="dates" /> of publication. |
||
* '''date''': Date of authorship, if different from date of publication. This is most useful in older newspapers where days or weeks could pass between authorship and publication. If only ''date'' is used, it will be treated as the date of publication. |
* '''date''': Date of authorship, if different from date of publication. This is most useful in older newspapers where days or weeks could pass between authorship and publication. If only ''date'' is used, it will be treated as the date of publication. |
||
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full date.) |
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full date.) |
||
Line 226: | Line 225: | ||
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
||
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
||
* '''accessdate''': Date when the url was accessed. |
* '''accessdate''': Date<ref group="n" name="dates" /> when the url was accessed. Accessdate should not be used for online versions of print publications. |
||
|} |
|} |
||
Line 345: | Line 344: | ||
* '''author2-link''', '''author3-link''', '''author4-link''': Title of an existing Wikipedia article about the second, third, and fourth author, if applicable. |
* '''author2-link''', '''author3-link''', '''author4-link''': Title of an existing Wikipedia article about the second, third, and fourth author, if applicable. |
||
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full date.) |
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full date.) |
||
* '''date''': Date of authorship or publication. |
* '''date''': Date<ref group="n" name="dates" /> of authorship or publication. |
||
* '''publication-date''': Date of publication (if different than ''date''). |
* '''publication-date''': Date<ref group="n" name="dates" /> of publication (if different than ''date''). |
||
* '''contribution''' (or '''chapter'''): Title of the contribution or chapter. |
* '''contribution''' (or '''chapter'''): Title of the contribution or chapter. |
||
* '''contribution-url''' (or '''chapter-url'''): URL of the contribution or chapter. |
* '''contribution-url''' (or '''chapter-url'''): URL of the contribution or chapter. |
||
Line 366: | Line 365: | ||
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
||
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
||
* '''url''': An [[url]] of an online location where the |
* '''url''': An [[url]] of an online location where the source being cited can be found. |
||
* '''accessdate''': Date when the url was accessed |
* '''accessdate''': Date<ref group="n" name="dates" /> when the url was accessed. The access date is only shown if "{{para|url}}" is used. The "{{para|accessdate}}" has no effect if "{{para|contribution-url}}" is used. Accessdate should not be used for resources that are known to have appeared in print. |
||
|} |
|} |
||
Line 571: | Line 570: | ||
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' (superfluous when ISBN is given). |
||
* '''url''': An [[url]] of an online location where the book or compilation can be found. |
* '''url''': An [[url]] of an online location where the book or compilation can be found. |
||
* '''accessdate''': Date when the url was accessed. |
* '''accessdate''': Date<ref group="n" name="dates" /> when the url was accessed. Accessdate should not be used for online versions of print publications. |
||
|} |
|} |
||
Line 718: | Line 717: | ||
==Dates== |
==Dates== |
||
<references group="n"><ref name="dates" group="n"> |
|||
The [[Wikipedia:Manual of Style (dates and numbers)|Manual of Style]] states that linking of dates purely for the purpose of auto-formatting is now deprecated, so the '''date''' and '''publication-date''' parameters should use one of the following formats |
The [[Wikipedia:Manual of Style (dates and numbers)|Manual of Style]] states that linking of dates purely for the purpose of auto-formatting is now deprecated, so the '''date''' and '''publication-date''' parameters [[WP:MOSDATE#Full_date_formatting|should use]] one of the following formats |
||
*''date=February 14, 1990'' (comma required) |
*''date=February 14, 1990'' (comma required) |
||
*''date=14 February 1990'' |
*''date=14 February 1990'' |
||
Line 725: | Line 724: | ||
*''date=1990'' |
*''date=1990'' |
||
Ideally the format of all dates in the references of an article should uses a consistent style. |
Ideally the format of all dates in the references of an article should uses a consistent style. |
||
</ref></references> |
|||
==Tools== |
==Tools== |
Revision as of 11:16, 23 September 2009
![]() | This is a documentation subpage for Template:Citation It may contain usage information, categories and other content that is not part of the original template page. |
The Citation template is a versatile template for citing books, periodicals, contributions in collective works, patents, and web-sites. Its goal is to be an all-purpose citation template. It also has functionality to aid the use of the Harvard referencing style. The template allows author-date "(Harvard)" citations in the main body of text to link to a full citation (generated by this template) in a "References" section at the end of the article via the Template:Harvard citation template. This template creates an HTML anchor, linked by #CITEREF followed by up to 4 author/editor last names and the date, to which the Harvard citation and related templates can link.
The template knows whether you are citing a book, periodical, or a chapter in a compilation, depending on which combination of parameters you use. For use with author-date systems such as the Harvard citation template, use of last and date parameters should be considered compulsory, where possible.
This template produces equivalent output to the "Cite" templates. You can use it as a synonym for {{cite journal}}, {{cite book}}, {{cite paper}}, and the same output as {{cite news}}, {{cite web}}, {{cite encyclopedia}}, and {{cite mailing list}} can be obtained using different parameter names. You may wish to change the format of punctuation marks using the |separator=
parameter.
All field names must be lowercase.
Citing books
Parameters (all are optional)
{{citation |last= |first= |author= |authorlink= |coauthors= |firstn=,lastn=,authorn= |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_brokendate= |bibcode= |id= |page= |pages= |nopp= |chapter= |chapterurl= |quote= |ref= |laysummary= |laydate= |separator= |postscript= |lastauthoramp= }} |
|
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 = | url = | archiveurl = | archivedate = | issn = | pmid = | pmc = | doi = | oclc = | accessdate = }} |
|
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 = }} |
|
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 = }} |
|
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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 }} |
Lua error: bad argument #1 to "get" (not a valid title). |
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}} |
Lua error: bad argument #1 to "get" (not a valid title). |
Dates
- ↑ 1.00 1.01 1.02 1.03 1.04 1.05 1.06 1.07 1.08 1.09 1.10 1.11
The Manual of Style states that linking of dates purely for the purpose of auto-formatting is now deprecated, so the date and publication-date parameters should use one of the following formats
- date=February 14, 1990 (comma required)
- date=14 February 1990
- date=February 1990
- date=1990
Tools
See Wikipedia:Citing sources for a list of tools which can help create a reference in the 'citation' format.
COinS
This template produces COinS metadata; see COinS in Wikipedia for background information.
Additional Parameters