Template:Cite journal/doc: Difference between revisions

Removed no longer supported trans_title= parameter.
m (1 revision imported: copy from w:Template:Cite journal‏‎‏‎)
(Removed no longer supported trans_title= parameter.)
Line 1:
{{Documentation subpage}}
{{highHigh-risk|480000+use}}
{{csdoc|lua|lua=yes}}
{{csdoc|cs1|lua=yes}}
{{csdoc|lead|academic and scientific papers and journals. For articles in magazines and newsletters, use {{tlx|cite magazine}}. Note that ifIf you have a [[Digitaldigital Objectobject Identifieridentifier]] (i.e., a DOI) for the journal reference you wish to add, weWikipedia havehas a citation bot which will read that DOI and expand it into a full reference with the author's name, journal name, date, volume, issue, pages, etc. You can view instructions on how to add this gadget to your Wikipedia preferences at [[User:Citation bot/use]]|lua=yes}}
 
==Usage==
Line 9:
{{csdoc|usage common}}
 
; To cite a professional or scientific journal
: <code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |access-date= }}</nowiki></code>
; [[Vancouver system]] author style for a scientific journal
 
: <code><nowiki>{{cite journal |vauthors= |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |pmc= |pmid= |access-date= }}</nowiki></code>
;[[Vancouver system]] author style for a scientific journal
: or
<code><nowiki>{{cite journal |vauthors= |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |pmc= |pmid= |access-date= }}</nowiki></code>
: <code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |pmc= |pmid= |access-date= | name-list-format=vanc }}</nowiki></code>
 
; To cite a journal article with no credited author
or
: <code><nowiki>{{cite journal |author=<!--Staff writer(s); no by-line.--> |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |access-date= }}</nowiki></code>
 
<code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |pmc= |pmid= |access-date= | name-list-format=vanc }}</nowiki></code>
 
;To cite a journal article with no credited author
<code><nowiki>{{cite journal |author=<!--Staff writer(s); no by-line.--> |date= |title= |url= |journal= |volume= |issue= |pages= |doi= |access-date= }}</nowiki></code>
 
;To cite an online article that has been archived
:<code><nowiki>{{cite journal |last= |first= |date= |title= |url= |dead-url-status= |journal= |volume= |issue= |pages= |doi= |archive-url= |archive-date= |access-date= }}</nowiki></code>
 
;To cite an article written in a foreign language
:<code><nowiki>{{cite journal |last= |first= |date= |title= |trans-title= |url= |language= |journal= |volume= |issue= |pages= |doi= |access-date= }}</nowiki></code>
 
;To cite and quote an archived, two-author, foreign language journal article re-published as a PDF on an information aggregation service requiring a subscription
:<code><nowiki>{{cite journal |last1= |first1= |last2= |first2= |date= |title= |trans-title= |url= |access-date= |language= |journal= |volume= |issue= |pages= |doi= |archive-url= |archive-date= |deadurl-urlstatus= |via= |quote= }}</nowiki></code>
{{end}}
{{anchor|full horizontal}}{{csdoc|usage full}}
:<code><nowiki>{{cite journal |last1= |first1= |author-link1= |last2= |first2= |author-link2= |last3= |first3= |author-link3= |last4= |first4= |author-link4= |last5= |first5= |author-link5= |display-authors= |author-mask= |name-list-format= |last-author-amp= |date= |year= |orig-year= |editor1-last= |editor1-first= |editor1-link= |editor2-last= |editor2-first= |editor2-link= |editor3-last= |editor3-first= |editor3-link= |editor4-last= |editor4-first= |editor4-link= |editor5-last= |editor5-first= |editor5-link= |display-editors= |others= |title= |script-title= |trans-title= |url= |access-date= |url-access= |format= |department= |journal= |type= |series= |language= |edition= |location= |publisher= |publication-place= |publication-date= |volume= |issue= |page= |pages= |at= |nopp= |arxiv= |asin= |bibcode= |bibcode-access= |biorxiv= |citeseerx= |doi= |doi-access= |doi-broken-date= |isbn= |issn= |jfm= |jstor= |jstor-access= |lccn= |mr= |oclc= |ol= |ol-access= |osti= |osti-access= |pmc= |pmid= |rfc= |ssrn= |zbl= |id= |archive-url= |archive-date= |deadurl-urlstatus= |via= |layurl= |laysource= |laydate= |quote= |postscript= |ref= }}</nowiki></code>
{{end}}
{{csdoc|usage vertical common}}
Line 119 ⟶ 112:
| title =
| url =
| dead-url -status =
| journal =
| volume =
| issue =
Line 161 ⟶ 154:
| trans-title =
| url =
| dead-url -status =
| format =
| language =
Line 178 ⟶ 171:
</pre>
{{end}}
{{anchor|full vertical}}{{csdoc|usage vertical}}
<pre style="margin:0px; border:none;">
{{cite journal
Line 198 ⟶ 191:
| display-authors =
| author-mask =
| name-list-format =
| last-author-amp =
| date =
Line 224 ⟶ 217:
| trans-title =
| url =
| dead-url -status =
| format =
| url-access =
| department =
| journal =
Line 251 ⟶ 244:
| doi-broken-date =
| doi-access =
| isbn =
| issn =
| jfm =
Line 259 ⟶ 252:
| mr =
| oclc =
| ol =
| ol-access =
| osti =
| osti-access =
| pmc =
| pmid =
Line 280 ⟶ 273:
| quote =
| postscript =
| ref =
}}
</pre>
Line 479 ⟶ 472:
 
