Template:Documentation/docname

From Wikishire
Revision as of 16:44, 8 September 2010 by RB (talk | contribs) (Created page with '{{Documentation subpage}} <!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE --> '''Cite journal''' is for formatting references to articles in magazines and academic journals and …')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 Template:Tag tags for in-line citations. Template:Selfref

Usage

All field names must be lowercase. Unused fields should be removed, rather than left blank.

Parameters

Common parameters, horizontal format

{{cite journal |last1= |first1= |last2= |first2= |year= |title= |journal= |publisher= |volume= |issue= |pages= |url= |doi= }}

Common parameters for Vancouver system citations

{{cite journal |author= |year= |title= |journal= |publisher= |volume= |issue= |pages= |url= |doi= |pmid= |pmc= }}

All parameters, horizontal format

{{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= }} Template:Break

Using lastname, firstname Using author
{{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  = 
}}
{{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  = 
}}
Result (using lastname, firstname)

authorlink; coauthors (date). editor-last, editor-first. ed. [archiveurl "title [trans_title]"] (in language) (format). journal. series (location: publisher) volume (issue): pages. doi:doi. id. SSN issn. OCLC oclc. PMID pmid. PMC pmc. Bibcode: bibcode. Archived from [url the original] on archivedate. archiveurl. Retrieved accessdate. [laysummary Lay summary] – laysource (laydate). "quote"postscript 


Result (using author)

author (date). editor. ed. [archiveurl "title [trans_title]"] (in language) (format). journal (location: publisher) volume (issue): pages. doi:doi. id. SSN issn. OCLC oclc. PMID pmid. PMC pmc. Bibcode: bibcode. Archived from [url the original] on archivedate. archiveurl. Retrieved accessdate. [laysummary Lay summary] – laysource (laydate). "quote"postscript 

Legend

Template:Citation parameter legend

  • number: A synonym for the issue parameter, specific to the template {{cite journal}}.
  • 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, ...,editorn-first, editorn-last to 'correctly' record all the information about the book in the same way as firstn and lastn.
    • editor-link or editor1-link...editorn-link is used in the same way as authorlink or authorlinkn.
  • 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 archived copy of the page, if (or in case) the url becomes unavailable. Typically used to refer to services like WebCite and 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
{{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}}
Smith, Joseph III (October 1879). "Last Testimony of Sister Emma". The Saints' Herald 26: 289. 
Vancouver style (common in biomedicine)
{{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 }}
Bannen RM, Suresh V, Phillips GN Jr, Wright SJ, Mitchell JC (2008). "Optimal design of thermally stable proteins". Bioinformatics 24 (20): 2339–43. doi:10.1093/bioinformatics/btn450. PMID 18723523. PMC 2562006. 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.
{{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 }}
Myriam B.C. Aries; Guy R. Newsham (2008). "Effect of daylight saving time on lighting energy use: a literature review" (PDF). Energy Policy 36 (6): 1858–1866. doi:10.1016/j.enpol.2007.05.021. http://www.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf. Retrieved 2009-09-01. 
Specify the 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
{{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}}
Viollet B, Andreelli F, Jørgensen SB, et al (January 2003). "The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity". J. Clin. Invest. 111 (1): 91–8. doi:10.1172/JCI16567. PMID 12511592. PMC 151837. 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:

{{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=}}
Viollet B, Andreelli F, Jørgensen SB, et al (January 2003). "The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity". J. Clin. Invest. 111 (1): 91–8. doi:10.1172/JCI16567. PMID 12511592. 

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":

{{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=}}
Viollet B, Andreelli F, Jørgensen SB, et al (January 2003). "The AMP-activated protein kinase alpha2 catalytic subunit controls whole-body insulin sensitivity". J. Clin. Invest. 111 (1): 91–8. doi:10.1172/JCI16567 (inactive 2008-06-18). PMID 12511592. 
If the article is in a foreign language, and the original title is unknown
{{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}}
Huang Y, Lu J, Shen Y, Lu J (March 1999). "[The protective effects of total flavonoids from Lycium Barbarum L. on lipid peroxidation of liver mitochondria and red blood cell in rats]" (in Chinese). Wei Sheng Yan Jiu 28 (2): 115–6. PMID 11938998. 
Other examples
  • {{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}}
Martin Fowler; Kent Beck (October 1879). "Last Testimony of Sister Emma". The Saints' Herald 26: 289. 
  • {{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}}
Woodin, W. Hugh (2001). "The Continuum Hypothesis, Part I" (PDF). Notices of the AMS (Providence, RI: American Mathematical Society) 48 (6): 567–576. SSN 1088–9477. OCLC 34550461. http://www.ams.org/notices/200106/fea-woodin.pdf. 
  • {{cite journal |title=Disney Releases 10 Titles on Laser Videodisc |year=1982 |journal=VIDEODISC/VIDEOTEX |volume=2 |issue=3 |pages=175}}
"Disney Releases 10 Titles on Laser Videodisc". VIDEODISC/VIDEOTEX 2 (3): 175. 1982. 

COinS

Template:UF-COinS

Aliases

These templates have been merged into this template and are now redirects:

These templates are redirects:

See also

External links