模板:Cite news/doc

本文档是Template:Cite news的文档子页面 （见模板页自身）。
本页包含用法信息、分类和其他非原模板页面的内容。

本模板已应用于88,000+页面。
为避免大规模的破坏及不必要的服务器负荷，任何改动均应先在模板的沙盒、测试样例页面或您自己的用户页测试，经过测试后即可一次性改动本模板。为尊重其他用户，任何改动在生效前都应先在讨论页讨论。

使用Lua语言编写：

模块:Citation/CS1

Template:Citation Style documentation/cs1

模板简介

描写维基条目时经常需要参考各种新闻类资源，因此更多地使用这个模板可以将所参考的来源记录下来，以便浏览者以及之后的编写者找到这些来源资料。

本模板是用来列明维基条目中的新闻来源（参见列明来源的关于于维基条目列明的一般注意事项，并参见{{cite web}}学习如何列明非新闻来源）。

模板用法

所有参数都必须使用小写字母。

使用时可以复制下面的空白模板。参数之间以“|”符号分隔。请删除未使用的参数以保持编辑框的整齐。

Template:Csdoc Template:Csdoc

引用一篇有作者的新闻

{{cite news |author= |last= |first= |date= |title= |url= |newspaper= |location= |access-date= }}

引用一篇没有作者的新闻

{{cite news |author= |title= |url= |newspaper= |location= |date= |access-date= }}

引用已存档的在线新闻

{{cite news |last= |first= |date= |title= |url= |dead-url= |newspaper= |location= |archive-url= |archive-date= |access-date= }}

引用由外语写的新闻

{{cite news |last= |first= |date= |title= |trans-title= |url= |language= |newspaper= |location= |access-date= }}

引用一篇已存档、由两名作者编写、在须订阅的信息汇集服务上以PDF档再出版的外语新闻文章

{{cite news |author1= |last1= |first1= |author2= |last2= |first2= |date= |title= |trans-title= |url= |dead-url= |format= |language= |newspaper= |location= |archive-url= |archive-date= |access-date= |via= |subscription= |quote= }} |}

Template:Csdoc

{{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-format= |last-author-amp= |date= |year= |title= |script-title= |trans-title= |url= |dead-url= |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= |newspaper= |type= |series= |language= |volume= |issue= |others= |edition= |location= |publisher= |publication-date= |agency= |page= |pages= |at= |nopp= |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= |registration= |subscription= |lay-url= |lay-source= |lay-date= |quote= |postscript= |ref= }}

|}

直式排列的全部参数

{{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-format      = 
| last-author-amp       = 
| date                  = 
| year                  = 
| title                 = 
| script-title          = 
| trans-title           = 
| url                   = 
| dead-url              = 
| 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            = 
| newspaper             = 
| type                  = 
| series                = 
| language              = 
| volume                = 
| issue                 = 
| others                = 
| edition               = 
| location              = 
| publisher             = 
| publication-date      = 
| agency                = 
| page                  = 
| pages                 = 
| at                    = 
| nopp                  = 
| 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                   = 
| registration          = 
| subscription          = 
| lay-url               = 
| lay-source            = 
| lay-date              = 
| quote                 = 
| postscript            = 
| ref                   = 
}}

字段参数

title：新闻标题（原文）。唯一必需参数，下列其余参数可选。此参数不应以引号，斜体或其他方式标记格式。
- trans_title：新闻标题的中文翻译。
author: 作者。
- last 和 first：标识作者的姓名，显示为last, first（主要用于外国名字在前，姓氏在后的情况）。
- authorlink ：作者在维基百科中的条目，而不是外部的网址。
url: 如果新闻引用项在互联网上有链接，可以在此输入其外部链接地址，而不应链接至新闻发布者的主页。开头必须带有通讯协议例如http://或https://。
- format: 新闻格式，如PDF。默认为HTML格式。
  如该连接不再提供免费浏览，请注明“收费”。
  
  如该连接到非原发布者提供的全文链接，请注明“再版”。
