View source for Template:Cite journal/doc

{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
'''Cite journal''' is for formatting references to articles in magazines and academic journals and for academic papers in a consistent and legible manner. It can be used at the end of the article, directly in the References section. It can also be placed within {{tag|ref}} tags for in-line citations. {{selfref|See also: [[Wikipedia:Footnotes]].|inline}}

==Usage==
All field names '''must''' be [[lowercase]]. Unused fields should be removed, rather than left blank.
===Parameters===
;Common parameters, horizontal format
<code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |year= |title= |journal= |publisher= |volume= |issue= |pages= |url= |doi= }}</nowiki></code>

;Common parameters for [[Vancouver system]] citations
<code><nowiki>{{cite journal |author= |year= |title= |journal= |publisher= |volume= |issue= |pages= |url= |doi= |pmid= |pmc= }}</nowiki></code>

;All parameters, horizontal format
<code><nowiki>{{cite journal |last= |first= |author= |authorlink= |coauthors= |editor1-first= |editor1-last= |editor1-link= |date= |year= |month= |title= |trans_title= |journal= |volume= |series= |issue= |page= |pages= |at= |publisher= |location= |issn= |pmid= |pmc= |doi= |bibcode= |oclc= |id= |url= |language= |format= |archiveurl= |archivedate= |accessdate= |laysummary= |laysource= |laydate= |quote= |ref= |separator= |postscript= }}</nowiki></code>
{{break|2}}
{| cellpadding="5" cellspacing="6"
! Using lastname, firstname !! Using author
|- width="50%"
|
<pre>
{{cite journal
| last        = 
| first       = 
| authorlink  = 
| coauthors   = 
| editor-last =
| editor-first=
| editor-link =
| date        = 
| year        = 
| month       = 
| title       = 
| trans_title = 
| journal     = 
| volume      = 
| issue       = 
| series      = 
| pages       = 
| publisher   = 
| location    = 
| issn        = 
| pmid        = 
| pmc         = 
| doi         = 
| bibcode     = 
| oclc        = 
| id          = 
| url         = 
| language    = 
| format      = 
| archiveurl  = 
| archivedate = 
| accessdate  = 
| laysummary  = 
| laysource   = 
| laydate     = 
| quote       = 
| ref         = 
| separator   = 
| postscript  = 
}}</pre>
| style="vertical-align: top;" |
<pre>
{{cite journal
| author      = 
| editor      =
| date        = 
| year        = 
| month       = 
| title       = 
| trans_title = 
| journal     = 
| volume      = 
| issue       = 
| series      = 
| pages       = 
| publisher   = 
| location    = 
| issn        = 
| pmid        = 
| pmc         = 
| doi         = 
| bibcode     = 
| oclc        = 
| id          = 
| url         = 
| language    = 
| format      = 
| archiveurl  = 
| archivedate = 
| accessdate  = 
| laysummary  = 
| laysource   = 
| laydate     = 
| quote       = 
| ref         = 
| separator   = 
| postscript  = 
}}</pre>
|}

;Result (using lastname, firstname):

{{cite journal
| last        =last
| first       =first
| authorlink  =authorlink
| coauthors   =coauthors
| editor-last =editor-last
| editor-first=editor-first
| editor-link =editor-link
| date        =date
| year        =year
| month       =month
| title       =title
| trans_title =trans_title
| journal     =journal
| volume      =volume
| issue       =issue
| series      =series
| pages       =pages
| publisher   =publisher
| location    =location
| issn        =issn
| pmid        =pmid
| pmc         =pmc
| doi         =doi
| bibcode     =bibcode
| oclc        =oclc
| id          =id
| url         =url
| language    =language
| format      =format
| archiveurl  =archiveurl
| archivedate =archivedate
| accessdate  =accessdate
| laysummary  =laysummary
| laysource   =laysource
| laydate     =laydate
| quote       =quote
| ref         =ref
| postscript  =postscript
}}


;Result (using author):

{{cite journal
| author      =author
| editor      =editor
| date        =date
| year        =year
| month       =month
| title       =title
| trans_title =trans_title
| journal     =journal
| volume      =volume
| issue       =issue
| pages       =pages
| publisher   =publisher
| location    =location
| issn        =issn
| pmid        =pmid
| pmc         =pmc
| doi         =doi
| bibcode     =bibcode
| oclc        =oclc
| id          =id
| url         =url
| language    =language
| format      =format
| archiveurl  =archiveurl
| archivedate =archivedate
| accessdate  =accessdate
| laysummary  =laysummary
| laysource   =laysource
| laydate     =laydate
| quote       =quote
| ref         =ref1
| postscript  =postscript
}}

