User:Boghog/sandbox
This template uses Lua: |
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 (2011) [2007]. "Author for Journal Articles". In Wendling P (ed.). The NLM Style Guide for Authors, Editors, and Publishers [Internet] (2nd ed.). Bethesda (MD): National Library of Medicine (US).
- 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.
{{cite web}}
:|author=
has generic name (help)
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:
| name-list-format = vanc | display-authors = 6
Note: While the
|display-authors=6
setting follows the ICMJE recommendation.
Optional vauthors parameter
Comparison of alternative author parameters | |||
---|---|---|---|
Feature | |lastn= ,|firstn= |
|vauthors= |
|authors=
|
Clean author metadata | |||
|author-link= compatible |
|||
|display-authors= compatible |
|||
Author format checking | |||
Compact |
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 |display-authors=
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):
- {{cite 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, Mori K, Yoneya S, Kohda M, Okazaki Y, Maruyama T, Shimada A, Yasuda K, Nishida N, Tokunaga K, Koike A (2014). "A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA". PLoS ONE. 9 (11): e111715. PMID 25364816.)
{{cite journal}}
: CS1 maint: unflagged free DOI (link
"author1, author2, ..." parameters:
- {{cite 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 (2014). "A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA". PLoS ONE. 9 (11): e111715. PMID 25364816.)
{{cite journal}}
: CS1 maint: unflagged free DOI (link
"first1, last1, first2, last2, ..." parameters:
- {{cite 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 (2014). "A genome-wide association study for diabetic retinopathy in a Japanese population: potential association with a long intergenic non-coding RNA". PLoS ONE. 9 (11): e111715. PMID 25364816.)
{{cite journal}}
: CS1 maint: unflagged free DOI (link
Rationale
The two main advantages of |vauthors=
are efficiency and consistency.
Efficiency
The
According to
Alternatives are to use {{
Consistency
|firstn=
imposes few restrictions on how first names stored and displayed. The first name parameter may or may not include middle names, may be spelled out in full or use initials, and if initials are used may or may not include periods and may or may not contain a space between the first and middle initials. In contrast |vauthors=
imposes strict restrictions on how first names are stored and displayed. The first name can only be one (first name initial) or two (first + middle initial). In short, the use of |vauthors=
insures that author name are consistently formatted throughout an article.
Tools
Wikipedia template filling: Converts PubMed ID or PubMed Central ID to a full {{cite journal}} citation.
See also
- Citing sources
- {{vcite journal}}, {{cite journal}} – Cite journal articles.
- {{citation}} – Cite sources in general.
References
- ^ "NLM Author Indexing Policy". NCBI Bookshelf.
- ^ 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.
{{cite web}}
:|author=
has generic name (help) - ^ "Number of Authors per MEDLINE/PubMed Citation". U.S. National Library of Medicine.