work: 刊登该新闻的出版物名称，如新闻周刊或人民日报等，也可以是某个专栏或者副刊的名称。请不要使用斜体。
等效参数：journal, newspaper, magazine, periodical, website
publisher: 发表该新闻的公司、机构或组织，例如万华媒体集团或绿色和平组织等。
- location: 新闻来源地，例如香港（南华早报）。
- agency: 新闻通信; 通訊=>zh-my:通信社，例如新华社、路透社、中央社。
id: 以{{ISSN|0028-0836}}之类表明的编号。如果使用此参数，一定要标明编号的类别，而不应只提供一个编号。
date: 出版日，建议使用ISO 8601 YYYY-MM-DD 标准，如“2008-01-01”
page 或 pages: 新闻所在的页数，两者只能使用一个。| page = 30 显示为“p. 30”，| pages = 30-40 显示为“pp. 30-40”。
accessdate: 查阅日期。可使用ISO 8601中规定的YYYY-MM-DD格式，例如"accessdate= 2024-12-31"。
language: 新闻来源的语言，如en、zh-cn等。填入{{en}}会导致错误。
quote: 被引用的相关原文。
archiveurl: 存档的URL地址。
archivedate: 存档日期

举例说明

使用last和first以标明作者，并使用ISSN作为 id 。

