Template:Cite journal/doc: Difference between revisions
From All Skies Encyclopaedia
imported>Barak Sh m (+he) |
imported>Smith609 (Re-write for new format. Material from Template:Citation/doc used in construction.) |
||
| Line 5: | Line 5: | ||
==Usage== |
==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> |
|||
Complete the template as described below. |
|||
;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> |
|||
You can copy the code below and complete it by hand, or generate a reference automatically using [http://toolserver.org/~verisimilus/Scholar/Cite.php the Universal Reference Formatter]. |
|||
;All parameters, horizontal format |
|||
<tt><nowiki>{{cite journal |quotes= |last= |first= |author= |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=}}</nowiki></tt> |
|||
===Parameters=== |
|||
{| |
{| border="1" |
||
|- |
|||
! Using lastname, firstname !! Using author (firstname lastname) |
|||
|<pre> |
|||
|- width="50%" |
|||
{{Cite journal |
|||
| last = |
|||
| first = |
|||
| author-link = |
|||
| publication-date = |
|||
| date = |
|||
| year = |
|||
| title = |
|||
| periodical = |
|||
| series = |
|||
| publication-place = |
|||
| place = |
|||
| publisher = |
|||
| volume = |
|||
| issue = |
|||
| pages = |
|||
| url = |
|||
| issn = |
|||
| doi = |
|||
| oclc = |
|||
| accessdate = |
|||
}} |
|||
</pre> |
|||
| |
| |
||
* '''last''' (or '''last1'''): The author's surname or last name. |
|||
<pre> |
|||
* '''first''' (or '''first1'''): The author's first or given name(s). |
|||
{{cite journal |
|||
* '''author-link''' (or '''author1-link'''): Title of an existing Wikipedia article about the first author. |
|||
|quotes= |
|||
* '''last2''', '''last3''', '''last4''': The second, third, and fourth authors' surname or last name, if applicable. |
|||
|last= |
|||
* '''first2''', '''first3''', '''first4''': The second, third, and fourth authors' first or given name(s), if applicable. |
|||
|first= |
|||
* '''author2-link''', '''author3-link''', '''author4-link''': Title of an existing Wikipedia article about the second, third, and fourth author, if applicable. |
|||
|authorlink= |
|||
* '''publication-date''' (or '''date'''): Date of publication. |
|||
|coauthors= |
|||
* '''date''': Date of authorship, if different from date of publication. This is most useful in older newspapers where days or weeks could pass between authorship and publication. If only ''date'' is used, it will be treated as the date of publication. |
|||
|date= |
|||
* '''year''': Year of authorship or publication. (Mandatory for use with links from [[:Template:Harvard citation]]. In some situations, the template may be able to derive a year from the full date.) |
|||
|year= |
|||
* '''title''': Title of the article in the periodical. |
|||
|month= |
|||
* '''periodical''' (or '''journal''', '''newspaper''', '''magazine'''): Name of the periodical. |
|||
|title= |
|||
* '''series''': Series of which this periodical is a part. |
|||
|journal= |
|||
* '''publication-place''': The city of the periodical's publication. This is not recommended for established and widely-distributed periodicals (''[[Vanity Fair]]''), or periodicals in which the title contains the place of publication (''[[New York Times]]''). If more than one town/city is listed on the title page, give the first one or the location of the publisher's head office. If the city is not well-known, you may add a county, region, or state. States in the U.S. are denoted by a two-letter code; for example: <code>place=Paris, TX</code> (no period at the end). Where the publisher is a university and the place or location is included in the name of the university, do not use this parameter. |
|||
|volume= |
|||
* '''place''': City from which the article was written. Generally, this is used to denote the dateline city of a newspaper article. |
|||
|issue= |
|||
* '''publisher''': The name of the periodical's publisher. Use of this parameter is not recommended for most periodicals, unless it would help the reader in locating a copy. Omit terms such as ''Publishers'', ''Co.'', ''Inc.'', ''Ltd.'', etc., but retain the words ''Books'' or ''Press''. |
|||
|pages= |
|||
* '''volume''': The volume number of the journal. |
|||
|publisher= |
|||
* '''issue''' (or '''number'''): The issue number of the journal. |
|||
|location= |
|||
* '''pages''' (''optional''): The pages in the issue where the article may be found. |
|||
|issn= |
|||
* '''url''': An [[url]] of an online location where the article can be found. |
|||
|pmid= |
|||
* '''issn''': The eight-digit [[International Standard Serial Number]] (ISSN) identifying the journal. |
|||
|pmc= |
|||
* '''doi''': A [[digital object identifier]] such as ''<nowiki>10.1016/j.coi.2004.08.001</nowiki>''. |
|||
|doi= |
|||
* '''oclc''': [[Online Computer Library Center]] ID number, such as ''3185581'' |
|||
|bibcode= |
|||
* '''accessdate''': Date when the url was accessed. Unlinked [[ISO 8601]] format is preferred. |
|||
|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> |
|||
|} |
|} |
||
===Examples=== |
|||
*'''quotes''': 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). |
|||
{| border="1" |
|||
*'''author''': Author |
|||
|- |
|||
**'''last''' works with '''first''' to produce <code>last, first;</code> |
|||
|<pre> |
|||
**'''authorlink''' works either with '''author''' or with '''last''' & '''first''' to link to the appropriate article ([[Wikipedia:Interwikimedia link|interwiki link]]) |
|||
{{Cite journal |
|||
**'''coauthors''': allows additional authors |
|||
| last=Hill |
|||
*'''date''': ''<nowiki>[[January 1]], [[2006]]</nowiki>''. Full [[Wikipedia:Date#Dates|date]] of publication. |
|||
| first=Marvin S. |
|||
**'''year''': ''2006''. Year of publication (ignored if the ''date'' field is used). |
|||
| title=Joseph Smith and the 1826 |
|||
***'''month''': ''January''. Month of publication (ignored if the ''date'' field is used, or if the ''year'' field is ''not'' used). |
|||
Trial: New Evidence and New |
|||
*'''title''': Title of article. '''''This is the only required parameter. All other parameters are optional.''''' |
|||
Difficulties |
|||
*'''journal''': Name of the journal or periodical. |
|||
| journal=BYU Studies |
|||
*'''volume''': Volume number of the journal in which the article is found |
|||
| volume=12 |
|||
*'''issue''': Issue number of the journal in which the article is found |
|||
| issue=2 |
|||
*'''pages''': ''<nowiki>45–47</nowiki>'': first page, and optional last page (separated by an [[en dash]] –). Manually prepend with ''p.'' or ''pp.'' if desired. |
|||
| year=1976 |
|||
*'''publisher''': Publisher of journal or periodical; should not include corporate designation such as "Ltd" or "Inc". Only include if ISSN and DOI are unavailable. |
|||
| pages=1–8 |
|||
**'''location''': Place of publication for journal or periodical. |
|||
| url=https://byustudies.byu.edu/ |
|||
*'''issn''': The publication's [[International Standard Serial Number]] such as ''1111-2220''. Only include if a DOI is unavailable. |
|||
shop/PDFSRC/12.2Hill.pdf |
|||
*'''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'' |
|||
</pre> |
|||
*'''oclc''': The periodical's [[Online Computer Library Center]] ID number, such as ''3185581'' |
|||
|{{Cite journal |
|||
*'''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>. |
|||
| last=Hill |
|||
:*'''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". |
|||
| first=Marvin S. |
|||
*'''bibcode''': The document's [[bibcode]] in the [[Astrophysics Data System]], e.g., ''1924MNRAS..84..308E'' |
|||
| title=Joseph Smith and the 1826 Trial: New Evidence and New Difficulties |
|||
*'''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>.) |
|||
| journal=BYU Studies |
|||
*'''url''': This should point to, in descending order of preference: |
|||
| volume=12 |
|||
:#A ''free'' online version of the full text |
|||
| issue=2 |
|||
:#An online version of the ''full text'', for which subscription is required |
|||
| year=1976 |
|||
:#An abstract or information page, ''if'' no DOI or PMID record is available |
|||
| pages=1–8 |
|||
::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. |
|||
| url=https://byustudies.byu.edu/shop/PDFSRC/12.2Hill.pdf |
|||
:*'''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}}". This parameter is hidden from readers and only visible in the source of the page. |
|||
:''Note:'' The access date will not be displayed as it is only intended to help editors recover dead links. |
|||
*'''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: |
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: |
||
| Line 130: | Line 104: | ||
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. |
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== |
==Further Examples== |
||
;Formal citation |
;Formal citation |
||
:<tt><nowiki> |
:<tt><nowiki> |
||
| Line 340: | Line 314: | ||
==Useful links== |
==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. |
*[[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. |
*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. |
||
*[[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) |
|||
*[[Zotero]] – find articles in [[Mozilla Firefox]] and easily paste them into Wikipedia as citation templates with Ctrl-Alt-C |
*[[Zotero]] – find articles in [[Mozilla Firefox]] and easily paste them into Wikipedia as citation templates with Ctrl-Alt-C |
||
Revision as of 01:36, 3 October 2008
 | This is a documentation subpage for Template:Cite journal It may contain usage information, categories and other content that is not part of the original template page. |
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 <ref> tags for in-line citations (see Wikipedia:Footnotes).
Usage
Complete the template as described below.
You can copy the code below and complete it by hand, or generate a reference automatically using the Universal Reference Formatter.
Parameters
{{Cite journal
| last =
| first =
| author-link =
| publication-date =
| date =
| year =
| title =
| periodical =
| series =
| publication-place =
| place =
| publisher =
| volume =
| issue =
| pages =
| url =
| issn =
| doi =
| oclc =
| accessdate =
}}
|
|
Examples
{{Cite journal
| last=Hill
| first=Marvin S.
| title=Joseph Smith and the 1826
Trial: New Evidence and New
Difficulties
| journal=BYU Studies
| volume=12
| issue=2
| year=1976
| pages=1–8
| url=https://byustudies.byu.edu/
shop/PDFSRC/12.2Hill.pdf
}}
|
Lua error: bad argument #1 to "get" (not a valid title). |
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 <ref>...</ref> tag using other citation templates; for example:
- Text in the article.<ref>{{cite journal | ... }}<br/>
'''Related news articles:'''
*{{cite news | ... }}
*{{cite web | ... }}</ref>
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.
Further Examples
- Formal citation
- {{cite journal |last=Smith |first=Joseph III |title=Last Testimony of Sister Emma |journal=The Saints' Herald |volume=26 |year=1879 |month=October |pages=289}}
- → Lua error: bad argument #1 to "get" (not a valid title).
- Include URL link to free-article, pre-print or abstract; also supply access date unless the URL is known to be stable.
- {{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]]}}
- → Lua error: bad argument #1 to "get" (not a valid title).
- 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
- {{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}}
- → Lua error: bad argument #1 to "get" (not a valid title).
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:
- {{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=}}
- → Lua error: bad argument #1 to "get" (not a valid title).
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":
- {{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=}}
- → Lua error: bad argument #1 to "get" (not a valid title).
- Other examples
- {{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}}
- → Lua error: bad argument #1 to "get" (not a valid title).
- {{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}}
- → Lua error: bad argument #1 to "get" (not a valid title).
- {{cite journal |title=Disney Releases 10 Titles on Laser Videodisc |year=1982 |journal=VIDEODISC/VIDEOTEX |volume=2 |issue=3 |pages=175}}
- → Lua error: bad argument #1 to "get" (not a valid title).
COinS
This template produces COinS metadata; see COinS in Wikipedia for background information.
Useful links
- DOI bot – You can ask this bot to automatically complete partial citations on pages of your choice. Click here for more information.
- The 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 {{cite}} converter.
- Diberri's Wikipedia template filling tool that will generate cite journal templates from PMID or PMC values (as well as cite book, cite web and various infobox templates)
- 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