===Legend===
{{Citation parameter legend |trans_title=yes }}
*'''editor''': Name of editor/editors. Do not Wikilink any values in the editor field but use ''editor-link'' instead. The template automatically adds "ed." after the editor's name unless the ''chapter'' parameter is used in which case the template adds "in" before the editor's name which appears after the chapter and before the title. This implies that the author is responsible only for part of the book (including the cited chapter) and the editor responsible for the whole book. If, however, the author(s) and editor(s) are responsible for the whole book, then the ''editor'' field or its alternates described below should not be used if the ''chapter'' field is being used. Instead, the editor(s) should be included in an ''author'' field with possibly "(ed.)" after the surname(s). Alternatively, the ''editor'' field may be used if the chapter detail is included in the ''title'' field instead of using the ''chapter'' field.
*OR: alternatively '''editor-first''' and '''editor-last''' can be used in the same way as ''first'' and ''last''.
*OR: for multiple editors up to four in number, use the fields '''editor1-first''', '''editor1-last''', ...,<b>editor''n''-first, editor''n''-last</b> to 'correctly' record all the information about the book in the same way as ''first''n and ''last''n.
**'''editor-link''' or '''editor1-link'''...<b>editor''n''-link</b> is used in the same way as ''authorlink'' or ''authorlink''n.
*'''separator''': The separator to use in lists of authors, editors, ''etc''.  Defaults to ".", but "," may be useful also. If the field is present, but blank, ''no separator will be used''.
* archive parameters ''(if used, must be used both of them together)''
** '''archiveurl''': The URL of an [[Web archiving|archived]] copy of the page, if (or in case) the url becomes unavailable.  Typically used to refer to services like [[WebCite]] and [[Internet Archive|Archive.org]].
** '''archivedate''': Date when the item was archived. Should not be wikilinked.

==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.

==Examples==
;Formal citation
:<code><nowiki>
{{cite journal
|last=Smith
|first=Joseph III
|title=Last Testimony of Sister Emma
|journal=The Saints' Herald
|volume=26
|year=1879
|month=October
|page=289}}
</nowiki></code>
:→ {{cite journal
|last=Smith
|first=Joseph III
|title=Last Testimony of Sister Emma
|journal=The Saints' Herald
|volume=26
|year=1879
|month=October
|page=289}}

; Vancouver style (common in biomedicine):
:<code><nowiki>{{cite journal |author=Bannen RM, Suresh V, Phillips GN Jr, Wright SJ, Mitchell JC |title=Optimal design of thermally stable proteins |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |year=2008 |pmid=18723523 |pmc=2562006 |doi=10.1093/bioinformatics/btn450 |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 }}</nowiki></code>
:→ {{cite journal |author=Bannen RM, Suresh V, Phillips GN Jr, Wright SJ, Mitchell JC |title=Optimal design of thermally stable proteins |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–43 |year=2008 |pmid=18723523 |pmc=2562006 |doi=10.1093/bioinformatics/btn450 |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 }}

