Template:Vcite2 journal/doc

This template is used to create citations for articles in journals. It is an alternative to {{cite journal}} that instead formats authors according to the Vancouver system. This author format is documented in:

• Patrias K. Author for Journal Articles. Wendling P (编). The NLM Style Guide for Authors, Editors, and Publishers [Internet] 2^nd. Bethesda (MD): National Library of Medicine (US). 2011 [2007]. 
• International Committee of Medical Journal Editors (ICMJE). Recommendations for the Conduct, Reporting, Editing and Publication of Scholarly Work in Medical Journals: Sample References. U.S. National Library of Medicine. 

In all other respects, this template is identical to {{cite journal}}. Both are based on Module:Citation/CS1 and use identical parameters. The only difference is in how the authors are rendered.

Default parameter settings

This template achieves Vancouver author format by changing the default settings for the following parameters to:

| authorformat = vanc | author-separator = , | author-name-separator =   | display-authors = 6

Note: While the National Library of Medicine now lists all authors, the original ICMJE recommendations state "List the first six authors followed by et al." The default |display-authors=6 setting follows the ICMJE recommendation.

Optional vauthors parameter

This template adds support for an optional |vauthors= parameter that generates clean author metadata in the HTML output (see Wikipedia:COinS) while avoiding the character overhead of explicit firstn, lastn parameters. The |vauthors= parameter is also fully compatible with |author-link= and |displayauthors= parameters.

Parameter explanations

vauthors

Author list formatted in Vancouver style (comma separated list). This concatenated author list is automatically split internally by the template into the individual authors' first and last names that are respectively assigned to sequential |first1=, |last1=, |first2=, |last2=, ... parameters. This parameter is also checked for formatting errors (should not contain semicolons or periods, neither of which conforms to the Vancouver system). If such an error is detected, a vauthors error message is appended to the rendered citation.

other parameters

Refer to the documentation in {{cite journal}}.

Usage

Single vauthors parameter (recommended):

• {{vcite2 journal | vauthors = Awata T, Yamashita H, Kurihara S, Morita-Ohkubo T, Miyashita Y, Katayama S, Mori K, Yoneya S, Kohda M, Okazaki Y, Maruyama T, Shimada A, Yasuda K, Nishida N, Tokunaga K, Koike A | title = A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA | journal = PLoS ONE | volume = 9 | issue = 11 | pages = e111715 | year = 2014 | pmid = 25364816 | pmc = 4218806 | doi = 10.1371/journal.pone.0111715 }} →
• Awata, T; Yamashita, H; Kurihara, S; Morita-Ohkubo, T; Miyashita, Y; Katayama, S; et al. A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA. PLoS ONE. 2014, 9 (11): e111715. PMC 4218806 . PMID 25364816. doi:10.1371/journal.pone.0111715. 

Single author parameter:

• {{vcite2 journal | author = Awata T, Yamashita H, Kurihara S, Morita-Ohkubo T, Miyashita Y, Katayama S, Mori K, Yoneya S, Kohda M, Okazaki Y, Maruyama T, Shimada A, Yasuda K, Nishida N, Tokunaga K, Koike A | title = A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA | journal = PLoS ONE | volume = 9 | issue = 11 | pages = e111715 | year = 2014 | pmid = 25364816 | pmc = 4218806 | doi = 10.1371/journal.pone.0111715 }} →
• Awata T, Yamashita H, Kurihara S, Morita-Ohkubo T, Miyashita Y, Katayama S, Mori K, Yoneya S, Kohda M, Okazaki Y, Maruyama T, Shimada A, Yasuda K, Nishida N, Tokunaga K, Koike A. A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA. PLoS ONE. 2014, 9 (11): e111715. PMC 4218806 . PMID 25364816. doi:10.1371/journal.pone.0111715. 

"author1, author2, ..." parameters:

• {{vcite2 journal | author1 = Awata T | author2 = Yamashita H | author3 = Kurihara S | author4 = Morita-Ohkubo T | author5 = Miyashita Y | author6 = Katayama S | author7 = Mori K | author8 = Yoneya S | author9 = Kohda M | author10 = Okazaki Y | author11 = Maruyama T | author12 = Shimada A | author13 = Yasuda K | author14 = Nishida N | author15 = Tokunaga K | author16 = Koike A | title = A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA | journal = PLoS ONE | volume = 9 | issue = 11 | pages = e111715 | year = 2014 | pmid = 25364816 | pmc = 4218806 | doi = 10.1371/journal.pone.0111715 }} →
• Awata T; Yamashita H; Kurihara S; Morita-Ohkubo T; Miyashita Y; Katayama S; Mori K; Yoneya S; Kohda M; Okazaki Y; Maruyama T; Shimada A; Yasuda K; Nishida N; Tokunaga K; Koike A. A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA. PLoS ONE. 2014, 9 (11): e111715. PMC 4218806 . PMID 25364816. doi:10.1371/journal.pone.0111715. 

"first1, last1, first2, last2, ..." parameters:

• {{vcite2 journal | last1 = Awata | first1 = T | last2 = Yamashita | first2 = H | last3 = Kurihara | first3 = S | last4 = Morita-Ohkubo | first4 = T | last5 = Miyashita | first5 = Y | last6 = Katayama | first6 = S | last7 = Mori | first7 = K | last8 = Yoneya | first8 = S | last9 = Kohda | first9 = M | last10 = Okazaki | first10 = Y | last11 = Maruyama | first11 = T | last12 = Shimada | first12 = A | last13 = Yasuda | first13 = K | last14 = Nishida | first14 = N | last15 = Tokunaga | first15 = K | last16 = Koike | first16 = A | title = A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA | journal = PLoS ONE | volume = 9 | issue = 11 | pages = e111715 | year = 2014 | pmid = 25364816 | pmc = 4218806 | doi = 10.1371/journal.pone.0111715 }} →
• Awata, T; Yamashita, H; Kurihara, S; Morita-Ohkubo, T; Miyashita, Y; Katayama, S; Mori, K; Yoneya, S; Kohda, M; Okazaki, Y; Maruyama, T; Shimada, A; Yasuda, K; Nishida, N; Tokunaga, K; Koike, A. A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA. PLoS ONE. 2014, 9 (11): e111715. PMC 4218806 . PMID 25364816. doi:10.1371/journal.pone.0111715. 

Rationale

The purpose of citations is to support the corresponding text. Furthermore, according to WP:MEDREF, medical articles should be relatively dense with inline citations. At the same time, there has been a steady increase in the average number of authors in citations in the biomedical and physical sciences. Citations with "hyperauthorship" (authors in excess of 50) are becoming increasingly common. If a citation has a large number authors, the use of explicit |first1=, |last1=, |first2=, |last2=, ... parameters in {{cite journal}} becomes unwieldy and starts to overwhelm the surrounding wiki text. The author format in the Vancouver system is both compact (requires fewer characters) and efficient (it is easy to parse since it is comma delimited). For citations a large number of authors, this template permits a significant reduction in both the length of the displayed citation as well as the size of the imbedded template.

Alternatives are to use {{cite pmid}}, {{cite doi}}, etc. templates, but the use of these templates per consensus has been deprecated. List defined references is another alternative, but the disadvantage of this approach is that it separates the text and citation which is used to support the text.

Tools

Wikipedia template filling: Converts PubMed ID or PubMed Central ID to a full {{vcite2 journal}} citation.

See also

• Citing sources
• {{vcite journal}}, {{vancite journal}}, {{cite journal}} – Cite journal articles.
• {{citation}} – Cite sources in general.

References

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