Template:Cite journal/doc

From All Skies Encyclopaedia
< Template:Cite journal
Revision as of 00:20, 7 December 2009 by imported>Eubulides (→‎Usage, Rationale: New sections.)

Template:Under construction

This template formats citations to articles in journals and other sources. It can be used in Wikipedia footnotes and in article sections that list sources. This template generally follows the Vancouver style,[1] and for performance reasons it does not generate COinS metadata (see Rationale below); otherwise, it acts much like {{cite journal}}.

You can use the Diberri template filler to generate this template, by replacing the "cite journal" in its output with "cit journal".

Usage

Common parameters

{{cit journal |author= |title= |journal= |date= |volume= |pages= |url= |doi= |pmid= |pmc= }}

Example
  • {{cit journal |author=Baird G, Cass H, Slonims V |title=Diagnosis of autism |journal=BMJ |date=2003 |volume=327 |pages=488–93 |url= |doi=10.1136/bmj.327.7413.488 |pmid=12946972 |pmc=188387 }}
  • Template:Cit journal
All main parameters

{{cit journal |author= |title= |article type= |journal= |edition= |format= |location= |publisher= |date= |update= |archiveurl= |archivedate= |accessdate= |series= |volume= |issue= |section phrase= |section= |pages= |column= |physical description= |language= |url= |doi= |doi_brokendate= |id= |pmid= |pmc= |bibcode= |issn= |quote= |laysummary= |laysource= |laydate= |notes= |part id= |part title= |part pages= |ref= }}

Example
  • {{cit journal |author=Author(s) |title=Article title |article type=Article type |journal=Journal title |edition=Edition |format=Format |location=Location |publisher=Publisher |date=1999 |update=updated 2002 |archiveurl=http://example.com |archivedate=2003 |accessdate=2009-12-06 |series=Series |volume=Volume |issue=Issue |section=B |pages=488–93 |column=2 |physical description=Physical description |language=Language |url=http://example.org/xxx |doi=10.1136/bmj.327.7413.488 |doi_brokendate=2009-12-05 |id=LoC XYZ.23 |pmid=1234 |pmc=2082983 |bibcode=1974AJ.....79..819H |issn=1234-5678 |quote=So it goes. |laysummary=http://www.medicalnewstoday.com/articles/96448.php |laysource= Medical News Today |laydate=2008-02-07 |notes=This citation is completely invented, and is not intended to stand for a real source. |part id=Appendix A |part title=Raw data |part pages=491–2 |ref=Author1999 }}
  • Template:Cit journal

Parameters

Rationale

This template was originally designed to attack a major problem with {{cite journal}}, {{cite book}}, etc.: these templates generate pages that can take way too long to load while browing and editing. The initial version of this template improved the page-generation time for Autism by over a factor of three, and reduced the size of its HTML by over 35%.[2]

To improve performance, this template omits the following features of {{cite journal}}, roughly in descending order of importance:

  • COinS metadata, which greatly bloats the output of {{cite journal}}. Readers who want COinS data can get it by copying a page into a sandbox and replacing all instances of "{{cit " with "{{cite ". Perhaps a gadget or tool will be developed to automate this task.
  • Wikilinks from each instance of "doi" to Digital object identifier, from each instance of "PMID" to PMID, etc. Not only do these links consume needless bytes, they are not that useful and they typically constitute overlinking.
  • Automatically-generated Harvard references. You can specify them by hand using |ref=. The Vancouver style is normally used with numbered footnotes, not with Harvard references, so this deficiency is not serious.
  • Fancy ways of formatting authors and editors, with parameters like |coauthors=, |last8=, |editor2-first=, and |editor3-link=. Instead, please format author names and links the way you prefer them, inside |author=.
  • Boldface volume numbers. Boldfacing is not needed in the Vancouver style, and would be a distracting visual cue.
  • Quote marks around article titles. This is not part of the Vancouver style.

Other ways in which this template generates less output include

See also

Notes and references

  1. Template:Cit book
  2. These measurements were generated from Template:Oldid and Template:Oldid variants of the same version of Autism, using the template implementations of the time.