Template:Cite journal/doc: Difference between revisions
(→Usage: standardize formatting) |
(author parameters with authors, fix formatting) |
||
Line 1: | Line 1: | ||
{{Documentation subpage}} |
|||
{{csdoc|lua}} |
|||
{{csdoc|cs1}} |
|||
{{csdoc|lead|articles in magazines, journals, newsletters, and for academic papers}} |
|||
==Usage== |
==Usage== |
||
{{csdoc|usage}} |
{{csdoc|usage}} |
||
Line 20: | Line 14: | ||
or |
or |
||
<br /> |
<br /> |
||
<code><nowiki>{{cite journal |last= |first= |last2= |first2= |year= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= |
<code><nowiki>{{cite journal |last= |first= |last2= |first2= |authorformat=vanc |author-separator=, |author-name-separator=&#32; |year= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= }}</nowiki></code> |
||
<br /> |
<br /> |
||
;Vancouver system citation of a scientific journal - Day, Month, Year |
;Vancouver system citation of a scientific journal - Day, Month, Year |
||
<code><nowiki>{{cite journal |author= |date= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= }}</nowiki> |
<code><nowiki>{{cite journal |author= |date= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= }}</nowiki></code> |
||
<br />or |
|||
<br /> |
<br /> |
||
or |
|||
<code><nowiki>{{cite journal |last= |first= |last2= |first2= |date= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= |authorformat=vanc |author-separator=, |author-name-separator=&#32; }}</nowiki></code> |
|||
<br /> |
|||
<code><nowiki>{{cite journal |last= |first= |last2= |first2= |authorformat=vanc |author-separator=, |author-name-separator=&#32; |date= |title= |url= |journal= |publisher= |volume= |issue= |pages= |doi= |pmc= |pmid= }}</nowiki></code> |
|||
<br /> |
<br /> |
||
;To cite a magazine article with a credited author |
;To cite a magazine article with a credited author |
||
Line 68: | Line 63: | ||
}} |
}} |
||
</pre> |
</pre> |
||
; |
;Vancouver system citation of a scientific journal (last, first) |
||
<pre style="margin:0px;"> |
<pre style="margin:0px;"> |
||
{{cite journal |
{{cite journal |
||
| last = |
| last = |
||
| first = |
| first = |
||
| last2 = |
| last2 = |
||
| first2 = |
| first2 = |
||
| |
| authorformat = vanc |
||
| |
| author-separator = , |
||
| author-name-separator = &#32; |
|||
| url = |
|||
| |
| date = |
||
| |
| title = |
||
| |
| url = |
||
| |
| journal = |
||
| |
| publisher = |
||
| |
| volume = |
||
| |
| issue = |
||
| |
| pages = |
||
| doi = |
|||
| authorformat = vanc |
|||
| pmc = |
|||
| author-separator=, |
|||
| pmid = |
|||
| author-name-separator = &#32; }} |
|||
}} |
|||
</pre> |
</pre> |
||
;Vancouver system citation of a scientific journal (author) |
|||
<br />or |
|||
<pre style="margin:0px;"> |
<pre style="margin:0px;"> |
||
{{cite journal |
{{cite journal |
||
Line 124: | Line 120: | ||
<pre style="margin:0px;"> |
<pre style="margin:0px;"> |
||
{{cite journal |
{{cite journal |
||
| author =<!--Staff writer(s); no by-line.--> |
| author = <!--Staff writer(s); no by-line.--> |
||
| title = |
| title = |
||
| url = |
| url = |
||
Line 665: | Line 661: | ||
}} |
}} |
||
--> |
--> |
||
==Examples== |
|||
;Formal citation |
|||
<code><nowiki> |
|||
{{cite journal |last=Smith |first=Joseph III |date=October 1879 |title=Last Testimony of Sister Emma |journal=The Saints' Herald |volume=26 |page=289}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Smith |first=Joseph III |date=October 1879 |title=Last Testimony of Sister Emma |journal=The Saints' Herald |volume=26 |page=289}} |
|||
<br /> |
|||
;Vancouver style (common in biomedicine); see {{vcite}} for specific templates |
|||
<code><nowiki> |
|||
{{cite journal |author=Bannen R, Suresh V, Phillips GJ, Wright S, Mitchell J |year=2008 |title=Optimal design of thermally stable proteins |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |doi=10.1093/bioinformatics/btn450 |pmc=2562006 |pmid=18723523 }} |
|||
</nowiki></code> |
|||
<br /> or |
|||
<br /> |
|||
<code><nowiki> |
|||
{{cite journal |last=Bannen |first=RM |last2=Suresh |first2=V |last3=Phillips |first3=GN Jr |last4=Wright |first4=SJ |last5=Mitchell |first5=JC |year=2008 |title=Optimal design of thermally stable proteins |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |doi=10.1093/bioinformatics/btn450 |pmc=2562006 |pmid=18723523 | authorformat = vanc | author-separator=, | author-name-separator =   }} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |author=Bannen R, Suresh V, Phillips GJ, Wright S, Mitchell J |year=2008 |title=Optimal design of thermally stable proteins |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |doi=10.1093/bioinformatics/btn450 |pmc=2562006 |pmid=18723523 }} |
|||
<br /> |
|||
;Include URL link to free-article, pre-print or abstract; also supply access date unless the URL is known to be stable. |
|||
<code><nowiki>{{cite journal |last=Aries |first=Myriam B. C. |last2=Newsham |first2=Guy R. |lastauthoramp=yes |year=2008 |title=Effect of daylight saving time on lighting energy use: a literature review |url=http://archive.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |journal=Energy Policy |volume=36 |issue=6 |pages=1858–1866 |doi=10.1016/j.enpol.2007.05.021 |accessdate=October 18, 2013}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Aries |first=Myriam B. C. |last2=Newsham |first2=Guy R. |lastauthoramp=yes |year=2008 |title=Effect of daylight saving time on lighting energy use: a literature review |url=http://archive.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |journal=Energy Policy |volume=36 |issue=6 |pages=1858–1866 |doi=10.1016/j.enpol.2007.05.021 |accessdate=October 18, 2013}} |
|||
<br /> |
|||
;Specify the [[Digital object identifier|DOI]] to provide a permanent link. Also give the [[PMID]] abstract for medical articles, and the URL if the article is free. [[PubMed Central]] free full-text repository links may also be supplied and will link the title if URL not specified, else as additional linked PMC value at the end of the citation |
|||
<code><nowiki> |
|||
{{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |url=http://www.jci.org/articles/view/16567 |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |pmc=151837 |pmid=12511592 |accessdate=2012-11-17}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |url=http://www.jci.org/articles/view/16567 |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |pmc=151837 |pmid=12511592 |accessdate=2012-11-17}} |
|||
<br /> |
|||
Whereas if the url had not been specified, then the title is linked to PubMed Central's copy of the article and no duplicate PMC link is shown for compactness:<br /> |
|||
<code><nowiki> |
|||
{{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |pmc=151837 |pmid=12511592}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |pmc=151837 |pmid=12511592}} |
|||
<br /> |
|||
If the doi link is broken, then use of '''doi_brokendate''' unlinks the doi value, indicates when the doi-problem was first noticed, and will also add the page to "Category:Pages with DOIs broken since YYYY":<br /> |
|||
<code><nowiki> |
|||
{{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |doi_brokendate=June 18, 2008 |pmc=151837 |pmid=12511592}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F.P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–8 |doi=10.1172/JCI16567 |doi_brokendate=June 18, 2008 |pmc=151837 |pmid=12511592}} |
|||
<br /> |
|||
;If the article is in a foreign language, and the original title is unknown |
|||
Enclose the translated title in square brackets and use {{para|title}}. |
|||
*<code><nowiki> |
|||
{{cite journal |last=Huang |first=Y. |last2=Lu |first2=J. |last3=Shen |first3=Y. |last4=Lu |first4=J. |lastauthoramp=yes |date=March 1999 |title=[The protective effects of total flavonoids from Lycium Barbarum L. on lipid peroxidation of liver mitochondria and red blood cell in rats] |journal=Wei Sheng Yan Jiu |language=Chinese |volume=28 |issue=2 |pages=115–6 |pmid=11938998}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
:{{cite journal |last=Huang |first=Y. |last2=Lu |first2=J. |last3=Shen |first3=Y. |last4=Lu |first4=J. |lastauthoramp=yes |date=March 1999 |title=[The protective effects of total flavonoids from Lycium Barbarum L. on lipid peroxidation of liver mitochondria and red blood cell in rats] |journal=Wei Sheng Yan Jiu |language=Chinese |volume=28 |issue=2 |pages=115–6 |pmid=11938998}} |
|||
<br /> |
|||
;Other examples |
|||
<code><nowiki>{{cite journal |last=Smith |first=Joseph III |authorlink=Joseph Smith |date=October 1879 |title=Last Testimony of Sister Emma |journal=The Saints' Herald |volume=26 |page=289}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Smith |first=Joseph III |authorlink=Joseph Smith |date=October 1879 |title=Last Testimony of Sister Emma |journal=The Saints' Herald |volume=26 |page=289}} |
|||
<br /> |
|||
<code><nowiki>{{cite journal |last=Woodin |first=W. Hugh |year=2001 |title=The Continuum Hypothesis, Part I |url=http://www.ams.org/notices/200106/fea-woodin.pdf |format=PDF |journal=Notices of the AMS |location=Providence, Rhode Island, United States |publisher=American Mathematical Society |volume=48 |issue=6 |pages=567–576 |issn=1088-9477 |oclc=34550461}} |
|||
</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |last=Woodin |first=W. Hugh |year=2001 |title=The Continuum Hypothesis, Part I |url=http://www.ams.org/notices/200106/fea-woodin.pdf |format=PDF |journal=Notices of the AMS |location=Providence, Rhode Island, United States |publisher=American Mathematical Society |volume=48 |issue=6 |pages=567–576 |issn=1088-9477 |oclc=34550461}} |
|||
<br /> |
|||
<code><nowiki>{{cite journal |title=Disney Releases 10 Titles on Laser Videodisc |journal=Videodisc/Videotex |volume=2 |issue=3 |page=175 |year=1982}}</nowiki></code> |
|||
:Displays as: |
|||
* {{cite journal |title=Disney Releases 10 Titles on Laser Videodisc |journal=Videodisc/Videotex |volume=2 |issue=3 |page=175 |year=1982}} |
|||
==Parameters== |
|||
===Syntax=== |
|||
{{csdoc|syntax}} |
|||
{{csdoc|coins}} |
|||
{{csdoc|sep_period}} |
|||
===Deprecated=== |
|||
{{csdoc|deprecated}} |
|||
===Description=== |
|||
====Authors==== |
|||
{{csdoc|author|coauthors=yes|others=yes|lua=yes}} |
|||
====Date==== |
|||
{{csdoc|date|lua=yes}} |
|||
====Editors==== |
|||
{{csdoc|editor|lua=yes}} |
|||
====Title==== |
|||
{{csdoc|title|title_format=quotes}} |
|||
{{csdoc|language|lua=yes}} |
|||
====URL==== |
|||
{{csdoc|url|pmc=yes}} |
|||
====Periodical==== |
|||
{{csdoc|journal|department=yes}} |
|||
====Publisher==== |
|||
{{csdoc|publisher}} |
|||
====Edition, series, volume==== |
|||
{{csdoc|edition}} |
|||
{{csdoc|series}} |
|||
{{csdoc|volume}} |
|||
====In-source locations==== |
|||
{{csdoc|pages|work=y|lua=yes}} |
|||
====Identifiers==== |
|||
{{csdoc|id1}} |
|||
{{csdoc|id2|lua=yes}} |
|||
====Subscription or registration required==== |
|||
{{csdoc|registration}} |
|||
====Laysummary==== |
|||
{{csdoc|lay|lua=yes}} |
|||
====Quote==== |
|||
{{csdoc|quote}} |
|||
====Anchor==== |
|||
{{csdoc|ref}} |
|||
====Display options==== |
|||
{{csdoc|display|lua=yes}} |
|||
==Notes== |
|||
Although it may appear redundant to include multiple ids for articles, it is helpful for many editors who only have access to a certain resource. If only one ID is to be included, the DOI should be used, as this is the universal standard preferred by professional publications. Specifying a link as a doi, pmid etc. is always preferable to including it as a url parameter, as it makes it clear that the link is accurate and stable, but not necessarily openly accessible. |
|||
==Template data== |
|||
{{TemplateDataHeader}} |
|||
<TemplateData> |
|||
{ |
|||
"description": "This template formats a citation to an article in a magazine or journal, using the provided source information (e.g. journal name, author, title, issue, URL) and various formatting options.", |
|||
"params": { |
|||
"url": { |
|||
"label": "URL", |
|||
"description": "The URL of the online location where the text of the publication can be found", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"title": { |
|||
"label": "Title", |
|||
"description": "The title of the article; can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Displays in quotes.", |
|||
"type": "string", |
|||
"required": true |
|||
}, |
|||
"last": { |
|||
"label": "Last name", |
|||
"description": "The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors", |
|||
"type": "string/line", |
|||
"aliases": ["last1","author","author1","authors"], |
|||
"required": false |
|||
}, |
|||
"first": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors", |
|||
"type": "string/line", |
|||
"aliases": ["first1"], |
|||
"required": false |
|||
}, |
|||
"authorlink": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["authorlink1","author-link", "author1-link"], |
|||
"required": false |
|||
}, |
|||
"last2": { |
|||
"label": "Last name", |
|||
"description": "The surname of the second author; don't wikilink, use 'authorlink2'.", |
|||
"type": "string/line", |
|||
"aliases": ["author2"], |
|||
"required": false |
|||
}, |
|||
"first2": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the second author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink2": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the second author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author2-link"], |
|||
"required": false |
|||
}, |
|||
"date": { |
|||
"label": "Source date", |
|||
"description": "Full date of the source; do not wikilink", |
|||
"type": "string", |
|||
"required": true |
|||
}, |
|||
"journal": { |
|||
"label": "Journal", |
|||
"description": "Name of the source journal; may be wikilinked; displays in italics; alias of 'work'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"publisher": { |
|||
"label": "Publisher", |
|||
"description": "Name of the publisher; displays after title", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"accessdate": { |
|||
"label": "URL access date", |
|||
"description": "The full date when the original URL was accessed; do not wikilink", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"issue": { |
|||
"label": "Issue", |
|||
"description": "", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"doi": { |
|||
"label": "DOI", |
|||
"description": "Digital Object Identifier; begins with '10.'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"doi_brokendate": { |
|||
"label": "DOI broken date", |
|||
"description": "The date that the DOI was determined to be broken", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"authorlink": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors", |
|||
"type": "string/wiki-page-name", |
|||
"required": false |
|||
}, |
|||
"others": { |
|||
"label": "Others", |
|||
"description": "Used to record other contributions to the work, such as 'Illustrated by John Smith' or 'Translated by John Smith'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"year": { |
|||
"label": "Year of publication", |
|||
"description": "Year of the source being referenced; use 'date' instead, if month or season is also known", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"origyear": { |
|||
"label": "Original year", |
|||
"description": "Original year of publication; provide specifics", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"editor-last": { |
|||
"label": "Editor last name", |
|||
"description": "The surname of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors; alias of 'editor1-last', 'editor', and 'editors'", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"editor-first": { |
|||
"label": "Editor first name", |
|||
"description": "Given or first name, middle names, or initials of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors; alias of 'editor1-first'", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"editor-link": { |
|||
"label": "Editor link", |
|||
"description": "Title of existing Wikipedia article about the editor; can suffix with a numeral to add additional editors; alias of 'editor1-link'", |
|||
"type": "string/wiki-page-name", |
|||
"required": false |
|||
}, |
|||
"series": { |
|||
"label": "Series", |
|||
"description": "Series identifier when the source is part of a series, such as a book series or a journal; alias of 'version'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"issue": { |
|||
"label": "Issue", |
|||
"description": "Issue identifier when the source is part of a series that is published periodically", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"department": { |
|||
"label": "Department", |
|||
"description": "Department within the periodical", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"location": { |
|||
"label": "Location of publication", |
|||
"description": "Geographical place of publication; usually not wikilinked; omit when the publication name includes place; alias of 'place'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"publication-place": { |
|||
"label": "Place of publication", |
|||
"description": "Publication place shows after title; if 'place' or 'location' are also given, they are displayed before the title prefixed with 'written at'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"publication-date": { |
|||
"label": "Publication date", |
|||
"description": "Date of publication when different from the date the work was written; do not wikilink", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"edition": { |
|||
"label": "Edition", |
|||
"description": "When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed with ' ed.'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"volume": { |
|||
"label": "Volume", |
|||
"description": "For one publication published in several volumes", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"page": { |
|||
"label": "Page", |
|||
"description": "Page in the source that supports the content; displays after 'p.'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"pages": { |
|||
"label": "Pages", |
|||
"description": "Pages in the source that support the content (not an indication of the number of pages in the source; displays after 'pp.'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"nopp": { |
|||
"label": "No pp", |
|||
"description": "Set to 'y' to suppress the 'p.' or 'pp.' display with 'page' or 'pages' when inappropriate (such as 'Front cover')", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"at": { |
|||
"label": "At", |
|||
"description": "May be used instead of 'page' or 'pages' where a page number is inappropriate or insufficient", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"language": { |
|||
"label": "Language", |
|||
"description": "The language in which the source is written, if not English; use the full language name; do not use icons or templates", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"trans_title": { |
|||
"label": "Translated title", |
|||
"description": "An English language title, if the source cited is in a foreign language; 'language' is recommended", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"type": { |
|||
"label": "Type", |
|||
"description": "Additional information about the media type of the source; format in sentence case", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"format": { |
|||
"label": "Format", |
|||
"description": "Format of the work referred to by 'url' ('url' is required when using 'format'); examples: PDF, DOC, XLS; do not specify HTML", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"arxiv": { |
|||
"label": "arXiv identifier", |
|||
"description": "An identifier for arXive electronic preprints of scientific papers", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"asin": { |
|||
"label": "AZIN", |
|||
"description": "Amazon Standard Identification Number; 10 characters", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"asin-tld": { |
|||
"label": "AZIN TLD", |
|||
"description": "ASIN top-level domain for Amazon sites other than the US", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"bibcode": { |
|||
"label": "Bibcode", |
|||
"description": "Bibliographic Reference Code (REFCODE); 19 characters", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"isbn": { |
|||
"label": "ISBN", |
|||
"description": "International Standard Book Number; use the 13-digit ISBN where possible", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"issn": { |
|||
"label": "ISSN", |
|||
"description": "International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"jfm": { |
|||
"label": "jfm code", |
|||
"description": "Jahrbuch über die Fortschritte der Mathematik classification code", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"jstor": { |
|||
"label": "JSTOR", |
|||
"description": "JSTOR identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"lccn": { |
|||
"label": "LCCN", |
|||
"description": "Library of Congress Control Number", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"mr": { |
|||
"label": "MR", |
|||
"description": "Mathematical Reviews identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"oclc": { |
|||
"label": "OCLC", |
|||
"description": "Online Computer Library Center number", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"ol": { |
|||
"label": "OL", |
|||
"description": "Open Library identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"osti": { |
|||
"label": "OSTI", |
|||
"description": "Office of Scientific and Technical Information identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"pmc": { |
|||
"label": "PMC", |
|||
"description": "PubMed Center article number", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"pmid": { |
|||
"label": "PMID", |
|||
"description": "PubMed Unique Identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"rfc": { |
|||
"label": "RFC", |
|||
"description": "Request for Comments number", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"ssrn": { |
|||
"label": "SSRN", |
|||
"description": "Social Science Research Network", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"zbl": { |
|||
"label": "Zbl", |
|||
"description": "Zentralblatt MATH journal identifier", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"id": { |
|||
"label": "id", |
|||
"description": "A unique identifier used where none of the specialized ones are applicable", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"archiveurl": { |
|||
"label": "Archive URL", |
|||
"description": "The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archivedate'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"archivedate": { |
|||
"label": "Archive date", |
|||
"description": "Date when the original URL was archived; do not wikilink", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"deadurl": { |
|||
"label": "Dead URL", |
|||
"description": "If set to 'no', the title display is adjusted; useful for when the URL is archived preemptively but still live", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"quote": { |
|||
"label": "Quote", |
|||
"description": "Relevant text quoted from the source; displays last, enclosed in quotes; needs to include terminating punctuation", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"ref": { |
|||
"label": "Ref", |
|||
"description": "An anchor identifier; can be made the target of wikilinks to full references; special value 'harv' generates an anchor suitable for the harv template", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"separator": { |
|||
"label": "Separator", |
|||
"description": "The punctuation used to separate lists of authors, editors, etc.; a space must be encoded as   do not use an asterisk, colon, or hash mark", |
|||
"type": "string", |
|||
"default": ".", |
|||
"required": false |
|||
}, |
|||
"postscript": { |
|||
"label": "Postscript", |
|||
"description": "The closing punctuation for the citation; ignored if 'quote' is defined", |
|||
"type": "string", |
|||
"default": ".", |
|||
"required": false |
|||
}, |
|||
"layurl": { |
|||
"label": "Lay URL", |
|||
"description": "URL link to a non-technical summary or review of the source; alias of 'laysummary'", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"laysource": { |
|||
"label": "Lay source", |
|||
"description": "Name of the source of the laysummary; displays in italics, preceded by an en dash", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"laydate": { |
|||
"label": "Lay date", |
|||
"description": "Date of the summary; displays in parentheses", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"last3": { |
|||
"label": "Last name", |
|||
"description": "The surname of the third author; don't wikilink, use 'authorlink3'.", |
|||
"type": "string/line", |
|||
"aliases": ["author3"], |
|||
"required": false |
|||
}, |
|||
"first3": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the third author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink3": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the third author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author3-link"], |
|||
"required": false |
|||
}, |
|||
"last4": { |
|||
"label": "Last name", |
|||
"description": "The surname of the forth author; don't wikilink, use 'authorlink4'.", |
|||
"type": "string/line", |
|||
"aliases": ["author4"], |
|||
"required": false |
|||
}, |
|||
"first4": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the forth author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink4": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the forth author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author4-link"], |
|||
"required": false |
|||
}, |
|||
"last5": { |
|||
"label": "Last name", |
|||
"description": "The surname of the fifth author; don't wikilink, use 'authorlink5'.", |
|||
"type": "string/line", |
|||
"aliases": ["author5"], |
|||
"required": false |
|||
}, |
|||
"first5": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the fifth author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink5": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the sixth author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author5-link"], |
|||
"required": false |
|||
}, |
|||
"last6": { |
|||
"label": "Last name", |
|||
"description": "The surname of the sixth author; don't wikilink, use 'authorlink6'.", |
|||
"type": "string/line", |
|||
"aliases": ["author6"], |
|||
"required": false |
|||
}, |
|||
"first6": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the sixth author; don't wikilink.", |
|||
"type": "string/line", |
|||
"aliases": ["author6-link"], |
|||
"required": false |
|||
}, |
|||
"authorlink6": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the sixth author.", |
|||
"type": "string/wiki-page-name", |
|||
"required": false |
|||
}, |
|||
"last7": { |
|||
"label": "Last name", |
|||
"description": "The surname of the seventh author; don't wikilink, use 'authorlink7'.", |
|||
"type": "string/line", |
|||
"aliases": ["author7"], |
|||
"required": false |
|||
}, |
|||
"first7": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the seventh author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink7": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the seventh author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author7-link"], |
|||
"required": false |
|||
}, |
|||
"last8": { |
|||
"label": "Last name", |
|||
"description": "The surname of the eighth author; don't wikilink, use 'authorlink8'.", |
|||
"type": "string/line", |
|||
"aliases": ["author8"], |
|||
"required": false |
|||
}, |
|||
"first8": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the eighth author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink8": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the eighth author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author8-link"], |
|||
"required": false |
|||
}, |
|||
"last9": { |
|||
"label": "Last name", |
|||
"description": "The surname of the ninth author; don't wikilink, use 'authorlink9'. If nine authors are defined, then only eight will show and 'et al.' will show in place of the last author.", |
|||
"type": "string/line", |
|||
"aliases": ["author9"], |
|||
"required": false |
|||
}, |
|||
"first9": { |
|||
"label": "First name", |
|||
"description": "Given or first name, middle names, or initials of the ninth author; don't wikilink.", |
|||
"type": "string/line", |
|||
"required": false |
|||
}, |
|||
"authorlink9": { |
|||
"label": "Author link", |
|||
"description": "Title of existing Wikipedia article about the ninth author.", |
|||
"type": "string/wiki-page-name", |
|||
"aliases": ["author9-link"], |
|||
"required": false |
|||
}, |
|||
"author-mask": { |
|||
"label": "Author mask", |
|||
"description": "Replaces the name of the first author with em dashes or text; set to a numeric value 'n' to set the dash 'n' em spaces wide; set to a text value to display the text without a trailing author separator; for example, 'with' instead", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"author-name-separator": { |
|||
"label": "Author name separator", |
|||
"description": "Changes the separator between last and first names; defaults to a comma and space; a space must be encoded as   do not use an asterisk, colon, or hash mark", |
|||
"type": "string", |
|||
"default": ", ", |
|||
"required": false |
|||
}, |
|||
"author-separator": { |
|||
"label": "Author separator", |
|||
"description": "Changes the separator between authors; defaults to a semicolon and space; a space must be encoded as   do not use an asterisk, colon, or hash mark", |
|||
"type": "string", |
|||
"default": "; ", |
|||
"required": false |
|||
}, |
|||
"display-authors": { |
|||
"label": "Display authors", |
|||
"description": "number of authors to display before 'et al.' is used; default is to do so after 8 of 9 are listed;", |
|||
"type": "number", |
|||
"default": "8", |
|||
"aliases": ["displayauthors"], |
|||
"required": false |
|||
}, |
|||
"lastauthoramp": { |
|||
"label": "Last author ampersand", |
|||
"description": "When set to any value, changes the separator between the last two names of the author list to 'space ampersand space'", |
|||
"type": "string", |
|||
"required": false |
|||
} |
|||
} |
|||
} |
|||
</TemplateData> |
|||
==Alternate usages== |
|||
If the work has any of the following identifiers, then one of these specific templates may be used: |
|||
* [[digital object identifier|DOI]]: {{tl|cite doi}} |
|||
* [[JSTOR]]: {{tl|cite jstor}} |
|||
* [[PubMed]]: {{tl|cite pmid}} |
|||
However, because these templates can be user-filled, they are prone to user error, and they generate a style that may not be compatible with other citations in the article (see [[WP:CITEVAR]]), so using the full cite journal template may be preferable, depending on the content area. For medical articles, [http://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi this citation-filling template] can be used to generate a cite journal template from a [[PubMed]] identified (PMID). |
|||
==See also== |
|||
{{Citation Style 1}} |
|||
{{Wikipedia referencing}} |
|||
{{UF-COinS}} |
|||
<includeonly> |
|||
[[Category:Citation Style 1 templates]] |
|||
</includeonly> |
Revision as of 23:11, 2 December 2013
Usage
Copy a blank version to use. Almost all parameter names are supported only in lower case (some initialisms, such as |isbn=
have upper-case aliases like |ISBN=
, which are acceptable for use). Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Some samples on this documentation page may include the current date. If the date is not current, then the page.
|
|
{{cite journal | last = | first = | last2 = | first2 = | date = | title = | url = | journal = | publisher = | volume = | issue = | pages = | doi = | accessdate = }}
{{cite journal | last = | first = | last2 = | first2 = | authorformat = vanc | author-separator = , | author-name-separator =   | date = | title = | url = | journal = | publisher = | volume = | issue = | pages = | doi = | pmc = | pmid = }}
{{cite journal | author = | date = | title = | url = | journal = | publisher = | volume = | issue = | pages = | doi = | pmc = | pmid = }}
{{cite journal | last = | first = | date = | title = | url = | journal = | location = | publisher = | accessdate = }}
{{cite journal | author = <!--Staff writer(s); no by-line.--> | title = | url = | journal = | location = | publisher = | date = | accessdate = }}
{{cite journal | last = | first = | date = | title = | url = | deadurl = | journal = | location = | publisher = | archiveurl = | archivedate = | accessdate = }}
{{cite journal | last = | first = | date = | title = | trans_title = | url = | language = | journal = | location = | publisher = | accessdate = }}
{{cite journal | last1 = | first1 = | last2 = | first2 = | date = | title = | trans_title = | url = | deadurl = | format = | language = | journal = | location = | publisher = | archiveurl = | archivedate = | accessdate = | via = | subscription = | quote = }} |
Lua error: expandTemplate: template "Citation Style documentation/usage vertical" does not exist.
{{cite journal | last1 = | first1 = | authorlink1 = | last2 = | first2 = | authorlink2 = | last3 = | first3 = | authorlink3 = | last4 = | first4 = | authorlink4 = | last5 = | first5 = | authorlink5 = | display-authors = | author-mask = | author-name-separator = | author-separator = | lastauthoramp = | date = | year = | origyear = | chapter = | chapterurl = | editor1-last = | editor1-first = | editor1-link = | editor2-last = | editor2-first = | editor2-link = | editor3-last = | editor3-first = | editor3-link = | editor4-last = | editor4-first = | editor4-link = | editor5-last = | editor5-first = | editor5-link = | displayeditors = | others = | title = | trans_title = | url = | deadurl = | format = | department = | journal = | type = | series = | language = | edition = | location = | publisher = | publication-date = | volume = | issue = | page = | pages = | at = | nopp = | arxiv = | asin = | bibcode = | doi = | doi_brokendate = | isbn = | issn = | jfm = | jstor = | lccn = | mr = | oclc = | ol = | osti = | pmc = | pmid = | rfc = | ssrn = | zbl = | id = | archiveurl = | archivedate = | accessdate = | via = | registration = | subscription = | layurl = | laysource = | laydate = | quote = | separator = | postscript = | ref = }}
Lua error: expandTemplate: template "Citation Style documentation/usage vertical mid" does not exist.
last or last1 first or first1 authorlink1 last2 first2 authorlink2 last3 first3 authorlink3 last4 first4 authorlink4 chapter editor1-last editor1-first editor1-link editor2-last editor2-first editor2-link editor3-last editor3-first editor3-link editor4-last editor4-first editor4-link title url url archiveurl
Lua error: expandTemplate: template "Citation Style documentation/usage vertical mid" does not exist.
Lua error: expandTemplate: template "Citation Style documentation/usage vertical end" does not exist.