模板:Cite web/doc

此页面是Template:Cite web的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

此模板文档被引用于544,000+个页面。
为了避免造成大规模的影响，所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。
测试后无误的版本可以一次性地加入此模板文档中，但是修改前请务必于讨论页发起讨论。

模板引用数量会自动更新。

本模板使用 Lua 语言：

Module:Citation/CS1

模板简介

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

本模板是用来列明维基条目中非新闻来源（参见列明来源的关于维基条目列明的一般注意事项，并参见{{Cite news}}以学习如何列明新闻来源）。
此模板用来取代过时的{{Web reference}}。它的参数仅允许小写。

模板用法

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

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

复制以下其中一个空白的版本来使用。所有参数名称必须使用小写。每个参数之间使用“|”（管道）字符分隔。删除未使用的参数，以避免在编辑窗口出现。某些示例可能包括当前日期。如果不是当前的日期，然后清洗页面。

横式排列的最常用参数
有作者的参考 `{{cite web \|url= \|title= \|last= \|first= \|date= \|website= \|publisher= \|access-date= \|quote=}}` 没有作者的参考 `{{cite web \|url= \|title= \|author=<!--Staff writer(s); no by-line.--> \|date= \|website= \|publisher= \|access-date= \|quote=}}`

直式排列的最常用参数

{{cite web
 | url =
 | title =
 | author=
 | last =
 | first =
 | date =
 | website =
 | publisher =
 | access-date =
 | quote = }}

横式排列的全部参数
{{cite web \|url= \|title= \|last= \|first= \|author= \|author-link= \|last2= \|first2= \|author2= \|author-link2= \|date= \|year= \|editor-last= \|editor-first= \|editor= \|editor-link= \|editor2-last= \|editor2-first= \|editor2-link= \|editors= \|department= \|website= \|series= \|publisher= \|location= \|page= \|pages= \|at= \|language= \|script-title= \|trans-title= \|type= \|format= \|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= \|dead-url= \|access-date= \|quote= \|ref= \|postscript= \|subscription= \|registration=}}

直式排列的全部参数

{{cite web
 | url =
 | title =
 | last =
 | first =
 | author=
 | author-link =
 | last2 =
 | first2 =
 | author2= 
 | author-link2 =
 | date =
 | year =
 | editor-last =
 | editor-first =
 | editor-link =
 | editor2-last =
 | editor2-first =
 | editor2-link =
 | department =
 | website =
 | series =
 | publisher =
 | via =
 | location =
 | page =
 | pages =
 | at =
 | language =
 | script-title =
 | trans-title =
 | type =
 | format =
 | 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 =
 | dead-url =
 | access-date =
 | quote =
 | ref =
 | postscript =
 | subscription =
 | registration = }}

必填参数（否则会报错）

title: 引用项的标题（原文）。
- script-title：外语文献（特别是可能错误简繁转换的日文）建议使用该参数代替，开头需用ja:等形式标示语言。
url: 引用项的网址。开头必须带有通讯协议例如http://或https://。

选填参数

