Template:Cite journal/doc

From All Skies Encyclopaedia
< Template:Cite journal
Revision as of 20:11, 7 October 2009 by imported>Eubulides (→‎Examples: Update example; the URL in the previous example no longer works.)

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

Usage

All field names must be lowercase.

Parameters

Common parameters, horizontal format

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

Common parameters for Vancouver system citations

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

All parameters, horizontal format

{{cite journal |last= |first= |author= |authorlink= |coauthors= |date= |year= |month= |day= |title= |trans_title= |journal= |volume= |series= |issue= |page= |pages= |publisher= |location= |issn= |pmid= |pmc= |doi= |bibcode= |oclc= |id= |url= |language= |format= |accessdate= |laysummary= |laysource= |laydate= |quote= |ref= |ps= }} Template:Break

Using lastname, firstname Using author
{{cite journal
| last        = 
| first       = 
| authorlink  = 
| coauthors   = 
| date        = 
| year        = 
| month       = 
| day         = 
| title       = 
| trans_title = 
| journal     = 
| volume      = 
| issue       = 
| series      = 
| pages       = 
| publisher   = 
| location    = 
| issn        = 
| pmid        = 
| pmc         = 
| doi         = 
| bibcode     = 
| oclc        = 
| id          = 
| url         = 
| language    = 
| format      = 
| accessdate  = 
| laysummary  = 
| laysource   = 
| laydate     = 
| quote       = 
| ref         = 
| ps          = 
}}
{{cite journal
| author      = 
| date        = 
| year        = 
| month       = 
| day         = 
| title       = 
| trans_title = 
| journal     = 
| volume      = 
| issue       = 
| series      = 
| pages       = 
| publisher   = 
| location    = 
| issn        = 
| pmid        = 
| pmc         = 
| doi         = 
| bibcode     = 
| oclc        = 
| id          = 
| url         = 
| language    = 
| format      = 
| accessdate  = 
| laysummary  = 
| laysource   = 
| laydate     = 
| quote       = 
| ref         = 
| ps          = 
}}
Result (using lastname, firstname)

Lua error: bad argument #1 to "get" (not a valid title).


Result (using author)

Lua error: bad argument #1 to "get" (not a valid title).