{{cite news | first=琼斯 | last=道 | title=新闻标题 | url=http://www.example.org/ | work=世界百科全书 | publisher=新闻集团 | pages= 37–39 | date=2005-11-21 | id={{ISSN|0028-0836}} | accessdate=2005-12-11 }}
→ 道, 琼斯. 新闻标题. 世界百科全书 (新闻集团). 2005-11-21: 37–39 [2005-12-11]. ISSN 0028-0836.

使用author替代last和first。

{{cite news | author=道琼斯 | title=新闻 | url=http://www.example.org/News.pdf | format=PDF | publisher=新闻集团 | pages= 37–39 | date=2005-11-21 | accessdate=2005-12-11 }}
→ 道琼斯. 新闻 (PDF). 新闻集团. 2005-11-21: 37–39 [2005-12-11].

使用authorlink以链接到作者的条目。

{{cite news | first=琼斯 | last=道 | authorlink=道琼斯 | title=新闻 | url=http://www.example.org/background | format=再版 | publisher=新闻集团 | date=2005-11-21 | accessdate=2005-12-11 }}
→ 道, 琼斯. 新闻 (再版). 新闻集团. 2005-11-21 [2005-12-11].

使用format参数。

{{cite news | title=新闻 | url=http://www.example.org/Archive/News | format=收费 | publisher=新闻集团 | date=2005-11-21 | accessdate=2005-12-11 }}
→ 新闻 (收费). 新闻集团. 2005-11-21 [2005-12-11].

使用page参数说明页码。

{{cite news | first=琼斯 | last=道 | title=FooBar | page=1 }}
→ 道, 琼斯. FooBar. : 1.

一个非常简单的引用。

{{cite news | title=FooBar | page=1 }}
→ FooBar. : 1.

使用archiveurl和archivedate参数引用被存档网站存档的网页。

{{cite news | author=Staff writer | title=新闻 | url=http://www.example.org/News.pdf | format=PDF | publisher=新闻集团 | pages= 37–39 | date=2005-11-21 | accessdate=2005-12-11 | archiveurl=http://web.archive.org/web/20070628082911/http://www.example.org/News.pdf | archivedate=2007-06-28 }}
→ Staff writer. 新闻 (PDF). 新闻集团. 2005-11-21: 37–39 [2005-12-11]. （原始内容 (PDF)存档于2007-06-28）.

忽略archivedate参数会造成的错误。

{{cite news | author=Staff writer | title=新闻 | url=http://www.example.org/News.pdf | format=PDF | publisher=新闻集团 | pages= 37–39 | date=2005-11-21 | accessdate=2005-12-11 | archiveurl=http://web.archive.org/web/20070628082911/http://www.example.org/News.pdf }}
→ Staff writer. 新闻 (PDF). 新闻集团. 2005-11-21: 37–39 [2005-12-11]. （原始内容 (PDF)存档于使用|archiveurl=需要含有|archivedate= (帮助)）.

模板数据

这是用于新版可视化编辑器及其他工具的模板数据文档。

Cite news模板数据

本模板是用来列明维基条目中的'''新闻来源'''。描写维基条目时经常需要参考各种新闻类资源，因此更多地使用这个模板可以将所参考的来源记录下来，以便浏览者以及之后的编写者找到这些来源资料。

模板参数
此模板首选参数不换行的行内格式。
参数		描述	类型	状态
网址	`url` `URL`	如果新闻引用项在互联网上有链接，可以在此输入其外部链接地址，而不应链接至新闻发布者的主页。开头必须带有通讯协议例如<nowiki>http://或https://</nowiki>。	字符串	推荐
来源标题	`title`	新闻标题（原文）。'''唯一必需参数'''，其余参数可选。此参数不应以引号，斜体或其他方式标记格式。	字符串	必需
作者	`author` `author` `author1` `authors`	作者的姓名，如名字在前、姓氏在后请使用last及first参数。欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数	字符串	推荐
姓	`last` `last1`	作者的姓氏，不要与author参数同时使用。如欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数	字符串	可选
名	`first` `first1`	作者的名字、中间名或缩写，不要与author参数同时使用。如欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数。	字符串	可选
出版日期	`date`	出版日，建议使用[[ISO 8601]] YYYY-MM-DD 标准，如“2008-01-01”	字符串	推荐
出版物名	`work`	刊登该新闻的出版物名称，如[[新闻周刊]]或[[人民日报]]等，也可以是某个专栏或者副刊的名称。请不要使用斜体。	字符串	推荐
出版社	`publisher`	发表该新闻的公司、机构或组织，例如[[万华媒体集团]]或[[绿色和平组织]]等。	页面名称	推荐
作者条目名	`authorlink` `author-link` `author1-link` `authorlink1`	作者在维基百科中已存在之条目名称，而不是外部的网址。	页面名称	可选
第二作者	`author2`	第二个作者的姓名，如名字在前、姓氏在后请使用last2及first2参数。欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数。	字符串	可选
姓	`last2`	第二个作者的姓氏，不要与author2参数同时使用。如欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数。	字符串	可选
名	`first2`	第二个作者的姓氏、中间名或缩写，不要与author2参数同时使用。如欲链接至作者条目，勿直接使用内部链接，请填入“作者条目名”参数。	字符串	可选
作者条目名	`authorlink2` `author2-link`	作者在维基百科中已存在之条目名称，而不是外部的网址。（最多可列出九位作者，第3至9为作者的参数字; 數位=>zh-my:数字于此列表最下方。）	页面名称	可选
报纸	`newspaper`	报纸的名称；将在标题后显示。	字符串	可选
Via	`via`	数字版的提供者（通常是数据库）；请勿在出版社与提供者相同时使用	字符串	可选
网址链接日期	`accessdate`	引用时链接原始网址的日期；请勿加入维基百科内部链接	字符串	推荐
其他	`others`	列出来源的其他贡献者，例如“照片由王小明摄影”，或“由张小芳翻译”。	字符串	可选
出版月份	`month`	出版的月份；请勿加入维基百科内部链接。如果有出版的日期数据，请改用“日期”参数。	字符串	可选
出版年份	`year`	出版的年份；请勿加入维基百科内部链接。如果有出版的月份和日期数据，请改用“日期”参数。	字符串	可选
原始出版年份	`origyear`	来源原始的出版年份。	字符串	可选
编辑姓	`editor-last`	编辑的姓氏；勿使用内部链接语法，请改用“编辑条目名”参数；此参数又名“editor1-last”、“editor”和“editors”	未知	可选
编辑名	`editor-first`	编辑的名字；勿使用内部链接语法，请改用“编辑条目名”参数；此参数又名“editor1-first”	未知	可选
编辑条目名	`editor-link`	编辑在维基百科中已存在之条目名称，此参数又名“editor1-link”	页面名称	可选
期	`issue`	当出版物为期刊时，请标明期数	字符串	可选
部	`department`	期刊的部数	字符串	可选
出版地	`location`	出版物的地理位置；通常不使用内部链接语法；当出版物名称已包含地名时（例如：旧金山日报），请不要使用本参数；本参数又名“place”	字符串	可选
出版位置	`publication-place`	在标题后显示的出版位置；若同时填入“place”或“location”参数时，将会在标题前显示，并在地名前加上“撰写于”	字符串	可选
出版日期	`publication-date`	当出版日期与撰文日期不同时，请在此填入出版日期；请勿加入内部链接	字符串	可选
通信; 通訊=>zh-my:通信社	`agency`	当内容由新闻通信; 通訊=>zh-my:通信社提供时，请在此填入通信; 通訊=>zh-my:通信社名称（例如：路透社、美联社、法新社等）	字符串	可选
版	`edition`	当出版物有一个以上的版本时，请填入此参数；例如：第2版、于2015-01-08修正	字符串	可选
集/卷	`volume`	当出版物分为多集或多卷发行时，请填入此参数	字符串	可选
页	`page`	引用内容在来源中的页数；将在“p.”后显示；只需填入数字即可	字符串	可选
页码	`pages`	当来源所在页数超过1页时，引用内容在来源中的页数；将在“pp.”后显示；只需填入数字即可（例如：10-14）	字符串	可选
多页页码	`nopp`	此参数可控制是否在“页码”或“多页页码”参数中填入的值前显示“p.”或“pp.”，可在适当时使用（例如：封面）	字符串	可选
于	`at`	当页码参数不适用时可在此填入来源的所在	字符串	可选
语言	`language`	新闻来源的语言，如en、zh-cn等。填入<nowiki>{{en}}</nowiki>会导致错误。	字符串	推荐
非拉丁字母标题	`script-title`	For titles in languages that do not use a Latin-based alphabet (Arabic, Chinese, Hebrew, Japanese, etc). Prefix with two-character ISO639-1 language code followed by a colon. For Japanese use: \|script-title=ja:...	字符串	可选
译标题	`trans-title`	外语来源的中文标题；请另填入'language'参数	字符串	可选
类型	`type`	Additional information about the media type of the source; format in sentence case	字符串	可选
格式	`format`	被引用的著作的'url'参数的文档文件格式；例子：PDF，DOC，XLS；不要指定为HTML	字符串	推荐
arXiv标识符	`arxiv`	An identifier for arXive electronic preprints of scientific papers	字符串	可选
AZIN	`asin`	十个字符的亚马逊标准识别号	字符串	可选
AZIN TLD	`asin-tld`	ASIN top-level domain for Amazon sites other than the US	字符串	可选
Bibcode	`bibcode`	Bibliographic Reference Code (REFCODE); 19 characters	字符串	可选
DOI	`doi`	[[数字; 數位=>zh-my:数字对象标识符]]；以'10.'开始	字符串	可选
DOI失效日期	`doi-broken-date`	数字; 數位=>zh-my:数字对象标识符的失效日期	字符串	可选
ISBN	`isbn`	国际标准书号；请尽量使用13个字符的书号	字符串	可选
ISSN	`issn`	8个字符的国际标准连续出版物号，可分为以连字号分隔的两组四个字符	字符串	可选
jfm代码	`jfm`	Jahrbuch über die Fortschritte der Mathematik classification code	字符串	可选
JSTOR	`jstor`	JSTOR识别号	字符串	可选
LCCN	`lccn`	Library of Congress Control Number	字符串	可选
MR	`mr`	Mathematical Reviews identifier	字符串	可选
OCLC	`oclc`	Online Computer Library Center number	字符串	可选
OL	`ol`	Open Library identifier	字符串	可选
OSTI	`osti`	Office of Scientific and Technical Information identifier	字符串	可选
PMC	`pmc`	PubMed Center article number	字符串	可选
PMID	`pmid`	PubMed Unique Identifier	字符串	可选
RFC	`rfc`	Request for Comments number	字符串	可选
SSRN	`ssrn`	Social Science Research Network	字符串	可选
Zbl	`zbl`	Zentralblatt MATH journal identifier	字符串	可选
id	`id`	A unique identifier used where none of the specialized ones are applicable	字符串	可选
存档网址	`archiveurl`	存档的网址。	字符串	可选
存挡日期	`archivedate`	存档日期。	字符串	可选
失效网址	`dead-url` `deadurl`	如果存档网址已经失去链接效果，请填yes；反之如果存档网址还有链接效果，请填no。配合“存档网址”、“存档日期”参数使用。默认值 no 示例值 yes	字符串	可选
引用原文	`quote`	被引用的相关原文。	字符串	可选
Ref	`ref`	An anchor identifier; can be made the target of wikilinks to full references; special value 'harv' generates an anchor suitable for the harv template	字符串	可选
Separator	`separator`	The punctuation used to separate lists of authors, editors, etc.; a space must be encoded as do not use an asterisk, colon, or hash mark 默认值 .	字符串	可选
Postscript	`postscript`	The closing punctuation for the citation; ignored if 'quote' is defined 默认值 .	字符串	可选
Lay URL	`layurl`	URL link to a non-technical summary or review of the source; alias of 'laysummary'	字符串	可选
Lay source	`laysource`	Name of the source of the laysummary; displays in italics, preceded by an en dash	字符串	可选
Lay date	`laydate`	Date of the summary; displays in parentheses	字符串	可选
Last name	`last3` `author3`	The surname of the third author; don't wikilink, use 'authorlink3'.	未知	可选
First name	`first3`	Given or first name, middle names, or initials of the third author; don't wikilink.	未知	可选
Author link	`authorlink3` `author3-link`	Title of existing Wikipedia article about the third author.	页面名称	可选
Last name	`last4` `author4`	The surname of the fourth author; don't wikilink, use 'authorlink4'.	未知	可选
First name	`first4`	Given or first name, middle names, or initials of the fourth author; don't wikilink.	未知	可选
Author link	`authorlink4` `author4-link`	Title of existing Wikipedia article about the fourth author.	页面名称	可选
Last name	`last5` `author5`	The surname of the fifth author; don't wikilink, use 'authorlink5'.	未知	可选
First name	`first5`	Given or first name, middle names, or initials of the fifth author; don't wikilink.	未知	可选
Author link	`authorlink5` `author5-link`	Title of existing Wikipedia article about the sixth author.	页面名称	可选
Last name	`last6` `author6`	The surname of the sixth author; don't wikilink, use 'authorlink6'.	未知	可选
First name	`first6` `author6-link`	Given or first name, middle names, or initials of the sixth author; don't wikilink.	未知	可选
Author link	`authorlink6`	Title of existing Wikipedia article about the sixth author.	页面名称	可选
Last name	`last7` `author7`	The surname of the seventh author; don't wikilink, use 'authorlink7'.	未知	可选
First name	`first7`	Given or first name, middle names, or initials of the seventh author; don't wikilink.	未知	可选
Author link	`authorlink7` `author7-link`	Title of existing Wikipedia article about the seventh author.	页面名称	可选
Last name	`last8` `author8`	The surname of the eighth author; don't wikilink, use 'authorlink8'.	未知	可选
First name	`first8`	Given or first name, middle names, or initials of the eighth author; don't wikilink.	未知	可选
Author link	`authorlink8` `author8-link`	Title of existing Wikipedia article about the eighth author.	页面名称	可选
Last name	`last9` `author9`	The surname of the ninth author; don't wikilink, use 'authorlink9'. If nine authors are defined, then only eight will show and 'et al.' will show in place of the last author.	未知	可选
First name	`first9`	Given or first name, middle names, or initials of the ninth author; don't wikilink.	未知	可选
Author link	`authorlink9` `author9-link`	Title of existing Wikipedia article about the ninth author.	页面名称	可选
Author mask	`author-mask`	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	字符串	可选
Author name separator	`author-name-separator`	Changes the separator between last and first names; defaults to a comma and space; a space must be encoded as do not use an asterisk, colon, or hash mark 默认值 ,	字符串	可选
Author separator	`author-separator`	Changes the separator between authors; defaults to a semicolon and space; a space must be encoded as do not use an asterisk, colon, or hash mark 默认值 ;	字符串	可选
Display authors	`display-authors` `displayauthors`	number of authors to display before 'et al.' is used; default is to do so after 8 of 9 are listed; alias of 'displayauthors' 默认值 8	数字	可选
Last author ampersand	`lastauthoramp`	When set to any value, changes the separator between the last two names of the author list to 'space ampersand space'	字符串	可选

参见

Wikipedia:列明来源：格式指引
Wikipedia:模板消息/条目来源：相关模板
{{Cite web}}：引用来源为网页时
{{Cite book}}：引用来源为书籍时
{{Cite journal en}}：引用来源为英文期刊时
{{Cite journal zh}}：引用来源为中文期刊时

Template:Citation Style 1