Template:Cite news/doc: Difference between revisions
imported>Sladen (WP:BRD; temporaily revert until it can be checked over; too much newspaper/news-specific information appears to have disppeared (which is unlikely to have been intention. See the diff and entries on Newspaper, Publisher, etc) |
imported>Gadget850 (update parameters header (one per day)) |
||
Line 68: | Line 68: | ||
}} |
}} |
||
==Parameters== |
|||
===Syntax=== |
|||
{{csdoc|syntax}} |
|||
{{csdoc|coins}} |
|||
{{csdoc|sep_period}} |
|||
===Description=== |
|||
====Essential parameters==== |
====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.]] |
*'''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.]] |
Revision as of 21:39, 16 February 2012
![]() | This is a documentation subpage for Template:Cite news It may contain usage information, categories and other content that is not part of the original template page. |
This template is used to cite sources in Wikipedia. It is intended specifically for news sources. For citing journals/magazines and websites, see {{Cite journal}} and {{Cite web}}, respectively.
Usage
All parameter names must be lower case.
Copy a blank version to use. Remember to use the "|
" (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
{{cite news |title= |author= |url= |newspaper= |date= |accessdate=25 February 2025}}
- Month Day, Year
{{cite news |title= |author= |url= |newspaper= |date= |accessdate=February 25, 2025}}
Common form with first and last
- Day Month Year
{{cite news |title= |first= |last= |url= |newspaper= |date= |accessdate=25 February 2025}}
- Month Day, Year
{{cite news |title= |first= |last= |url= |newspaper= |date= |accessdate=February 25, 2025}}
All parameters
- All parameters, horizontal format (delete parameters you don't need)
{{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=}}
- All parameters, vertical format
{{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 = }}
Parameters
Syntax
Nested parameters rely on their parent parameters:
- parent
- OR: parent2—may be used instead of parent
- child—may be used with parent (and is ignored if parent is not used)
- OR: child2—may be used instead of child (and is ignored if parent2 is not used)
- Where aliases are listed, only one of the parameters may be defined; if multiple aliased parameters are defined, then only one will show.
This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata. As a general rule, only one data item per parameter. Do not include explanatory or alternate text:
- use
|date=27 September 2007
not|date=27 September 2007 (print version 25 September)
Use of templates within the citation template is discouraged because many of these templates will add extraneous HTML or CSS that will be included raw in the metadata. Also, HTML entities, for example
, –
, or  
, should not be used in parameters that contribute to the metadata.
COinS metadata is created for these parameters
Note: This table of metadata is displayed in the documentation of all Citation Style 1 templates. Not all of these parameters are supported by every CS1 template. Some of these parameters are mutually exclusive, some are aliases of another parameter, and some require other parameters to be present. A full list of this template's supported parameters, their aliases, and their dependencies is shown in the Usage section near the top of this documentation page.
|periodical=
,|journal=
,|newspaper=
,|magazine=
,|work=
,|website=
,|encyclopedia=
,|encyclopaedia=
,|dictionary=
|chapter=
,|script-chapter=
,|contribution=
,|script-contribution=
,|entry=
,|script-entry=
,|article=
,|script-article=
,|section=
,|script-section=
|title=
,|script-title=
,|book-title=
|publication-place=
,|place=
,|location=
|date=
,|year=
,|publication-date=
|series=
,|version=
|volume=
,|issue=
,|number=
|page=
,|pages=
,|at=
,|quote-page=
,|quote-pages=
|edition=
|publisher=
,|institution=
|url=
,|chapter-url=
,|contribution-url=
,|section-url=
|author-last=
,|author-last#=
,|author#-last=
,|author-surname=
,|author-surname#=
,|author#-surname=
,|last=
,|last#=
,|surname=
,|surname#=
,|author=
,|author#=
,|subject=
,|subject#=
,|host=
,|host#=
|author-first=
,|author-first#=
,|author#-first=
,|author-given=
,|author-given#=
,|author#-given=
,|first=
,|first#=
,|given=
,|given#=
|degree=
|arxiv=
,|bibcode=
,|biorxiv=
,|citeseerx=
,|doi=
,|eissn=
,|eprint=
,|hdl=
,|isbn=
,|issn=
,|jfm=
,|jstor=
,|lccn=
,|message-id=
,|mr=
,|oclc=
,|osti=
,|pmc=
,|pmid=
,|rfc=
,|ssrn=
,|s2cid=
,|zbl=
By default, sets of fields are terminated with a period (.).
Description
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.
- 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 {{cite web}} instead.
Optional parameters
- author: Author.
- last works with first to produce
last, first
as name of author. - authorlink works either with author or with last & first to link to the appropriate Wikipedia 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 lastn, firstn, and authorlinkn.
- coauthors: Equivalent to author2.
- last works with first to produce
- 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., 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 newspapers, 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
newspaper
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. 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.
|at=p. 2, col. 3
,|at=p. 2, para. 4
(when the page number is not sufficiently specific),|at=section C, p. 2
(when the newspaper has several sections, each starting their page numbering at 1), or|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 archived copy of a web page, if (or in case) the URL becomes unavailable. Typically used to refer to services like WebCite and 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 http://web.archive.org/web/*/ (append the full original URL) to determine an appropriate date.
- deadurl: Should be set to "yes"/"no" to indicate if the original link is dead or live. Setting
|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
|ref=ID
generates an anchor with the givenID
; 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|ref=harv
generates an anchor suitable for the {{harv}} template; see anchors for Harvard referencing templates. - postscript: if specified, over-rides the default behaviour 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
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- No author but sourced to a news agency
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- Using authorlink to link to article about the author on Wikipedia
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- Using "format" parameter when not HTML. No need to use "location" parameter because "New York" is already in name of paper.
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- Using page to identify the reference by page; news item in library but not on line
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- A foreign-language news article
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
- Using archiveurl and archivedate to refer to items that disappeared from newspaper's own website but are now available from an archive site
- {{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
}}→ Lua error: bad argument #1 to "get" (not a valid title).
COinS
This template produces COinS metadata; see COinS in Wikipedia for background information.
See also
- {{Citation}}
- {{Cite news}}
- {{Cite journal}}
- Wikipedia:Citing sources, style guideline
- Wikipedia:Citation templates, examples of template usage
- Wikipedia:WikiProject Wikicite