accessdate: 查阅日期。可使用ISO 8601中规定的YYYY-MM-DD格式，例如"accessdate= 2024-12-22"。
trans_title：标题的中文翻译
author: 作者的名字
- last 与 first 参数一起使用产生效果如姓, 名. （主要用于外国人名名字在前，姓氏在后的情况）。
- authorlink参数与author一同使用，如果是与last参数和first参数一同使用则在两个作者之间加上|。这个参数的作用是链接到相应的维基条目，而不是链到外部链接。
date: 原文出版或发表的日期，请使用包括年、月、日的完整日期格式并与所写条目风格保持一致。如果是与使用ISO 8601中规定的YYYY-MM-DD格式时，例如是2006-02-17，~~则不需要在输入日期时加上维基链接，它会自动被系统加上~~（根据2014年WP:格式手册的新规定，不再对日期添加链接，原有的“[[2015年]][[10月21日]]”等内文链接也逐步被User:Yinweichen-bot等人移除）。
- 或者使用另一种组合: year: 出版年份和month: 出版月份。如果你有详细的日子，请使用date参数。~~这种方式也不需要加上维基链接，它会自动被系统加上~~（根据2014年WP:格式手册的新规定，不再对日期添加链接）。
language: 引用项使用的语言(为中文时作为缺省情况可以不用提示)。
format: 文件格式，例如PDF文件。此项为空则被缺省认为是HTML格式。
work: 如果这个引用项是包括在一个更大“作品”之中，例如是一本书、一份期刊杂志或是一个网站，那么请写下这个"作品"的名字。
pages: 5–7: 引用项所在的页数或者是所在的起始页和终止页，而不是在此写明所引用书籍的总页数。此项在引用项为PDF文件时特别有用。
publisher: 如果存在出版者--例如这个网站是由某个政府服务部门、教育机构或公司来提供运作，则可以在此输入。
via: 非出版者--例如社群或信息网站是由某个人、部门机构或公司发布消息，则可以在此输入。
doi: 有关文档的数位对象识别号，例如10.1038/news070508-7
- Doilabel: 如果此DOI包括一些必须要进行URL编码的字符，请使用"Doilabel}}"参数表明为进行URL编码的版本。参见{{doi}}: "id"等同于"doi"而"label"等同于"doilabel"
archiveurl: 重要的网页可以被类似WebCite这样的网站存档，这时候这个参数应该是这个存档副本的网页网址（需要同时使用archivedate参数）。
archivedate: 此文档存档的日期（需要同时使用archiveurl参数），请使用ISO 8601YYYY-MM-DD格式，例如2006-02-17。~~不需要在输入日期时加上维基链接，它会自动被系统加上。这个参数不支持（美国/国际）日期格式的日期格式（它们会被显示成错误的红色链接格式）~~（根据2014年WP:格式手册的新规定，不再对日期添加链接）。
dead-url: 标记源链接是否为失效链接。填yes表示失效链接，此时会以存档链接为显示主体；填no表示未失效链接，此时存档仅为备份作用，并以未失效的源链接为显示主体。（需要同时使用archiveurl和archivedate参数）
quote: 被引用的相关原文。
website: 被引用的相关网站，可以用内链。

举例说明

一些常见用法