;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 |journal= Energy Policy |year=2008 |volume=36 |issue=6 |pages=1858–1866 |title= Effect of daylight saving time on lighting energy use: a literature review |author= Myriam B.C. Aries; Guy R. Newsham |doi=10.1016/j.enpol.2007.05.021 |url=http://www.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |accessdate=2009-09-01 }}
</nowiki></code>
:→ {{cite journal |journal= Energy Policy |year=2008 |volume=36 |issue=6 |pages=1858–1866 |title= Effect of daylight saving time on lighting energy use: a literature review |author= Myriam B.C. Aries; Guy R. Newsham |doi=10.1016/j.enpol.2007.05.021 |url=http://www.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |accessdate=2009-09-01 }}

;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
|author=Viollet B; Andreelli F; Jørgensen SB ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|url=http://www.jci.org/articles/view/16567}}
</nowiki></code>
:→ {{cite journal
|author=Viollet B, Andreelli F, Jørgensen SB, ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|url=http://www.jci.org/articles/view/16567}}

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:
:<code><nowiki>
{{cite journal
|author=Viollet B, Andreelli F, Jørgensen SB, ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|url=}}
</nowiki></code>
:→ {{cite journal
|author=Viollet B, Andreelli F, Jørgensen SB, ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|url=}}

If the doi link is broken, then use of the doi_brokendate parameter 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":
:<code><nowiki>
{{cite journal
|author=Viollet B, Andreelli F, Jørgensen SB, ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|doi_brokendate=2008-06-18
|url=}}
</nowiki></code>
:→ {{cite journal
|author=Viollet B, Andreelli F, Jørgensen SB, ''et al''
|title=The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity
|journal=J. Clin. Invest.
|volume=111
|issue=1
|pages=91–8
|year=2003
|month=January
|pmid=12511592
|pmc=151837
|doi=10.1172/JCI16567
|doi_brokendate=2008-06-18
|url=}}

;If the article is in a foreign language, and the original title is unknown:
:<code><nowiki>
{{cite journal |author=Huang Y, Lu J, Shen Y, Lu J |trans_title=The protective effects of total flavonoids from Lycium Barbarum L. on lipid peroxidation of liver mitochondria and red blood cell in rats |language=Chinese |journal=Wei Sheng Yan Jiu |volume=28 |issue=2 |pages=115–6 |year=1999 |month=March |pmid=11938998}}
</nowiki></code>
:→ {{cite journal |author=Huang Y, Lu J, Shen Y, Lu J |trans_title=The protective effects of total flavonoids from Lycium Barbarum L. on lipid peroxidation of liver mitochondria and red blood cell in rats |language=Chinese |journal=Wei Sheng Yan Jiu |volume=28 |issue=2 |pages=115–6 |year=1999 |month=March |pmid=11938998}}

;Other examples
*<code><nowiki>
{{cite journal
|last=Fowler
|first=Martin
|authorlink=Martin Fowler
|coauthors=Kent Beck
|title=Last Testimony of Sister Emma
|journal=The Saints' Herald
|volume=26
|year=1879
|month=October
|pages=289}}
</nowiki></code>
:→ {{cite journal
|last=Fowler
|first=Martin
|authorlink=Martin Fowler
|coauthors=Kent Beck
|title=Last Testimony of Sister Emma
|journal=The Saints' Herald
|volume=26
|year=1879
|month=October
|pages=289}}

*<code><nowiki>
{{cite journal
|first=W. Hugh
|last=Woodin
|title=The Continuum Hypothesis, Part I
|journal=Notices of the AMS
|volume=48
|issue=6
|year=2001
|pages=567–576
|location=Providence, RI
|publisher=American Mathematical Society
|url=http://www.ams.org/notices/200106/fea-woodin.pdf
|format=PDF
|issn=1088-9477
|oclc=34550461}}
</nowiki></code>
:→ {{cite journal
|first=W. Hugh
|last=Woodin
|title=The Continuum Hypothesis, Part I
|journal=Notices of the AMS
|volume=48
|issue=6
|year=2001
|pages=567–576
|location=Providence, RI
|publisher=American Mathematical Society
|url=http://www.ams.org/notices/200106/fea-woodin.pdf
|format=PDF
|issn=1088–9477
|oclc=34550461}}
*<code><nowiki>{{cite journal
|title=Disney Releases 10 Titles on Laser Videodisc
|year=1982
|journal=VIDEODISC/VIDEOTEX
|volume=2
|issue=3
|pages=175}}</nowiki></code>
:→ {{cite journal
|title=Disney Releases 10 Titles on Laser Videodisc
|year=1982
|journal=VIDEODISC/VIDEOTEX
|volume=2
|issue=3
|pages=175}}

==COinS==
{{UF-COinS}}

==Aliases==
These templates have been merged into this template and are now redirects:
* {{tl|Citepaper}}
* {{tl|Cite journal2}}
* {{tl|Cite paper}}
* {{tl|Cite magazine}}
* {{tl|Cite magazine article}}

These templates are redirects:
* {{tl|Cite Journal}}
* {{tl|Citejournal}}

==See also==
* [[User:Citation bot|Citation bot]] 
* [[Wikipedia:Citation templates|Citation templates]]
* [[Wikipedia:Citing sources|Citing sources]]
* [[Wikipedia:Citing sources/example style|Citing sources/example style]]
* [[WP:DOI|Digital Object Identifier]] 
* [[Template:Cite book]]
* [[Template:Cite web]]
* [[Zotero]] 

==External links==
* [[User:badgettrg|badgettrg]]'s [http://clinical.uthscsa.edu/cite/ Citation maker] for journals indexed by PubMed using PMID, PMC, or DOIs. Bookmarklet is available.
* The [http://toolserver.org/~verisimilus/Scholar/ Universal Citation Assistant] – can either find articles using the built-in [[Google Scholar]] interface, automatically produce an appropriate cite template or produce a template from a DOI, PMID or PMC identifier.
* [[User:Diberri|Diberri]]'s [http://toolserver.org/~diberri/cgi-bin/templatefiller/ Wikipedia template filling tool] - will generate cite journal templates from [[PMID]] or [[PubMed Central|PMC]] values, as well as cite book, cite web and various infobox templates (offline 9/2009).
* http://toolserver.org/~holek/cite-gen/index.php