Template:Cite journal/doc: Difference between revisions
From All Skies Encyclopaedia
imported>Dispenser (can use either pages= or page=) |
(←Blanked the page) |
||
| Line 1: | Line 1: | ||
{{Documentation subpage}} |
|||
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE --> |
|||
'''Cite journal''' is for formatting references to articles in magazines and academic journals 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 <nowiki><ref></nowiki> tags for in-line citations (see [[Wikipedia:Footnotes]]). |
|||
==Usage== |
|||
;Common parameters, horizontal format (with today's date) |
|||
<tt><nowiki>{{cite journal |last= |first= |authorlink= |coauthors= |year= |month= |title= |journal= |volume= |issue= |pages= |id= |url= |accessdate=</nowiki>{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}<nowiki> |quote= }}</nowiki></tt> |
|||
;Common parameters, horizontal format |
|||
<tt><nowiki>{{cite journal |last= |first= |authorlink= |coauthors= |year= |month= |title= |journal= |volume= |issue= |pages= |id= |url= |accessdate= |quote= }}</nowiki></tt> |
|||
;All parameters, horizontal format |
|||
<tt><nowiki>{{cite journal |quotes= |last= |first= |author= |authorlink= |coauthors= |date= |year= |month= |title= |journal= |volume= |issue= |page= |pages= |publisher= |location= |issn= |pmid= |pmc= |doi= |bibcode= |oclc= |id= |url= |language= |format= |accessdate= |laysummary= |laysource= |laydate= |quote=}}</nowiki></tt> |
|||
{| cellpadding="5" cellspacing="6" |
|||
! Using lastname, firstname !! Using author (firstname lastname) |
|||
|- width="50%" |
|||
| |
|||
<pre> |
|||
{{cite journal |
|||
|quotes= |
|||
|last= |
|||
|first= |
|||
|authorlink= |
|||
|coauthors= |
|||
|date= |
|||
|year= |
|||
|month= |
|||
|title= |
|||
|journal= |
|||
|volume= |
|||
|issue= |
|||
|pages= |
|||
|publisher= |
|||
|location= |
|||
|issn= |
|||
|pmid= |
|||
|pmc= |
|||
|doi= |
|||
|bibcode= |
|||
|oclc= |
|||
|id= |
|||
|url= |
|||
|language= |
|||
|format= |
|||
|accessdate= |
|||
|laysummary= |
|||
|laysource= |
|||
|laydate= |
|||
|quote=}}</pre> |
|||
| style="vertical-align: top;" | |
|||
<pre> |
|||
{{cite journal |
|||
|quotes= |
|||
|author= |
|||
|date= |
|||
|year= |
|||
|month= |
|||
|title= |
|||
|journal= |
|||
|volume= |
|||
|issue= |
|||
|pages= |
|||
|publisher= |
|||
|location= |
|||
|issn= |
|||
|pmid= |
|||
|pmc= |
|||
|doi= |
|||
|bibcode= |
|||
|oclc = |
|||
|id= |
|||
|url= |
|||
|language= |
|||
|format= |
|||
|accessdate= |
|||
|laysummary= |
|||
|laysource= |
|||
|laydate= |
|||
|quote=}}</pre> |
|||
|} |
|||
*'''author''': Author |
|||
**'''last''' works with '''first''' to produce <code>last, first;</code> |
|||
**'''authorlink''' works either with '''author''' or with '''last''' & '''first''' to link to the appropriate article ([[Wikipedia:Interwikimedia link|interwiki link]]) |
|||
**'''coauthors''': allows additional authors |
|||
*'''date''': ''<nowiki>January 1, 2006</nowiki>''. Full [[Wikipedia:Date#Dates|date]] of publication. |
|||
**'''year''': ''2006''. Year of publication (ignored if the ''date'' field is used). |
|||
***'''month''': ''January''. Month of publication (ignored if the ''date'' field is used, or if the ''year'' field is ''not'' used). |
|||
*'''title''': Title of article. '''''This is the only required parameter. All other parameters are optional.''''' |
|||
*'''journal''': Name of the journal or periodical. |
|||
*'''volume''': Volume number of the journal in which the article is found |
|||
*'''issue''': Issue number of the journal in which the article is found |
|||
*'''page''' or '''pages''': ''<nowiki>45–47</nowiki>'': first page, and optional last page (separated by an [[en dash]] –). Manually prepend with ''p.'' or ''pp.'' if desired. |
|||
*'''publisher''': Publisher of journal or periodical; should not include corporate designation such as "Ltd" or "Inc". Only include if ISSN and DOI are unavailable. |
|||
**'''location''': Place of publication for journal or periodical. |
|||
*'''issn''': The publication's [[International Standard Serial Number]] such as ''1111-2220''. Only include if a DOI is unavailable. |
|||
*'''pmid''': The document's [[PMID|PubMed Unique Identifier]], such as ''15128012'' |
|||
*'''pmc''': The document's [[PubMed Central]] article number for full-text free repository of an article, such as ''246835'' |
|||
*'''oclc''': The periodical's [[Online Computer Library Center]] ID number, such as ''3185581'' |
|||
*'''doi''': A [[digital object identifier]] for the document, such as <code><nowiki>10.1130/0091-7613(1990)018<1153:TAFSIA>2.3.CO;2</nowiki></code>. |
|||
:*'''doi_brokendate''': Sometimes the doi target link might not function (e.g. the journal is transferred to a new publisher which does not provide doi access). A blanked out '''doi''' parameter could lead to a later editor or bot re-adding the doi. Instead, use this parameter which, like '''accessdate''', takes [[ISO 8601]] YYYY-MM-DD format, for example "doi_brokendate= {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}". ''Must not be wikilinked''. <br/>The '''doi''' value is still shown, but without a link, and the mainspace article is added to "Category:Pages with DOIs broken since YYYY". |
|||
*'''bibcode''': The document's [[bibcode]] in the [[Astrophysics Data System]], e.g., ''1924MNRAS..84..308E'' |
|||
*'''id''': A [[unique identifier]], used if none of the above are applicable. In this case, you need to specify the kind of identifier you are using, preferably with a template like {{tl|US patent}}, {{tl|MR}} / {{tl|MathSciNet}}, {{tl|Zbl}}, {{tl|arXiv}} or {{tl|JFM}}. (Use one of the more specialized parameters if possible; they are linked automatically. In other words, don't use <code><nowiki>id = PMID 15128012</nowiki></code> anymore. Use <code>pmid = 15128012</code>.) |
|||
*'''url''': This should point to, in descending order of preference: |
|||
:#A ''free'' online version of the full text |
|||
:#An online version of the ''full text'', for which subscription is required |
|||
:#An abstract or information page, ''if'' no DOI or PMID record is available |
|||
::If a DOI or PMID is available, the URL should only be specified if it would point to a different page to that which a DOI or PMID would redirect to. |
|||
:*'''format''': Format, e.g. PDF. Don't specify for HTML (implied as default). |
|||
::* Specify as'' 'fee required' ''if free access no longer available. |
|||
::* Specify as'' 'Reprint' ''if a full original version but not hosted by the original publisher. |
|||
*'''accessdate''': Full date when URL was last checked. Use [[ISO 8601]] YYYY-MM-DD format, for example "accessdate = {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}". |
|||
*'''laysummary''': URL of a lay summary, which could be in a popular science magazine or newspaper. |
|||
**'''laysource''': Name of the source, e.g. ''The Guardian'' (UK newspaper) or ''New Scientist''. |
|||
**'''laydate''': Date of publication or, where this is not available, date of retrieval of the lay summary. |
|||
*'''quote''': Relevant excerpt from the journal. |
|||
:An alternate method of adding one or more references to common media (preferably in [[Layman's terms]]) from the related journal citation can be specified ''within'' a single <code><nowiki><ref>...</ref></nowiki></code> tag using other [[:Category:Citation templates|citation templates]]; for example: |
|||
::<tt>''Text in the article.'''''<ref>'''<nowiki>{{cite journal | ... }}<br/></nowiki><br/><nowiki> |
|||
'''Related news articles:'''</nowiki><br/><nowiki> |
|||
*{{cite news | ... }}</nowiki><br/><nowiki> |
|||
*{{cite web | ... }}</nowiki>'''</ref>'''</tt> |
|||
*'''quotes''': ''[[Deprecation|deprecated]].'' Specify "quotes=no" to disable the quotation marks around the title. If "quotes" is not defined or set to the empty string, the template places quotation marks around the title (default). |
|||
==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. |
|||
==Examples== |
|||
;Formal citation |
|||
:<tt><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></tt> |
|||
:→ {{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}} |
|||
;Include URL link to free-article, pre-print or abstract; also supply access date unless the URL is known to be stable. |
|||
:<tt><nowiki> |
|||
{{cite journal |
|||
|author=[[Winston Churchill|Winston S. Churchill]] |
|||
|title=A silent toast to William Willett |
|||
|url=http://www.winstonchurchill.org/i4a/pages/index.cfm?pageid=266 |
|||
|accessdate=2007-05-16 |
|||
|journal=Pictorial Weekly |
|||
|date=[[1934-04-28]]}} |
|||
</nowiki></tt> |
|||
:→ {{cite journal |
|||
|author=[[Winston Churchill|Winston S. Churchill]] |
|||
|title=A silent toast to William Willett |
|||
|url=http://www.winstonchurchill.org/i4a/pages/index.cfm?pageid=266 |
|||
|accessdate=2007-05-16 |
|||
|journal=Pictorial Weekly |
|||
|date=[[1934-04-28]]}} |
|||
;Specify the [[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 |
|||
:<tt><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></tt> |
|||
:→ {{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}} |
|||
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: |
|||
:<tt><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=}} |
|||
</nowiki></tt> |
|||
:→ {{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=}} |
|||
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": |
|||
:<tt><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 |
|||
|doi_brokendate=2008-06-18 |
|||
|url=}} |
|||
</nowiki></tt> |
|||
:→ {{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=}} |
|||
;Other examples |
|||
*<tt><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></tt> |
|||
:→ {{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}} |
|||
*<tt><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></tt> |
|||
:→ {{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}} |
|||
*<tt><nowiki>{{cite journal |
|||
|title=Disney Releases 10 Titles on Laser Videodisc |
|||
|year=1982 |
|||
|journal=VIDEODISC/VIDEOTEX |
|||
|volume=2 |
|||
|issue=3 |
|||
|pages=175}}</nowiki></tt> |
|||
:→ {{cite journal |
|||
|title=Disney Releases 10 Titles on Laser Videodisc |
|||
|year=1982 |
|||
|journal=VIDEODISC/VIDEOTEX |
|||
|volume=2 |
|||
|issue=3 |
|||
|pages=175}} |
|||
==COinS== |
|||
{{UF-COinS}} |
|||
==Useful links== |
|||
*[[User:Diberri|Diberri]]'s [http://diberri.dyndns.org/cgi-bin/templatefiller/ Wikipedia template filling tool] that will generate cite journal templates from [[PMID]] or [[PubMed Central|PMC]] values (as well as cite book, cite web and various infobox templates) |
|||
*[[User:DOI bot|DOI bot]] – You can ask this bot to automatically complete partial citations on pages of your choice. [[WP:DOI|Click here]] for more information. |
|||
*The [http://toolserver.org/~verisimilus/Scholar/ Universal Reference Formatter] – find articles using built-in [[Google Scholar]] interface, or DOI, PMID or PMC; automatically produce an appropriate cite template. Also features a [[BibTeX]] to <nowiki>{{cite}}</nowiki> converter. |
|||
*[[Zotero]] – find articles in [[Mozilla Firefox]] and easily paste them into Wikipedia as citation templates with Ctrl-Alt-C |
|||
==See also== |
|||
*[[Wikipedia:Cite sources]]: Style guide |
|||
*[[Wikipedia:Cite sources/example style]]: Style guide examples |
|||
*[[Wikipedia:Citation templates]]: Related templates |
|||
<includeonly> |
|||
<!-- ADD CATEGORIES BELOW THIS LINE --> |
|||
[[Category:Citation templates|{{PAGENAME}}]] |
|||
[[Category:Templates generating COinS|{{PAGENAME}}]] |
|||
<!-- ADD INTERWIKIS BELOW THIS LINE --> |
|||
[[bg:Шаблон:Cite journal]] |
|||
[[cs:Šablona:Citace časopisu]] |
|||
[[de:Vorlage:Cite journal]] |
|||
[[el:Πρότυπο:Cite journal]] |
|||
[[es:Plantilla:Cita revista]] |
|||
[[fr:Modèle:Article]] |
|||
[[hu:Sablon:Cite_journal]] |
|||
[[ia:Patrono:Cite journal]] |
|||
[[it:Template:Cite journal]] |
|||
[[ja:Template:Cite journal]] |
|||
[[ko:틀:저널 인용]] |
|||
[[no:Mal:Cite journal]] |
|||
[[pl:Szablon:Cytuj pismo]] |
|||
[[ru:Шаблон:Статья]] |
|||
[[sl:Predloga:Navedi revijo]] |
|||
[[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]] |
|||
</includeonly> |
|||