==Examples==
;Journal article
*<code><nowiki>{{cite journal |last=Overpeck |first=J. T. |last2=Webb |first2=T. |last3=Prentice |first3=I. C. |date=January 1985 |title=Quantitative interpretation of fossil pollen spectra: Dissimilarity coefficients and the method of modern analogs |journal=Quaternary Research |volume=23 |pages=87–108 |bibcode=1985QuRes..23...87O |doi=10.1016/0033-5894(85)90074-2}}</nowiki></code>
 
Line 495 ⟶ 488:
* {{cite journal |last=Bannen |first=RM |last2=Suresh |first2=V |last3=Phillips |first3=GN Jr |last4=Wright |first4=SJ |last5=Mitchell |first5=JC |date=2008 |title=Optimal design of thermally stable proteins |url=http://bioinformatics.oxfordjournals.org/cgi/content/full/24/20/2339 |journal=Bioinformatics |volume=24 |issue=20 |pages=2339–2343 |doi=10.1093/bioinformatics/btn450 <!--|doi-access=free --> |pmc=2562006 |pmid=18723523 |name-list-format=vanc}}
 
;Include URL link to article, pre-print, or abstract.
*<code><nowiki>{{cite journal |last=Aries |first=Myriam B. C. |last2=Newsham |first2=Guy R. |last-author-amp=yes |date=2008 |title=Effect of daylight saving time on lighting energy use: a literature review |url=http://archive.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |journal=Energy Policy |volume=36 |issue=6 |pages=1858–1866 |doi=10.1016/j.enpol.2007.05.021 |access-date=October 18, 2013}}</nowiki></code>
Displays as:
* {{cite journal |last=Aries |first=Myriam B. C. |last2=Newsham |first2=Guy R. |last-author-amp=yes |date=2008 |title=Effect of daylight saving time on lighting energy use: a literature review |url=http://archive.nrc-cnrc.gc.ca/obj/irc/doc/pubs/nrcc49212/nrcc49212.pdf |format=PDF |journal=Energy Policy |volume=36 |issue=6 |pages=1858–1866 |doi=10.1016/j.enpol.2007.05.021 |access-date=October 18, 2013}}
If the linked document is PDF, but the [[filename extension|extension]] is not .pdf or .PDF, you may add the parameter {{para|format|PDF}}, which displays " (PDF)" after the link.
 
;Specify the [[Digitaldigital object identifier|DOI]] to provide a permanent link., Alsoand givean URL where the [[PMID]]article abstractis forfree. For medical articles, andalso the URL ifgive the article[[PMID]] is free.and [[PubMed Central]] (PMC) ID: the PMC value will link the free full-text repository links may also be supplied and will link the title if the URL is not specified, else as an additional linked PMC value. Note that {{para|access-date}} is not necessary when a permanent identifier is used.
*<code><nowiki>{{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F. P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |url=http://www.jci.org/articles/view/16567 |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–98 |doi=10.1172/JCI16567 |pmc=151837 |pmid=12511592 |access-date=2012-11-17}}</nowiki></code>
Displays as:
Line 510 ⟶ 504:
* {{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F. P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–98 |doi=10.1172/JCI16567 <!--|doi-access=free --> |pmc=151837 |pmid=12511592}}
 
If the doi link is broken, then use of '''doi-broken-date''' unlinks the doi value, indicates when the doi-problem was first noticed, and will also add the page to "Category:Pages with DOIs brokeninactive sinceas of YYYY" (tracking category [[:Category:Pages with inactive DOIs]]):
*<code><nowiki>{{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F. P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–98 |doi=10.1172/JCI16567 |doi-broken-date=20172019-01-01 |pmc=151837 |pmid=12511592}}</nowiki></code>
Displays as:
* {{cite journal |last=Viollet |first=Benoît |last2=Andreelli |first2=Fabrizio |last3=Jørgensen |first3=Sebastian B. |last4=Perrin |first4=Christophe |last5=Geloen |first5=Alain |last6=Flamez |first6=Daisy |last7=Mu |first7=James |last8=Lenzner |first8=Claudia |last9=Baud |first9=Olivier |last10=Bennoun |first10=Myriam |last11=Gomas |first11=Emmanuel |last12=Nicolas |first12=Gaël |last13=Wojtaszewski |first13=Jørgen F. P. |last14=Kahn1 |first14=Axel |last15=Carling |first15=David |last16=Schuit |first16=Frans C. |last17=Birnbaum |first17=Morris J. |last18=Richter |first18=Erik A. |last19=Burcelin |first19=Rémy |last20=Vaulont |first20=Sophie |display-authors=5 |date=January 2003 |title=The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |journal=The Journal of Clinical Investigation |volume=111 |issue=1 |pages=91–98 |doi=10.1172/JCI16567 |doi-broken-date=20172019-01-01 |pmc=151837 |pmid=12511592 |no-cat=yes}}
 
;If the article is in a foreign language, and the original title is unknown, enclose the translated title in square brackets and use {{para|title}}. Otherwise use {{para|title}} for the foreign-language title and {{para|trans-title}} for the English-language title.
Line 533 ⟶ 527:
===COinS===
{{csdoc|coins}}
 
===What's new===
{{csdoc|whats new}}
 
===Deprecated===
Line 552 ⟶ 549:
{{csdoc|language}}
 
===={{Anchor|url}}URL====
{{csdoc|url|pmc=yes}}
 
Line 567 ⟶ 564:
 
====In-source locations====
{{csdoc|pages|work=y|journal=y}}
 
====Identifiers====
Line 589 ⟶ 586:
 
==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, but not necessarily openly accessible. Note that {{para|access-date}} is not necessary when a permanent identifier is used.
 
==TemplateData==
Line 651 ⟶ 648:
"description": "Date of the source; do not wikilink. As listed in the publication",
"type": "date",
"suggested": true,
"example": "Summer 2017"
},
"journal": {
Line 792 ⟶ 788:
"label": "Translated title",
"description": "An English language title, if the source cited is in a foreign language; 'language' is recommended",
"type": "content",
"aliases": [
"trans_title"
]
},
"type": {
Line 919 ⟶ 912:
"quote": {
"label": "Quote",
"description": "Relevant text quoted from the source; displays last, enclosed in quotes; needs tomust include terminating punctuation",
"type": "content"
},
Line 1,028 ⟶ 1,021:
"label": "First name 9",
"description": "Given or first name, middle names, or initials of the ninth author; don't wikilink.",
"type": "line"
},
"last10": {
"label": "Last name 10",
"description": "The surname of the tenth author; don't wikilink, use 'authorlink9'. If ten authors are defined, then only eight will show and 'et al.' will show in place of the last two authors.",
"aliases": [
"deadurlauthor10"
],
"type": "line"
]},
"first10": {
"label": "First name 10",
"description": "Given or first name, middle names, or initials of the tenth author; don't wikilink.",
"type": "line"
},
"last11": {
"label": "Last name 11",
"description": "The surname of the 11th author; don't wikilink, use 'authorlink9'. If more than nine authors are defined, then only eight will show and 'et al.' will show in place of the remaining authors.",
"aliases": [
"author11"
],
"type": "line"
},
"first11": {
"label": "First name 11",
"description": "Given or first name, middle names, or initials of the 11th author; don't wikilink.",
"type": "line"
},
Line 1,197 ⟶ 1,216:
]
},
"dead-url-status": {
"label": "Dead URL status",
"description": "If set to 'nolive', the title displaydisplays iswith adjustedthe URL linked; usefulif forset whento 'dead', the URLtitle isdisplays archivedwith preemptivelythe butarchive stillURL livelinked",
"type": "line",
"aliases": [
"deadurl"
]
},
"lay-url": {
"label": "Lay summary URL",
"description": "URL link to a non-technical summary or review of the source; alias of 'laysummary'",
"type": "line",
"aliases": [
"layurl",
"laysummary"
]
},
Line 1,249 ⟶ 1,266:
"author-link5": {
"label": "Author link 5",
"description": "Title of existing Wikipedia article about the sixthfifth author.",
"type": "wiki-page-name",
"aliases": [
Line 1,434 ⟶ 1,451:
"vauthors": {
"label": "Vancouver style authors",
"description": "comma-separated list of author names in Vancouver style; enclose corporate or institutional author names in doubled parentheses",
"type": "line"
}
},
Line 1,465 ⟶ 1,483:
"first9",
"author-link9",
"last10",
"first10",
"last11",
"first11",
"displayauthors",
"author-mask",
Line 1,506 ⟶ 1,528:
"trans-title",
"url",
"dead-url-status",
"format",
"department",
Line 1,634 ⟶ 1,656:
"first9",
"last9"
],
[
"first10",
"last10"
],
[
"first11",
"last11"
]
],
Line 1,679 ⟶ 1,709:
}
</templatedata>
 
==Alternate usages==
For medical articles, [https://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi this citation-filling template] can be used to generate a cite journal template from a [[PubMed]] identifier (PMID).
 
==See also==
For medical articles,* [https://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi this citationCitation-template-filling templatetool], can be used tofor generate[[DrugBank]], a[[HGNC]], cite journal template from a[[ISBN]], [[PubMed]], identifierand (PMID).[[PubChem]]
{{Citation Style 1}}
{{Wikipedia referencing}}