Shawndouglas: /* Usage */

2017-09-12T00:54:35Z

Usage

← Older revision		Revision as of 17:54, 11 September 2017
Line 5:		Line 5:

	==Usage==		==Usage==
	All parameter names '''''must''''' be [[lower case]].		All parameter names '''''must''''' be lower case.

	Copy a blank version to use. Remember to use the "{{para}}" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.		Copy a blank version to use. Remember to use the "{{para}}" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

Shawndouglas: Created as needed.

2017-09-12T00:54:16Z

Created as needed.

New page

{{documentation subpage}}

This template is used to cite source, specifically for news sources. For citing journals/magazines and websites, see {{tl|Cite journal}} and {{tl|Cite web}}, respectively.

==Usage==
All parameter names '''''must''''' be [[lower case]].

Copy a blank version to use. Remember to use the "{{para}}" (pipe) character between each field. Please delete any unused fields to avoid clutter in the edit window.

Citations within a page should use consistent formats. However, there is no consensus about which format is best.

===Common form with author(s) in a single parameter===
;Day Month Year: <code><nowiki>{{cite news |title= |author= |url= |newspaper= |date= |accessdate=</nowiki>{{#time: j F Y}}<nowiki>}}</nowiki></code>

; Month Day, Year: <code><nowiki>{{cite news |title= |author= |url= |newspaper= |date= |accessdate=</nowiki>{{#time: F j, Y}}<nowiki>}}</nowiki></code>

===Common form with first and last===
;Day Month Year: <code><nowiki>{{cite news |title= |first= |last= |url= |newspaper= |date= |accessdate=</nowiki>{{#time: j F Y}}<nowiki>}}</nowiki></code>

;Month Day, Year: <code><nowiki>{{cite news |title= |first= |last= |url= |newspaper= |date= |accessdate=</nowiki>{{#time: F j, Y}}<nowiki>}}</nowiki></code>

===All parameters===
;All parameters, horizontal format (delete parameters you don't need):<code><nowiki>{{cite news |title= |author= |first= |last= |authorlink= |authorlink2= |author2= |author3= |author4= |author5= |author6= |author7= |url= |format= |agency= |newspaper= |publisher= |location= |isbn= |issn= |oclc= |pmid= |pmd= |bibcode= |doi= |id= |date= |page= |pages= |at= |accessdate= |language= |trans_title= |quote= |archiveurl= |archivedate= |deadurl= |ref=}}</nowiki></code>

;All parameters, vertical format
:{{#tag:pre|<nowiki>
{{cite news
| title =
| author =
| first =
| last =
| authorlink =
| authorlink2 =
| author2 =
| author3 =
| author4 =
| author5 =
| author6 =
| author7 =
| url =
| format =
| agency =
| newspaper =
| publisher =
| location =
| isbn =
| issn =
| oclc =
| pmid =
| pmd =
| bibcode =
| doi =
| id =
| date =
| page =
| pages =
| at =
| accessdate =
| language =
| trans_title =
| quote =
| archiveurl =
| archivedate =
| deadurl =
| ref =
}}</nowiki>
}}

====Essential parameters====
*'''title''': Title of the article. Note that title must be on one line in order for the hyperlink (if there is one) to display properly. Do not enclose it in quotations marks, italics or other formatting, though it may be wikilinked. Reduce "all capitals" to some other [[Title_case#Headings_and_publication_titles|title case.]]
*'''newspaper''': Name of the publication that ran the item, e.g., ''[[The Miami Herald]]'' or ''[[The Scotsman]]''. Can also be used for the name of a column or subpart of an issue. Do not italicize; the software will do so automatically. (You may also use '''journal''', '''magazine''', '''periodical''', or '''work''', but do ''not'' use '''publisher''' for this.)
*'''date''': Date of publication. To avoid ambiguity, write out the month in words, using the same date format as in the main text of the article. When this information is absent for an online source consider using {{tl|cite web}} instead.

====Optional parameters====
*'''author''': Author.
**'''last''' works with '''first''' to produce <code>last, first</code> as name of author.
**'''authorlink''' works either with '''author''' or with '''last''' & '''first''' to link to the appropriate wiki article. Does not work with URLs.
**'''author2''', '''author3''', ... '''author9''': Allows additional authors. Numbers must be used consecutively. '''author9''' is not actually displayed, but causes ''et al.'' to appear. Can also use '''last'''''n'', '''first'''''n'', and '''authorlink'''''n''.
**'''coauthors''': Equivalent to '''author2'''.
*'''url''': Link to the news item if available online (note this is not for a link to the main web page of the work of publisher, but only to a copy of the item specified in '''title'''). Start the url with the communications protocol e.g., [[hypertext Transfer Protocol|http]]://. '''Do not post urls of Google or Yahoo! hosted AP content, that content is transient. Use MSNBC or another provider that keeps AP archives.'''
*'''accessdate''': Date when the news item was accessed, if it was found online. Should be in the same format as the rest of the article. Must not be wikilinked.
*'''format''': Format, e.g. PDF. Don't specify for HTML (implied as default). This parameter is sometimes used for completely different purposes, with values such as "fee required" and "reprint", but its original intent was to warn readers of file formats that their browsers might have trouble with.
*'''agency''': The [[news agency]] (wire service) that provided the content, if any, e.g. [[Associated Press]], [[Reuters]], [[Agence France-Presse]], etc.
*'''location''': Place of publication, e.g., [[Toronto]] for ''[[The Globe and Mail]]''. Should be included if the city of publication is not part of the name of the newspaper. For [[student newspaper]]s, include the name of the school.
*'''publisher''': The [[publisher]] that publishes the news source ('''not''' to be used for the name of the news source itself; see the <code>newspaper</code> parameter). This is commonly omitted for major publications. In some instances (e.g. many UK newspapers), the publisher is the company or organization that owns the publication. In all American newspapers, the publisher is an individual person, whose name will be found on the [[masthead (publishing)|masthead]]. There is never any need to cite this person in a reference. This parameter should normally be left blank.
*'''isbn, issn, oclc, pmid, pmd, bibcode, doi''' Unique object identifiers, if applicable. Will automatically generate an appropriately wikilinked link to the object in question. Most ordinary newspaper articles will not have one of these.
*'''id''': Identifier of a type not listed above. Remember, if you use this parameter, you '''must''' specify the kind of identifier, not just give a number.
*'''page''' or '''pages''': The page(s) on which the article is found. '''page''' inserts the abbreviation "p." before the number; '''pages''' inserts "pp." Use only one of these parameters. If numbers are entered for both, '''pages''' overrides '''page'''.
*'''at''': Position within the newspaper when '''page'''/'''pages''' is unsuitable, e.g. {{para|at|p. 2, col. 3}}, {{para|at|p. 2, para. 4}} (when the page number is not sufficiently specific), {{para|at|section C, p. 2}} (when the newspaper has several sections, each starting their page numbering at 1), or {{para|at|no. 456}} (something in a numbered list). This parameter is ignored if either '''page'''/'''pages''' is specified.
*'''language''': The language in which the source is written. If English (the default) do not use this parameter. See also the 'trans_title' parameter.
**'''trans_title''': A translated title of the article, if the original title is in a foreign language. Would normally be used in conjunction with the 'language' parameter.
*'''quote''': Relevant quotation. Adding a quotation can help locate online copies of the item using a text search, especially if the original link goes dead.
*archive parameters ''(if used, must be used both of them together)''
**'''archiveurl''': The URL of an [[Web archiving|archived]] copy of a web page, if (or in case) the URL becomes unavailable. Typically used to refer to services like [[WebCite]] and [[Internet Archive|Archive.org]].
**'''archivedate''': Date when the item was archived. Should not be wikilinked. If not given, one might look up all available archive versions from URL <tt>http://web.archive.org/web/*/</tt> (append the full original URL) to determine an appropriate date.
**'''deadurl''': Should be set to "yes"/"no" to indicate if the original link is [[WP:LINKROT|dead]] or live. Setting {{para|deadurl|no}} will change the main link to the original url.
*'''ref''': ID for anchor. By default, no anchor is generated. The ordinary nonempty value {{para|ref|<var>ID</var>}} generates an anchor with the given <code><var>ID</var></code>; such a linkable reference can be made the target of wikilinks to full references, especially useful in short citations like shortened notes and parenthetical referencing. The special value {{para|ref|harv}} generates an anchor suitable for the {{tl|harv}} template; see ''[[Template:Citation/doc#Anchors for Harvard referencing templates|anchors for Harvard referencing templates]]''.
*'''postscript''': if specified, over-rides the default behavior of terminating the citation with a full stop. Leave blank to suppress the full stop. This may be useful when using a quote which ends in punctuation, or when generating an output consistent with other templates. It is preferred to manually adding ending punctuation, as the punctuation occurs within the <cite> tag, so will appear before any icons added by browser plugins.

== Examples ==
; Using first and last for author's name
*<nowiki>{{cite news
| first=Cassandra
| last=Jardine
| title=The return of the secondary modern
| url=http://www.telegraph.co.uk/culture/tvandradio/3621779/The-return-of-the-secondary-modern.html
| location = London
| agency=
| newspaper=The Daily Telegraph
| date=5 August 2004
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| first=Cassandra
| last=Jardine
| title=The return of the secondary modern
| url=http://www.telegraph.co.uk/culture/tvandradio/3621779/The-return-of-the-secondary-modern.html
| location = London
| agency=
| newspaper=The Daily Telegraph
| date=5 August 2004
}}</div>

;No author but sourced to a news agency
*<nowiki>{{cite news
| first=
| last=
| title=Drugs: Chips trader gets 15 years, 10 strokes
| url=http://www.dailyexpress.com.my/news.cfm?NewsID=48660
| newspaper=Daily Express
| location=Kota Kinabalu, Malaysia
| date=29 March 2007
| agency=Bernama
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| first=
| last=
| title=Drugs: Chips trader gets 15 years, 10 strokes
| url=http://www.dailyexpress.com.my/news.cfm?NewsID=48660
| newspaper=Daily Express
| location=Kota Kinabalu, Malaysia
| date=29 March 2007
| agency=Bernama
}}</div>

; Using authorlink to link to article about the author on the wiki
*<nowiki>{{cite news
| first=George
| last=Monbiot
| authorlink=George Monbiot
| title=From toxic waste to toxic assets, the same people always get dumped on
| url=http://www.guardian.co.uk/commentisfree/cif-green/2009/sep/21/global-fly-tipping-toxic-waste
| newspaper=The Guardian
| location=London
| date=22 September 2009
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| first=George
| last=Monbiot
| authorlink=George Monbiot
| title=From toxic waste to toxic assets, the same people always get dumped on
| url=http://www.guardian.co.uk/commentisfree/cif-green/2009/sep/21/global-fly-tipping-toxic-waste
| newspaper=The Guardian
| location=London
| date=22 September 2009
}}</div>

; Using "format" parameter when not HTML. No need to use "location" parameter because "New York" is already in name of paper.
*<nowiki>{{cite news
| newspaper=The New York Times
| title=State Prison Treatment
| date=4 February 1883
| url=http://query.nytimes.com/mem/archive-free/pdf?_r=1&res=9503E3D71631E433A25757C0A9649C94629FD7CF
| format=PDF
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| newspaper=The New York Times
| title=State Prison Treatment
| url=http://query.nytimes.com/mem/archive-free/pdf?_r=1&res=9503E3D71631E433A25757C0A9649C94629FD7CF
| format=PDF
| date=4 February 1883
}}</div>

; Using page to identify the reference by page; news item in library but not on line
*<nowiki>{{cite news
| first=Arthur
| last=Reed
| title=Four-rate plan in air-fare 'jungle'
| page=3
| date=9 December 1976
| newspaper=The Times
| location = London
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| first=Arthur
| last=Reed
| title=Four-rate plan in air-fare 'jungle'
| page=3
| date=9 December 1976
| newspaper=The Times
| location = London
}}</div>

; A foreign-language news article
*<nowiki>{{cite news
|author=Joliet, François
|title=Honni soit qui mal y pense
|date=30 April 2005
|language=French
|newspaper=Le Figaro
|location=Paris
|trans_title=Shame on those who think evil
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
|author=Joliet, François
|title=Honni soit qui mal y pense
|date=30 April 2005
|language=French
|newspaper=Le Figaro
|location=Paris
|trans_title=Shame on those who think evil
}}</div>

;Using archiveurl and archivedate to refer to items that disappeared from newspaper's own website but are now available from an archive site
*<nowiki>{{cite news
| author=Achenbaum, Emily S.
| title=Freedom lost, without a trial
| newspaper=The Charlotte Observer
| url=http://www.charlotteobserver.com/109/story/47573.html
| date=11 March 2007
| archiveurl=http://web.archive.org/web/20070419112159/www.charlotteobserver.com/109/story/47573.html
| archivedate=19 April 2007
}}</nowiki><br><div style="padding:0.5em">→ {{
cite news
| author=Achenbaum, Emily S.
| title=Freedom lost, without a trial
| newspaper=The Charlotte Observer
| url=http://www.charlotteobserver.com/109/story/47573.html
| date=11 March 2007
| archiveurl=http://web.archive.org/web/20070419112159/www.charlotteobserver.com/109/story/47573.html
| archivedate=19 April 2007
}}</div>

==See also==
* [[Template:Cite book]]
* [[Template:Cite web]]
* [[Template:Cite journal]]

<includeonly>
[[Category:Citation templates|{{PAGENAME}}]]
</includeonly>

Template:Cite news/doc - Revision history

Shawndouglas: /* Usage */

Shawndouglas: Created as needed.