Template:Cite journal/doc: Difference between revisions

From All Skies Encyclopaedia
imported>Rich Farmbrough
(→‎Parameters: remove deprectaed day parameter form examples)
imported>Eubulides
(→‎Usage, Rationale: New sections.)
Line 1: Line 1:
{{Documentation subpage}}
{{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}}


{{Under construction}}
==Usage==
All field names '''must''' be [[lowercase]].
===Parameters===
;Common parameters, horizontal format
<code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |year= |title= |journal= |volume= |issue= |pages= |url= |doi= }}</nowiki></code>


This template formats citations to articles in journals and other sources. It can be used in [[Wikipedia:Footnotes|Wikipedia footnotes]] and in article sections that list sources. This template generally follows the [[Vancouver style]],<ref name=Citing-medicine/> and for performance reasons it does not generate [[Wikipedia:WikiProject Microformats/COinS|COinS metadata]] (see ''[[#Rationale|Rationale]]'' below); otherwise, it acts much like {{tl|cite journal}}.
;Common parameters for [[Vancouver system]] citations
<code><nowiki>{{cite journal |author= |year= |title= |journal= |volume= |issue= |pages= |url= |doi= |pmid= |pmc= }}</nowiki></code>


You can use the [[User:Diberri/Template filler|Diberri template filler]] to generate this template, by replacing the "<code>cite journal</code>" in its output with "<code>cit journal</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= |publisher= |location= |issn= |pmid= |pmc= |doi= |bibcode= |oclc= |id= |url= |language= |format= |accessdate= |laysummary= |laysource= |laydate= |quote= |ref= |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 =
| accessdate =
| laysummary =
| laysource =
| laydate =
| quote =
| ref =
| 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 =
| accessdate =
| laysummary =
| laysource =
| laydate =
| quote =
| ref =
| postscript =
}}</pre>
|}


== Usage ==
;Result (using lastname, firstname):


;Common parameters
{{cite journal
<code><nowiki>{{cit journal |author= |title= |journal= |date= |volume= |pages= |url= |doi= |pmid= |pmc= }}</nowiki></code>
| 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
| accessdate =accessdate
| laysummary =laysummary
| laysource =laysource
| laydate =laydate
| quote =quote
| ref =ref
| postscript =postscript
}}


;;Example
;* <code><nowiki>{{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 }}</nowiki></code>
;* {{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 }}


;All main parameters
;Result (using author):
<code><nowiki>{{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= }}</nowiki></code>


;;Example
{{cite journal
;* <code><nowiki>{{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 }}</nowiki></code>
| author =author
;* {{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 }}
| 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
| accessdate =accessdate
| laysummary =laysummary
| laysource =laysource
| laydate =laydate
| quote =quote
| ref =ref1
| postscript =postscript
}}


===Legend===
== Parameters ==
{{Citation parameter legend}}
*'''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.


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


This template was originally designed to attack a major problem with {{tl|cite journal}}, {{tl|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%.<ref>These measurements were generated from {{oldid|User:Eubulides/sandbox|329753018|"<code>cit</code>"-using}} and {{oldid|User:Eubulides/sandbox|329187414|"<code>cite</code>"-using}} variants of the same version of ''[[Autism]]'', using the template implementations of the time.</ref>
==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}}


To improve performance, this template omits the following features of {{tl|cite journal}}, roughly in descending order of importance:
; 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 }}


* [[Wikipedia:WikiProject Microformats/COinS|COinS metadata]], which greatly bloats the output of {{tl|cite journal}}. Readers who want COinS data can get it by copying a page into a sandbox and replacing all instances of "<code><nowiki>{{cit </nowiki></code>" with "<code><nowiki>{{cite </nowiki></code>". Perhaps a gadget or tool will be developed to automate this task.
;Include URL link to free-article, pre-print or abstract; also supply access date unless the URL is known to be stable.
* 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 [[WP:OVERLINK|overlinking]].
:<code><nowiki>
* Automatically-generated Harvard references. You can specify them by hand using {{para|ref}}. The Vancouver style is normally used with numbered footnotes, not with Harvard references, so this deficiency is not serious.
{{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 }}
* Fancy ways of formatting authors and editors, with parameters like {{para|coauthors}}, {{para|last8}}, {{para|editor2-first}}, and {{para|editor3-link}}. Instead, please format author names and links the way you prefer them, inside {{para|author}}.
</nowiki></code>
* Boldface volume numbers. Boldfacing is not needed in the Vancouver style, and would be a distracting visual cue.
:→ {{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 }}
* Quote marks around article titles. This is not part of the Vancouver style.


Other ways in which this template generates less output include
;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}}


== See also ==
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:
* {{tl|cit book}} for citing books
:<code><nowiki>
{{cite journal
* {{tl|cite journal}} for citing journals less concisely
|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=}}


== Notes and references ==
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":
{{reflist|refs=
:<code><nowiki>
<ref name=Citing-medicine>{{cit book |author=Patrias K |secondary author=Wendling DL, technical editor |title=Citing medicine: the NLM Style Guide for authors, editors, and publishers |edition=2nd |location=Bethesda (MD) |url=http://www.ncbi.nlm.nih.gov/bookshelf/br.fcgi?book=citmed |publisher=National Library of Medicine (US) |date=2007 |update=updated 2009 Oct 21 |accessdate=2009 Dec 6 }}</ref>
{{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]]
* [[Zotero]]


==External links==
* [[User:badgettrg|badgettrg]]'s [http://sumsearch.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
<includeonly>
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Citation templates|{{PAGENAME}}]]
[[Category:Templates generating COinS|{{PAGENAME}}]]


<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[bg:Шаблон:Cite journal]]
[[ca:Plantilla:Citar publicació]]
[[cs:Šablona:Citace časopisu]]
[[de:Vorlage:Cite journal]]
[[el:Πρότυπο:Cite journal]]
[[es:Plantilla:Cita publicación]]
[[fr:Modèle:Article]]
[[hu:Sablon:Cite journal]]
[[hy:Կաղապար:Cite journal]]
[[ia:Patrono:Cite journal]]
[[it:Template:Cita pubblicazione]]
[[ja:Template:Cite journal]]
[[ka:თარგი:Cite journal]]
[[ko:틀:저널 인용]]
[[no:Mal:Cite journal]]
[[pl:Szablon:Cytuj pismo]]
[[pt:Predefinição:Citar periódico]]
[[ro:Format:Citat revistă]]
[[ru:Шаблон:Статья]]
[[sl:Predloga:Navedi revijo]]
[[sk:Šablóna:Citácia periodika]]
[[fi:Malline:Lehtiviite]]
[[sv:Mall:Tidskriftsref]]
[[th:Template:Cite journal]]
[[vi:Tiêu bản:Chú thích tạp chí]]
[[zh:Template:Cite journal en]]
[[he:Cite journal]]
[[tr:Şablon:Cite journal]]
</includeonly>
</includeonly>

Revision as of 00:20, 7 December 2009

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.