{{Cite web |author=Doe, John |title=My favorite things part II |publisher=Open Publishing |date=2005-04-30 |work=Encyclopedia of things |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ Doe, John. My favorite things part II. Encyclopedia of things. Open Publishing. 2005-04-30 [2005-07-06].

{{Cite web |author=Doe, John |title=My favorite things part II |date=2005-04-30 |work=Encyclopedia of things |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ Doe, John. My favorite things part II. Encyclopedia of things. 2005-04-30 [2005-07-06].

{{Cite web |author=Doe, John |title=My favorite things part II |date=2005-04-30 |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ Doe, John. My favorite things part II. 2005-04-30 [2005-07-06].

{{Cite web |author=Doe, John |title=My favorite things part II |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ Doe, John. My favorite things part II. [2005-07-06].

{{Cite web |title=My favorite things part II |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ My favorite things part II. [2005-07-06].

{{Cite web |url=http://www.nfl.com/fans/ |title=Digest of rules |publisher= National Football League |accessdate=2005-07-06 }}
→ Digest of rules. National Football League. [2005-07-06].

使用format参数

{{Cite web |title=List of psychotropic substances under international control |publisher=International Narcotics Control Board |url=http://www.incb.org/pdf/e/list/green.pdf |format=PDF |accessdate=2005-07-06 }}
→ List of psychotropic substances under international control (PDF). International Narcotics Control Board. [2005-07-06].

使用language参数

{{Cite web |author=Joliet, François |title=Honnit soit qui mal y pense |date=2005-04-30 |url=http://www.example.org/ |accessdate=2005-07-06 |language= Fr,zh,ja }}
→ Joliet, François. Honnit soit qui mal y pense. 2005-04-30 [2005-07-06] （法语、中文及日语）.

使用authorlink参数

{{Cite web |url= http://www.ceo.gov.hk/chi/press/oped.htm |title= 「大市場小政府」── 我們恪守的經濟原則 |accessdate= 2008-08-08 |author= 曾蔭權 |authorlink= 曾蔭權 |date= 2006-9-18 |work= 香港特別行政區行政長官網頁 |publisher= 香港特別行政區政府新聞處 |language= zh-hant |quote= 對於私營界別可以自己做的事，政府不應對市場作任何干預 }}
→ 曾荫权. 「大市場小政府」── 我們恪守的經濟原則. 香港特别行政区行政长官网页. 香港特别行政区政府新闻处. 2006-09-18 [2008-08-08] （中文（繁体））. 对于私营界别可以自己做的事，政府不应对市场作任何干预

不使用author参数

{{Cite web |title=My favorite things part II |publisher=Open Publishing |date=2005-04-30 |work=Encyclopedia of things |url=http://www.example.org/ | accessdate=2006-05-16 }}
→ My favorite things part II. Encyclopedia of things. Open Publishing. 2005-04-30 [2006-05-16].

不使用author和publisher参数

{{Cite web |title=My favorite things part II |date=2005-04-30 |work=Encyclopedia of things |url=http://www.example.org/ |accessdate=2005-07-06 }}
→ My favorite things part II. Encyclopedia of things. 2005-04-30 [2005-07-06].

{{Cite web |title=My favorite things part II |date=2005-04-30 |url=http://www.example.org/ |accessdate=2005-07-06}}
→ My favorite things part II. 2005-04-30 [2005-07-06].

{{Cite web |title=List of psychotropic substances under international control |date=2005-04-30 |url=http://www.incb.org/pdf/e/list/green.pdf |format=PDF |accessdate=2005-07-06 |language= el }}
→ List of psychotropic substances under international control (PDF). 2005-04-30 [2005-07-06] （希腊语）.

为已被类似WebCite这样的网站存档的网页使用参数archiveurl和archivedate

{{Cite web |title=List of psychotropic substances under international control |date=2005-04-30 |url=http://www.incb.org/pdf/e/list/green.pdf |format=PDF |accessdate=2005-07-06 |archiveurl=http://www.archive.org/2005-09-11/www.incb.org/pdf/e/list/green.pdf |archivedate=2005-09-11 }}
→ List of psychotropic substances under international control (PDF). 2005-04-30 [2005-07-06]. （原始内容 (PDF)存档于2005-09-11）.

{{Cite web |url=http://joanjettbadrep.com/cgi-bin/fullStory.cgi?archive=currnews&story=20060405-01shore.htm |title=Interview with Maggie Downs |date=2006-03-31 |publisher=The Desert Sun |archiveurl=http://72.14.207.104/search?q=cache:JAxf4v-pQmgJ:joanjettbadrep.com/cgi-bin/fullStory.cgi%3Farchive%3Dcurrnews%26story%3D20060405-01shore.htm |archivedate=2006-04-26 }}
→ Interview with Maggie Downs. The Desert Sun. 2006-03-31. （原始内容存档于2006-04-26）.

使用quote参数

{{Cite web |title=My favorite things part II |work=Encyclopedia of things |url=http://www.example.org/ |accessdate=2005-07-06 |quote=Lorem ipsum dolor. }}
→ My favorite things part II. Encyclopedia of things. [2005-07-06]. Lorem ipsum dolor.

因title参数忘记填写而导致的错误

{{Cite web |work=Encyclopedia of things |url=http://www.example.org/ |accessdate=2005-07-06 |quote=Lorem ipsum dolor. }}
→ Encyclopedia of things http://www.example.org/. [2005-07-06]. Lorem ipsum dolor. 缺少或|title=为空 (帮助)

注意事项

某些外文标点符号（“　”　‘　’）在“繁体”模式时会错误转换为引号，例如：

{{Cite web |url=https://zh.wikipedia.org |title=“Title text”}} 显示为：

“Title text”.

使用script-title参数可强制该等标点不转换：

{{Cite web |url=https://zh.wikipedia.org |script-title=en:“Title text”}}显示为

“Title text”.

虽然使用<nowiki>“Title text”</nowiki>也可强制不转换，但是会出现“存在delete character”红字错误讯息（2016年情况），例如：

“Title text”.

如在location和quote参数填入的文字有该等标点，使用-{... }-即可强制该等标点不转换。

如果网页标题含有以下字符，请在填写title参数时依下表替换。

网页标题原有字符	替换为
\|	\|
以下为以往引致错误的字符，已于2016年修复问题，可直接于title填“\|title=[文字...] 文字...”，继续依下表转换亦可
<	<
[	[
]	]

测试：{{Cite web |url=https://zh.wikipedia.org |title=一<二[三]四 | 五 }}，显示为：一<二[三]四. 已忽略文本“ 五 ” (帮助)

加入language=en（或ja、es之类）关闭转换的方法于2015年12月以后失效。

模板数据

这是一个用于新版可视化编辑器的模板数据文档。

Cite web

用来列明维基条目中来自网站的来源。新闻、图书、期刊等不适用这个模板

模板参数
参数		描述	类型	状态
网址	`url`	网站页面的网址。开头必须带有通信协议例如http://或https://。	字符串	必需
标题	`title`	网站页面的标题。	字符串	必需
访问日期	`accessdate`	可使用ISO 8601中规定的YYYY-MM-DD格式，例如accessdate= 2013-07-26。	日期	推荐
作者	`author`	作者的名字。	字符串	推荐
发表日期	`date`	原文出版或发表的日期，请使用包括年、月、日的完整日期格式并与所写条目风格保持一致。不能与year或month参数同时使用。建议使用ISO 8601中规定的YYYY-MM-DD格式，例如date= 2013-07-26。	日期	推荐
姓	`last`	作者的姓。不要与author参数同时使用	字符串	可选
名	`first`	作者的名字。不要与author参数同时使用	字符串	可选
作者条目	`authorlink`	链接至作者的维基百科条目。	页面名称	可选
共同作者	`coauthors`	另外的共同作者。	字符串	可选
发表年份	`year`	发表年份。不能与date参数同时使用。	数字	可选
发表月份	`month`	发表月份。不能与date参数同时使用。	数字	可选
文件格式	`format`	文件格式，例如PDF文件。此项为空则被缺省认为是HTML格式。	字符串	可选
作品	`work`	如果这个引用项是包括在一个更大“作品”之中，例如是一本书、一份期刊杂志或是一个网站，那么请写下这个“作品”的名字。	字符串	可选
出版者	`publisher`	如果存在出版者，例如这个网站是由某个政府服务部门、教育机构或公司来提供运作，则可以在此输入名字。	字符串	推荐
新闻机构	`Agency`	所提供的内容的新闻机构（线服务）;例子：美联社，路透社，法新社。如果相关可wikilinked。	字符串	可选
页数	`pages`	引用项所在的页数或者是所在的起始页和终止页，而不是在此写明所引用书籍的总页数。此项在引用项为PDF文件时特别有用。	字符串	可选
语言	`language`	引用项使用的语言（为中文时作为缺省情况可以不用提示）。	字符串	可选
DOI	`doi`	有关文档的数字对象识别号（DOI）。	字符串	可选
存档网址	`archiveurl`	重要的网页可以被类似WebCite这样的网站存档，这时候这个参数应该是这个存档副本的网页网址（需要同时使用archivedate参数）。	字符串	可选
存档日期	`archivedate`	此文档存档的日期（需要同时使用archiveurl参数），请使用ISO 8601YYYY-MM-DD格式，例如2006-02-17。不需要在输入日期时加上维基链接，它会自动被系统加上。	日期	可选
引文	`quote`	被引用的相关原文。	字符串	可选

参见

Wikipedia:列明来源：格式指引
Wikipedia:模板消息/条目来源：相关模板
Template:Cite_news：引用来源为新闻时
Template:Cite_book：引用来源为书籍时
Template:Cite_journal：引用来源为期刊时
Help:引文格式1错误：因为填写参数有问题而产生红字提示的解答指南
Template:Citation Style documentation/deprecated：如果在Cite web模板内使用某些“旧”参数，条目会被自动加入“Category:含有过时参数的引用的页面”，改用建议的参数名称后就不会被加入该分类。