Template:Cite web/doc: Difference between revisions
| [checked revision] | [checked revision] |
Content deleted Content added
Caleb Cooper (talk | contribs) No edit summary Tag: 2017 source edit |
Caleb Cooper (talk | contribs) No edit summary Tags: Reverted 2017 source edit |
||
Line 1:
<noinclude>{{pp-template}}</noinclude>
{{Documentation subpage}}
{{High-
{{csdoc|lua}}
{{csdoc|cs1}}
{{csdoc|lead|news articles in print, video, audio or web}}
==Usage==
{{csdoc|usage}}
{{csdoc|usage common}}
;To cite a news article with a credited author
;To cite a news article with no credited author
<syntaxhighlight lang="wikitext" inline>{{cite news |author=<!--not stated--> |date= |title= |url= |work= |location= |access-date=}}</syntaxhighlight>
;To cite an online news article that has been archived
<syntaxhighlight lang="wikitext" inline>{{cite news |last= |first= |date= |title= |url= |url-status= |work= |location= |archive-url= |archive-date= |access-date=}}</syntaxhighlight>
;To cite a news article written in a foreign language
<syntaxhighlight lang="wikitext" inline>{{cite news |last= |first= |date= |title= |trans-title= |url= |language= |work= |location= |access-date=}}</syntaxhighlight>
;To cite and quote an archived news article clipped with an information aggregation service requiring a subscription
<syntaxhighlight lang="wikitext" inline>{{cite news |last1= |first1= |last2= |first2= |date= |title= |trans-title= |url= |url-status= |language= |work= |location= |archive-url= |archive-date= |access-date= |via= |quote=}}</syntaxhighlight>
{{end}}
{{csdoc|usage full}}
:<syntaxhighlight lang="wikitext" inline>{{cite
{{end}}
{{csdoc|usage vertical common}}
;To cite a news article with a credited author
<syntaxhighlight lang="wikitext" style="margin:0px; border:none;">
{{cite news
| last =
| first =
| date =
| title =
| url =
|
| location =
| access-date =
}}
</syntaxhighlight>
;To cite a news article with no credited author
<syntaxhighlight lang="wikitext" style="margin:0px; border:none;">
{{cite news
| author =<!--not stated-->
| title =
| url =
| work =
| location =
| date =
| access-date =
}}
</syntaxhighlight>
;To cite an online news article that has been archived
<syntaxhighlight lang="wikitext" style="margin:0px; border:none;">
{{cite news
| last =
| first =
| date =
|
|
|
|
| location =
|
|
|
}}
</syntaxhighlight>
;To cite a news article written in a foreign language
<syntaxhighlight lang="wikitext" style="margin:0px; border:none;">
{{cite news
| last =
| first =
| date =
| title =
| trans-title =
|
|
|
|
| access-date =
}}
</syntaxhighlight>
;To cite and quote a clipped and archived news article on an information aggregation service requiring a subscription
<syntaxhighlight lang="wikitext" style="margin:0px; border:none;">
{{cite news
| last1 =
| first1 =
| last2 =
| first2 =
| date =
| title =
| trans-title =
| url =
| url-status =
| format =
| language =
| work =
| location =
| archive-url =
| archive-date =
| access-date =
| via =
| url-access =
| quote =
}}
</syntaxhighlight>
{{end}}
{{csdoc|usage vertical}}
<pre style="margin:0px; border:none;">
{{cite news
| 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-style =
| date =
| year =
| orig-date =
| title =
| script-title =
| trans-title =
| url =
| url-status =
| format =
| 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 =
| department =
| work =
| type =
| series =
| language =
| volume =
| issue =
| others =
| edition =
| location =
| publisher =
| publication-date =
| agency =
| page =
| pages =
| at =
| no-pp =
| arxiv =
| asin =
| bibcode =
| doi =
| doi-broken-date =
| isbn =
| issn =
| jfm =
| jstor =
| lccn =
| mr =
| oclc =
| ol =
| osti =
| pmc =
| pmid =
| rfc =
| ssrn =
| zbl =
| id =
| archive-url =
| archive-date =
| access-date =
| via =
| quote =
| postscript =
| ref =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px; border:none
Line 103 ⟶ 252:
Line 112 ⟶ 258:
Line 151 ⟶ 294:
Line 163 ⟶ 302:
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px; border:none
Line 230 ⟶ 401:
{{csdoc|usage vertical end}}
===Choosing between
{{anchor|Consistency}}
As of {{diff|Module:Citation/CS1|732205428|723907342|29 July 2016}}, {{tlf|
*
*
But given the same set of valid parameters, their output is exactly the same:
<!-- ATTENTION!
Line 244 ⟶ 415:
-->
{|
| '''
|-
| '''
|}
==Examples==
; A news article with a credited author
: <code><nowiki>{{cite news |last=Wolford |first=Ben |date=2013-10-16 |title=Citrus Canker Lawsuit Headed Back to Trial |url=http://www.sun-sentinel.com/news/palm-beach/fl-citrus-canker-ruling-20131016,0,7602285.story |work=South Florida Sun-Sentinel |access-date=2013-10-17|ref=none}}</nowiki></code>
: Displays as:
* {{cite news |last=Wolford |first=Ben |date=2013-10-16 |title=Citrus Canker Lawsuit Headed Back to Trial |url=http://www.sun-sentinel.com/news/palm-beach/fl-citrus-canker-ruling-20131016,0,7602285.story |work=South Florida Sun-Sentinel |access-date=2013-10-17|ref=none}}
; A news article released by a news agency and having no credited author
: <code><nowiki>{{cite news |author=<!--not stated--> |title=Bellingham Police Arrest WWU Student in Melee |url=http://blogs.seattletimes.com/today/2013/10/bellingham-police-arrest-wwu-student-in-melee/ |work=The Seattle Times |agency=Associated Press |date=2013-10-17 |access-date=2013-10-17|ref=none}}</nowiki></code>
: Displays as:
* {{cite news |author=<!--not stated--> |title=Bellingham Police Arrest WWU Student in Melee |url=http://blogs.seattletimes.com/today/2013/10/bellingham-police-arrest-wwu-student-in-melee/ |work=The Seattle Times |agency=Associated Press |date=2013-10-17 |access-date=2013-10-17|ref=none}}
; A news article that has been archived
: <code><nowiki>{{cite news |last=Pank |first=Philip |date=2013-10-18 |title=Families Accuse Network Rail of Cover-Up |url=http://www.thetimes.co.uk/tto/business/industries/transport/article3897709.ece |url-status=dead |work=The Times |location=London |archive-url=https://www.webcitation.org/6KS5scqfE |archive-date=2013-10-18 |access-date=2013-10-18|ref=none}}</nowiki></code>
: Displays as:
* {{cite news |last=Pank |first=Philip |date=2013-10-18 |title=Families Accuse Network Rail of Cover-Up |url=http://www.thetimes.co.uk/tto/business/industries/transport/article3897709.ece |url-status=dead |work=The Times |location=London |archive-url=https://www.webcitation.org/6KS5scqfE |archive-date=2013-10-18 |access-date=2013-10-18|ref=none}}
; A news article written in a foreign language
: <code><nowiki>{{cite news |last=Bourmaud |first=François-Xavier |date=2013-10-17 |title=Hollande dans le bourbier de l'affaire Leonarda |trans-title=Hollande in the quagmire of the Leonarda case |url=http://www.lefigaro.fr/politique/2013/10/17/01002-20131017ARTFIG00575-hollande-dans-le-bourbier-de-l-affaire-leonarda.php |language=French |work=Le Figaro |location=Paris |access-date=2013-10-17|ref=none}}</nowiki></code>
: Displays as:
* {{cite news |last=Bourmaud |first=François-Xavier |date=2013-10-17 |title=Hollande dans le Bourbier de L'affaire Leonarda |trans-title=Holland in the Quagmire of the Leonarda Case |url=http://www.lefigaro.fr/politique/2013/10/17/01002-20131017ARTFIG00575-hollande-dans-le-bourbier-de-l-affaire-leonarda.php |language=French |work=Le Figaro |location=Paris |access-date=2013-10-17|ref=none}}
; A clipped and archived news article that you quote, found on an information aggregation service requiring a subscription
: <code><nowiki>{{cite news |url=https://www.newspapers.com/clip/30201172/daily_news/ |title=Czechs honor Yuri |date=30 April 1961 |newspaper=Daily News|access-date=2 April 2019|archive-url=https://web.archive.org/web/20190402233429/https://www.newspapers.com/clip/30201172/daily_news/|archive-date=2 April 2019|url-status=live |agency=Reuters |location=New York |page=35 |via=Newspapers.com |quote=Czech President [[Antonin Novotny]] today made visiting Soviet spaceman Yuri Gagarin a 'Hero of Socialist Labor'.|ref=none}}</nowiki></code>
: Displays as:
* {{cite news |url=https://www.newspapers.com/clip/30201172/daily_news/ |title=Czechs honor Yuri |date=30 April 1961 |newspaper=Daily News|access-date=2 April 2019|archive-url=https://web.archive.org/web/20190402233429/https://www.newspapers.com/clip/30201172/daily_news/|archive-date=2 April 2019|url-status=live |agency=Reuters |location=New York |page=35 |via=Newspapers.com |quote=Czech President [[Antonin Novotny]] today made visiting Soviet spaceman Yuri Gagarin a 'Hero of Socialist Labor'.|ref=none}}
==Parameters==
===Syntax===
{{csdoc|syntax}}
{{csdoc|sep_period}}
Line 631 ⟶ 466:
====Title====
{{csdoc|
{{csdoc|language}}
====Periodical (work, newspaper, website)====
{{csdoc|
====Publisher====
{{csdoc|publisher
{{csdoc|agency}}
====
{{csdoc|
====Edition, volume====
{{csdoc|edition}}
{{csdoc|volume}}
====In-source locations====
{{csdoc|pages}}
====
{{csdoc|url}}
====Anchor====
Line 680 ⟶ 511:
==TemplateData==
{{TemplateData header}}
{{#invoke:cs1 documentation support|template_data_validate|{{ROOTPAGENAME}}}}
<templatedata>
{
"description": "
"params": {
"url": {
"label": "URL",
"description": "The URL of the online location where the text of the publication can be found. Requires schemes of the type \"
"type": "url",
"suggested": true,
"aliases": [
"URL"
],
"example": "https://www.nytimes.com/..."
},
"title": {
"label": "
"description": "The title of the
"type": "string",
"required": true
},
"last": {
"label": "Last name",
"description": "The surname of the author; don't wikilink, use 'author-link'
"aliases": [
"last1",
"author",
"author1"
],
"
"
},
"first": {
"label": "First name",
"description": "Given or first name, middle names, or initials of the author; don't wikilink, use 'author-link'
"aliases": [
"
],
"
"type": "line"
},
"date": {
"label": "Source date",
"description": "Full date of the source; do not wikilink",
"type": "date",
"suggested": true
},
"
"label": "
"description": "
"type": "
"aliases": [
"
"example": "[[Gannett]]"
},
"last2": {
"label": "Last name 2",
"description": "The surname of the second author; don't wikilink, use 'author-link2'.",
"aliases": [
"author2"
Line 790 ⟶ 577:
"first2": {
"label": "First name 2",
"description": "Given or first name, middle names, or initials of the second author; don't wikilink."
},
"others": {
"label": "Others",
"description": "Used to record other
"type": "string"
},
"year": {
"label": "Year of publication",
"description": "Year of the source being referenced;
"type": "string"
},
"editor-last": {
"label": "Editor last name",
"description": "The surname of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors
"aliases": [
"editor-last1",
"editor1-last",
"editor-surname",
"editor-surname1",
"editor1-surname",
"editor",
"editor1"
]
},
Line 828 ⟶ 605:
"label": "Editor first name",
"description": "Given or first name, middle names, or initials of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors; alias of 'editor1-first'",
"aliases": [
"
"editor1-first",
"editor-given",
"editor-given1",
"editor1-given"
]
},
"editor-link": {
"label": "Editor link",
"description": "Title of existing Wikipedia article about the editor; can suffix with a numeral to add additional editors; alias of 'editor1-link'",
"type": "wiki-page-name",
"aliases": [
"editor-link1"
]
},
"issue": {
"label": "Issue",
"description": "Issue identifier when the source is part of a series that is published periodically. Usually a number. Do not prepend with no. ",
"type": "line",
"aliases": [
"
],
"
},
"
"label": "
"description": "
"type": "string"
},
"location": {
"label": "Location of publication",
"description": "Geographical place of publication; usually not wikilinked; omit when the publication name includes place; alias of 'place'",
"type": "string",
"aliases": [
"place"
]
},
"publication-place": {
Line 854 ⟶ 651:
"label": "Publication date",
"description": "Date of publication when different from the date the work was written; do not wikilink",
"type": "date",
"autovalue": ""
},
"agency": {
"label": "Agency",
"description": "The news agency (wire service) that provided the content; examples: Associated Press, Reuters, Agence France-Presse",
"type": "string"
},
"edition": {
"label": "Edition",
"description": "When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed with ' ed.'",
"type": "string"
},
"volume": {
"label": "Volume",
"description": "For one publication published in several volumes. Usually a number. Do not prepend with vol. or v. ",
"type": "string",
"example": "3"
},
"page": {
Line 864 ⟶ 678:
"label": "Pages",
"description": "Pages in the source that support the content (not an indication of the number of pages in the source); displays after 'pp.'",
"type": "string",
"example": "2–3",
"suggested": true
},
"no-pp": {
Line 879 ⟶ 695:
"language": {
"label": "Language",
"description": "The language in which the source is written, if not English; use a two-letter language code or the full language name. Do not use icons or templates
"type": "string"
},
"script-title": {
"label": "Script title",
"description": "For titles in languages that do not use a Latin-based alphabet (Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, Vietnamese, etc
"type": "string"
},
Line 925 ⟶ 737:
"description": "Bibliographic Reference Code (REFCODE); 19 characters",
"type": "string"
},
"doi": {
Line 944 ⟶ 746:
"label": "DOI broken date",
"description": "The date that the DOI was determined to be broken",
"type": "date"
},
"isbn": {
"label": "ISBN",
"description": "International Standard Book Number; use the 13-digit ISBN where possible",
"type": "string",
"aliases": [
"ISBN"
]
},
"issn": {
"label": "ISSN",
"description": "International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen",
"type": "string",
"aliases": [
"ISSN"
]
},
"jfm": {
Line 1,020 ⟶ 827:
"label": "id",
"description": "A unique identifier used where none of the specialized ones are applicable",
"type": "string"
},
"quote": {
"label": "Quote",
"description": "Relevant text quoted from the source; displays last, enclosed in quotes;
"type": "string"
},
"trans-quote": {
Line 1,059 ⟶ 841:
"ref": {
"label": "Ref",
"description": "An anchor identifier; can be made the target of wikilinks to full references; special value 'harv' generates an anchor suitable for the harv and sfn templates",
"type": "string"
},
"postscript": {
"label": "Postscript",
"description": "The closing punctuation for the citation; ignored if 'quote' is defined; to suppress use reserved keyword 'none'",
"type": "string",
"default": "."
},
"last3": {
"label": "Last name 3",
"description": "The surname of the third author; don't wikilink, use 'author-link3'.",
"aliases": [
"author3"
Line 1,083 ⟶ 859:
"first3": {
"label": "First name 3",
"description": "Given or first name, middle names, or initials of the third author; don't wikilink."
},
"last4": {
"label": "Last name 4",
"description": "The surname of the fourth author; don't wikilink, use 'author-link4'.",
"aliases": [
"author4"
Line 1,104 ⟶ 870:
"first4": {
"label": "First name 4",
"description": "Given or first name, middle names, or initials of the fourth author; don't wikilink."
},
"last5": {
"label": "Last name 5",
"description": "The surname of the fifth author; don't wikilink, use 'author-link5'.",
"aliases": [
"author5"
Line 1,125 ⟶ 881:
"first5": {
"label": "First name 5",
"description": "Given or first name, middle names, or initials of the fifth author; don't wikilink."
},
"last6": {
"label": "Last name 6",
"description": "The surname of the sixth author; don't wikilink, use 'author-link6'.",
"aliases": [
"author6"
Line 1,146 ⟶ 892:
"first6": {
"label": "First name 6",
"description": "Given or first name, middle names, or initials of the sixth author; don't wikilink."
},
"last7": {
"label": "Last name 7",
"description": "The surname of the seventh author; don't wikilink, use 'author-link7'.",
"aliases": [
"author7"
Line 1,167 ⟶ 903:
"first7": {
"label": "First name 7",
"description": "Given or first name, middle names, or initials of the seventh author; don't wikilink."
},
"last8": {
"label": "Last name 8",
"description": "The surname of the eighth author; don't wikilink, use 'author-link8'.",
"aliases": [
"author8"
Line 1,188 ⟶ 914:
"first8": {
"label": "First name 8",
"description": "Given or first name, middle names, or initials of the eighth author; don't wikilink."
},
"last9": {
"label": "Last name 9",
"description": "The surname of the ninth author; don't wikilink, use 'author-link9'.",
"aliases": [
"author9"
Line 1,209 ⟶ 925:
"first9": {
"label": "First name 9",
"description": "Given or first name, middle names, or initials of the ninth author; don't wikilink."
},
"author-
"label": "Author
"description": "Replaces the name of the first author with em dashes or text; set to a numeric value 'n' to set the dash 'n' em spaces wide; set to a text value to display the text without a trailing author separator; for example, 'with' instead",
"type": "string"
},
"display-authors": {
"label": "Display authors",
"description": "number of authors to display before 'et al.' is used;",
"type": "number"
},
"author-link": {
"label": "Author link",
"description": "Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors",
"type": "wiki-page-name",
"aliases": [
"
"author1-link"
]
},
"
"label": "
"description": "Title of existing Wikipedia article about the second author.",
"type": "
"aliases": [
"author2-link"
]
},
"
"label": "
"description": "The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archive-date'",
"type": "string",
"
"
]
},
"
"label": "
"description": "
"type": "string",
"suggested": true,
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"author3-link"
]
},
"
"label": "
"description": "
"type": "wiki-page-name",
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
},
"
"label": "
"description": "The
"type": "date",
"suggested": true,
"aliases": [
"
]
},
"
"label": "
"description": "
"type": "
},
"
"label": "
"description": "Identify the aggregator of the resource that provided the digital version (usually a database provider), when it differs from the publisher (e.g., for The Wikipedia Library)",
"example": "[[EBSCOHost]], [[Proquest]], [[Newspapers.com]]",
"type": "string"
},
"url-access": {
Line 1,399 ⟶ 1,067:
"description": "If the full text is available from ADS via this Bibcode, type 'free'.",
"type": "string",
"
"free"
]
},
"doi-access": {
Line 1,405 ⟶ 1,075:
"description": "If the full text is free to read via the DOI, type 'free'.",
"type": "string",
"
"free"
]
},
"hdl-access": {
Line 1,411 ⟶ 1,083:
"description": "If the full text is free to read via the HDL, type 'free'.",
"type": "string",
"
"free"
]
},
"jstor-access": {
Line 1,417 ⟶ 1,091:
"description": "If the full text is free to read on Jstor, type 'free'.",
"type": "string",
"
"free"
]
},
"ol-access": {
Line 1,423 ⟶ 1,099:
"description": "If the full text is free to read on OpenLibrary, type 'free'.",
"type": "string",
"
"free"
]
},
"osti-access": {
Line 1,429 ⟶ 1,107:
"description": "If the full text is free to read on OSTI, type 'free'.",
"type": "string",
"
"free"
]
},
"url-status": {
"label": "URL status",
"description": "If set to 'live', the title display is adjusted; useful for when the URL is archived preemptively but still live. Set to
"example": "'dead' or 'live'",
"default": "'dead' if an Archive URL is entered",
"type": "string",
"suggested": true,
"suggestedvalues": [
Line 1,458 ⟶ 1,126:
]
},
"
"
"journal",
"
"periodical",
"
"
],
"
"description": "Name of the newspaper, magazine or periodical; displays after title",
"example": "[[The Wall Street Journal]]",
"type": "string",
"suggested": true
}
},
"maps": {
"proveit": {
"main": "title",
"textarea": [
"quote"
]
},
"citoid": {
"title": "title",
"url": "url",
"publisher": "publisher",
"publicationTitle": "work",
"date": "date",
"accessDate": "access-date",
"location": "location",
"ISSN": [
"issn"
],
"ISBN": [
"isbn"
],
"PMCID": "pmc",
"PMID": "pmid",
"pages": "pages",
"
"
"DOI": "doi",
"oclc": "oclc",
"language": "language",
"contributor": "others",
Line 1,532 ⟶ 1,213:
"editor-first",
"editor-last"
]
]
}
},
"format": "{{_ |_=_}}",
"paramOrder": [
"last",
Line 1,596 ⟶ 1,246:
"first9",
"author-link9",
"author-mask",
"display-authors",
Line 1,606 ⟶ 1,255:
"editor-first",
"editor-link",
"others",
"title",
Line 1,639 ⟶ 1,264:
"archive-url",
"archive-date",
"access-date",
"
"
"publisher",
"
"page",
"pages",
Line 1,651 ⟶ 1,275:
"type",
"format",
"edition",
"publication-place",
"publication-date",
"via",
"volume",
"issue",
"no-pp",
"arxiv",
Line 1,659 ⟶ 1,286:
"asin-tld",
"bibcode",
"doi",
"doi-broken-date",
Line 1,682 ⟶ 1,307:
"ref",
"postscript",
"bibcode-access",
"doi-access",
Line 1,690 ⟶ 1,314:
"osti-access",
"agency"
]
}
</templatedata>
==
{{Citation Style 1}}
{{Wikipedia referencing}}
Line 1,703 ⟶ 1,325:
<includeonly>{{Sandbox other||
[[Category:Citation Style 1 templates|
}}</includeonly>
| |||