Legend

  • author: Author. Use to specify a single author of the paper. Do not include "et al"; this will be generated automatically by the template if needed
    • last works with first to produce last, first;. These parameters produce the maximum metadata and should be used if possible.
    • author2, last2, first2 and subsequent should be used for co-authors (up to 9 will be displayed before truncation with "et al".
    • authorlink works either with author or with last & first to link to the appropriate article (InterWikimedia links)
    • coauthors: Full name of additional author or authors. Please use 'author2', 'author3', etc instead.
    • author-separator: over-ride the default semi-colon that separates authors' names.
    • Template:AuthorMask doc
  • author-name-separator: over-ride the default comma that separates authors' names.
  • display-authors: Truncate the list of authors at an arbitrary point with "et al". Still include the first 9 authors to allow metadata to be generated.
  • date: January 1, 2006. Full date of publication.
    • year: 2006. Year of publication (ignored if the date field is used).
      • month: January. Month of publication (ignored if the date field is used, or if the year field is not used).
        • day: 31. Day of month of publication (ignored if the date field is used, or if the month field is not used).
  • title: Title of article.
  • journal: Name of the journal or periodical.
  • volume: Volume number of the journal in which the article is found
  • series or version: At most one of these may be entered. In either case the value will be displayed in plaintext after the title.
    • series: According to the 14th edition of Chicago Manual of Style p. 576, "As in the case of book series, some journals have attained such longevity that they have begun a new series of volumes or issues. Identification of the series (n.s., 2d ser., 3d ser., ser. b) must be made in citations to these journals."
    • version: Use when citing a paper. It may be used, for example, for standards documents, which retain the same title and document number (e.g. ISO nnnnn) but may have many revisions (e.g. ISO nnnnn-xxxx).
  • issue: Journal's issue number, or issue name.
  • page or pages: 45–47: first page, and optional last page (separated by an en dash –). Manually prepend with p. or pp. if necessary. If you need to refer to a specific page within a cited source, use Template:Rp.
  • publisher: Publisher of journal or periodical; should not include corporate designation such as "Ltd" or "Inc". Only include if ISSN and DOI are unavailable.
    • location: Place of publication for journal or periodical.
  • issn: The publication's International Standard Serial Number such as 1111-2220.
  • pmid: The document's PubMed Unique Identifier, such as 15128012
  • pmc: The document's PubMed Central article number (PMCID) for full-text free repository of an article, such as 246835
  • oclc: The periodical's Online Computer Library Center ID number, such as 3185581
  • doi: A digital object identifier for the document, such as 10.1130/0091-7613(1990)018<1153:TAFSIA>2.3.CO;2.
  • doi_brokendate: Sometimes the doi target link might not function (e.g. the journal is transferred to a new publisher which does not provide doi access). A blanked out doi parameter could lead to a later editor or bot re-adding the doi. Instead, use this parameter, which takes a date argument. Must not be wikilinked.
    The doi value is still shown, but without a link, and the mainspace article is added to "Category:Pages with DOIs broken since YYYY".
  • bibcode: The document's bibcode in the Astrophysics Data System, e.g., 1924MNRAS..84..308E
  • id: A unique identifier, used if none of the above are applicable. In this case, you need to specify the kind of identifier you are using, preferably with a template like {{US patent}}, {{MR}} / {{MathSciNet}}, {{Zbl}}, {{arXiv}}, {{JSTOR}} or {{JFM}}. (Use one of the more specialized parameters if possible; they are linked automatically. In other words, don't use id = PMID 15128012 anymore. Use pmid = 15128012.)
  • language: Language, e.g. Finnish. (English is assumed and should not be specified.)
    • trans_title: Translated (English) title, when the title is in a foreign language. Can be used without source title when the source title is unknown.
  • url: This should point to, in descending order of preference:
  1. A free online version of the full text
  2. An online version of the full text, for which subscription is required
  3. An abstract or information page, if no DOI or PMID record is available
If a DOI or PMID is available, the URL should only be specified if it would point to a different page to that which a DOI or PMID would redirect to.
  • accessdate: Full date when URL was last checked. Should use the same format as the other full dates in the references. Must not be wikilinked.
  • format: Format of document at that URL, e.g. PDF. Don't specify for HTML (implied as default). This parameter is sometimes used for completely different purposes, with values such as "fee required" and "reprint", but its original intent was to warn readers of file formats that their browsers might have trouble with.
  • laysummary: URL of a lay summary, which could be in a popular science magazine or newspaper.
    • laysource: Name of the source, e.g. The Guardian (UK newspaper) or New Scientist.
    • laydate: Date of publication or, where this is not available, date of retrieval of the lay summary.
An alternate method of adding one or more references to common media (preferably in Layman's terms) from the related journal citation can be specified within a single <ref>...</ref> tag using other citation templates; for example:
Text in the article.<ref>{{cite journal | ... }}<br/>
'''Related news articles:'''
*{{cite news | ... }}
*{{cite web | ... }}</ref>
  • quote: Relevant excerpt from the journal.
  • ref: ID for anchor. By default, no anchor is generated. The ordinary nonempty value |ref=ID generates an anchor with the given ID; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. The special value |ref=harv generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates.
  • ps: the 'postscript' - if specified, over-rides the default behaviour of terminating the citation with a full stop. Leave blank to suppress the full stop. This may be useful when using a quote which ends in punctuation, or when generating an output consistent with other templates. It is preferred to manually adding ending punctuation, as the punctuation occurs within the <cite> tag, so will appear before any icons added by browser plugins.

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.

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}}
Lua error: bad argument #1 to "get" (not a valid title).
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 }}
Lua error: bad argument #1 to "get" (not a valid title).
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 }}
Lua error: bad argument #1 to "get" (not a valid title).
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}}
Lua error: bad argument #1 to "get" (not a valid title).

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=}}
Lua error: bad argument #1 to "get" (not a valid title).

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=}}
Lua error: bad argument #1 to "get" (not a valid title).
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}}
Lua error: bad argument #1 to "get" (not a valid title).
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}}
Lua error: bad argument #1 to "get" (not a valid title).
  • {{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}}
Lua error: bad argument #1 to "get" (not a valid title).
  • {{cite journal |title=Disney Releases 10 Titles on Laser Videodisc |year=1982 |journal=VIDEODISC/VIDEOTEX |volume=2 |issue=3 |pages=175}}
Lua error: bad argument #1 to "get" (not a valid title).

COinS

This template produces COinS metadata; see COinS in Wikipedia for background information.

Aliases

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

These templates are redirects:

See also

External links