模板:Citation Style documentation

File:Test Template Info-Icon - Version (2).svg 模板文档[查看] [编辑] [历史] [清除缓存]

使用方法

本模板用于为引文格式1系列模板构建格式统一的文档页面。

例如：{{Citation Style documentation|author}}将显示作者参数的文档说明。

若某部分文档内容不适用于特定模板，可直接手动添加文本或创建新的子模板。

各模块文本均为子模板，可通过对应链接进行编辑。

章节使用规范

创建模板文档时，请按以下顺序组织章节内容：

• 引言：简要说明模板用途
• 使用方法：供复制的空白参数示例
• 示例：各类使用场景示例
• 参数说明：各参数的详细描述
  • 语法：模板语法概述
  • 已弃用参数：列出不再支持的参数
  • 参数描述：按功能分组描述参数，建议顺序如下：
    • 作者
    • 标题
    • 日期
    • 出版者
    • 版本、丛书、卷号
    • 文献内定位
    • 网址
    • 锚点
    • 标识符
    • 引文
    • 编者
    • 显示选项

引言章节

使用{{csdoc|lead|内容}}创建标准化的引言内容：

本引文格式1模板用于为创建引文。

本字段的选项： 匿名参数1用于生成结尾文本。

代码	效果
{{csdoc|lead|书籍}}	本引文格式1模板用于为书籍创建引文。

Lua提示

使用方法章节

使用方法部分以{{csdoc|usage}}开头：

复制以下其中一个空白版本来使用。几乎所有参数名称仅支持小写形式（部分缩写如|isbn=有对应的大写别名如|ISBN=，则这些大写形式也可使用）。参数之间使用“|”（管道）字符分隔。未使用的参数可以删除，以避免原始码杂乱。本文档中的部分示例可能包含当前日期；若日期显示不准确，请刷新页面。

可供复制的参数包含在子模板创建的表格中。

横式排列的全部参数

• 以{{csdoc|usage full}}开头
• 将示例包裹在<syntaxhighlight lang="wikitext" copy="1">...</syntaxhighlight>标签中
• 以{{end}}结束

{{csdoc|usage full}}
<syntaxhighlight lang="wikitext" copy="1">{{cite web |last1= |first1= |author-link1= |last2= |first2= |author-link2= |display-authors= |author-mask1= |author-mask2= |collaboration= |df= |date= |year= |orig-date= |orig-year= |location= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |display-editors= |editor-mask1= |editor-mask2= |title= |script-title= |title-link= |url= |url-access= |trans-title= |format= |department= |website= |script-website= |trans-website= |type= |series= |language= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |display-interviewers= |interviewer-mask1= |interviewer-mask2= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |display-translators= |translator-mask1= |translator-mask2= |others= |name-list-style= |edition= |publication-place= |publisher= |publication-date= |agency= |minutes= |time-caption= |time= |page= |pages= |at= |no-pp= |arxiv= |asin= |asin-tld= |bibcode= |bibcode-access= |biorxiv= |citeseerx= |doi= |doi-access= |doi-broken-date= |eissn= |hdl= |hdl-access= |isbn= |ismn= |issn= |jfm= |jstor= |jstor-access= |lccn= |medrxiv= |mr= |oclc= |ol= |ol-access= |osti= |osti-access= |pmc= |pmc-embargo-date= |pmid= |rfc= |sbn= |ssrn= |s2cid= |s2cid-access= |zbl= |id= |url-status= |archive-url= |archive-format= |archive-date= |access-date= |via= |quote-page= |quote-pages= |quote= |script-quote= |trans-quote= |mode= |ref= |postscript=}}</syntaxhighlight>
{{end}}

横式排列的全部参数

{{cite web |last1= |first1= |author-link1= |last2= |first2= |author-link2= |display-authors= |author-mask1= |author-mask2= |collaboration= |df= |date= |year= |orig-date= |orig-year= |location= |editor-last1= |editor-first1= |editor-link1= |editor-last2= |editor-first2= |editor-link2= |display-editors= |editor-mask1= |editor-mask2= |title= |script-title= |title-link= |url= |url-access= |trans-title= |format= |department= |website= |script-website= |trans-website= |type= |series= |language= |interviewer-last1= |interviewer-first1= |interviewer-link1= |interviewer-last2= |interviewer-first2= |interviewer-link2= |display-interviewers= |interviewer-mask1= |interviewer-mask2= |translator-last1= |translator-first1= |translator-link1= |translator-last2= |translator-first2= |translator-link2= |display-translators= |translator-mask1= |translator-mask2= |others= |name-list-style= |edition= |publication-place= |publisher= |publication-date= |agency= |minutes= |time-caption= |time= |page= |pages= |at= |no-pp= |arxiv= |asin= |asin-tld= |bibcode= |bibcode-access= |biorxiv= |citeseerx= |doi= |doi-access= |doi-broken-date= |eissn= |hdl= |hdl-access= |isbn= |ismn= |issn= |jfm= |jstor= |jstor-access= |lccn= |medrxiv= |mr= |oclc= |ol= |ol-access= |osti= |osti-access= |pmc= |pmc-embargo-date= |pmid= |rfc= |sbn= |ssrn= |s2cid= |s2cid-access= |zbl= |id= |url-status= |archive-url= |archive-format= |archive-date= |access-date= |via= |quote-page= |quote-pages= |quote= |script-quote= |trans-quote= |mode= |ref= |postscript=}}

上述参数是按上下文逻辑而非字母顺序排列的。以下参数虽然通常至少在某些引用模板中可用，但未包含在上述完整参数集中：authors；book-title；class；degree；docket；encyclopedia；mailing-list；message-id；number；publication-date；section；sheet；sheets；title-link；s2cid。

横式排列的最常用参数

• 以{{csdoc|usage common}}开头
• 将示例包裹在<syntaxhighlight lang="wikitext" copy="1">...</syntaxhighlight>标签中
• 以{{end}}结束

{{csdoc|usage common}}
<syntaxhighlight lang="wikitext" copy="1">{{cite web |last= |first= |date= |title= |url= |website= |location= |publisher= |access-date=}}</syntaxhighlight>
{{end}}

横式排列的最常用参数

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

纵式排列的全部参数

完整纵向样式可采用三栏格式（适用于参数数量不多的情况）或四栏格式实现。

三栏式

三栏式完整纵向样式包含“纵向列表”、“前提条件”和“简要说明/注释”三栏。

<!--
* 开始：
-->
{{csdoc|usage vertical}}
<pre style="margin:0px;">
<!--
* 创建“纵式列表”列
* 用以下分隔下一列：
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* 创建“前提条件”列；空行必须包含&nbsp;
* 用以下分隔下一列：
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* 创建“简要说明/注意事项”列；空行必须包含&nbsp;
* 结束：
-->
</pre>
{{csdoc|usage vertical end}}

示例：

{{csdoc|usage vertical}}
<pre style="margin:0px;">
{{cite book
| last                  =
| first                 =
| author-link           =
}}
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
&nbsp;
last
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
&nbsp;
same as last1
same as first1
&nbsp;
&nbsp;
</pre>
{{csdoc|usage vertical end}}

纵式排列的全部参数

纵式列表	前提条件	简要说明/注意事项
{{cite book | last = | first = | author-link = }}	last	same as last1 same as first1

• 若某参数名称列于前提条件栏中，则表示该参数是其左侧参数使用的前提条件。

四栏式

（略）

子模板

使用方法（usage）

复制以下其中一个空白版本来使用。几乎所有参数名称仅支持小写形式（部分缩写如|isbn=有对应的大写别名如|ISBN=，则这些大写形式也可使用）。参数之间使用“|”（管道）字符分隔。未使用的参数可以删除，以避免原始码杂乱。本文档中的部分示例可能包含当前日期；若日期显示不准确，请刷新页面。

全部参数（usage full）

横式排列的全部参数

常用参数（usage common）

横式排列的最常用参数

纵向样式（usage vertical）

纵式排列的全部参数

纵式列表	前提条件	简要说明/注意事项

纵向样式中间栏（usage vertical mid）

| style="vertical-align:top;" | |}

纵向样式结束栏（usage vertical end）

|}

• 若某参数名称列于前提条件栏中，则表示该参数是其左侧参数使用的前提条件。

示例章节

使用{{markup2}}来格式化示例（具体用法参见该模板文档）。

{{markup2 |t=带网址和版本的基本用法
|m={{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}
|r={{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}
}}

带网址和版本的基本用法

• {{cite book |title=Mysterious book |url=https://www.example.com |edition=2nd}}

  Mysterious book 2nd. 

参数说明章节

语法（syntax）

以下参数说明采用如下格式规范：

• 主参数
• 或者：主参数2—可替代主参数使用的参数
  • 子参数—需与主参数配合使用（若未指定主参数则自动忽略）
  • 或者：子参数2—可替代子参数使用的参数（若未指定主参数2则自动忽略）

当参数存在别名时，不可同时使用别名与主参数，必须择一使用。

COinS（coins）

本模板会在输出的HTML中嵌入COinS元数据，供文献管理软件提取书目信息（参见WP:COinS）。因此使用模板时：

• 每个参数仅包含单一数据项，不附加说明文字。例如应使用|date=2007-09-27，而非|date=2007-09-27（纸质版为9月25日）。
• 不建议在引用模板内嵌套其他模板，以防冗余HTML/CSS代码混入元数据。
• 影响元数据的参数中不应使用HTML实体（如 、–或 ）。

以下参数参与生成COinS元数据

注：以下列表显示在所有CS1模板的文档中。并非所有CS1模板都支持全部参数。部分参数互斥，部分互为别名，还有些参数需要其他参数配合使用。本模板支持的完整参数列表、别名及其依赖关系详见本文档顶部附近的使用方法章节。

• 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

句号分隔符（sep_period）

默认使用半角句号（.）分隔引文各部分。

逗号分隔符（sep_comma）

默认使用半角逗号（,）分隔引文各部分。

必填参数（required）

此参数为必填项，若未定义将生成错误提示。条目、帮助和模板命名空间的错误页面会被归入Category:页面引用语法错误分类。如需在文档中展示错误示例，可通过设置|no-tracking=true禁用分类追踪。

已弃用参数（deprecated）

{{#lst:Help:引文格式1错误|deprecated_params_table}}

作者（author）

• author：作者姓名。一般用于中文人名或机构名称；英文人名应使用|first=和|last=分别填写名和姓。多位作者需分别填写，详见下文说明。如需添加内部链接，请使用author-link参数。请勿使用斜体。别名：author1。
  • last：作者的姓氏（一般用于英文人名）；例如：“Smith”。如需添加内部链接，请使用author-link参数。别名：surname、last1、surname1。
  • first：作者的名字（一般用于英文人名）；例如：“John Michael”或“J. M.”。如需添加内部链接，请使用author-link参数。别名：given、first1、given1。必须与last参数配合使用；若last参数为空则不显示名字。
  • 或者：多位作者时使用author1至authorn（中文人名）或last1、first1至lastn、firstn（英文人名），其中n为任意连续数字，支持无限数量的作者（每个firstn需要对应的lastn，但反之不成立）。参见display参数来调整显示作者数量。别名：surname1、given1至surnamen、givenn。
  • author-link：作者的维基百科条目名称，而非作者个人网站；仅填写条目名称即可，无需特殊语法。别名：author-link1、author1-link、authorlink。
  • 或者：多位作者时使用author-link1至author-linkn。别名：author1-link至authorn-link。
  • name-list-style：（罕用）姓名显示格式。设为amp或&时，用“&”连接最后两位作者；设为vanc时，按温哥华格式显示姓名列表（需使用last/first参数填写姓名）。
• vauthors：温哥华格式的作者列表（用逗号分隔）；机构名需用双括号包裹，如：|vauthors=Smythe JB, ((Megabux Corp.)), etal
  • author-link和author-mask可用于|vauthors=中的个人姓名，用法同上
• contributor：（仅限书籍类文献使用）章节作者姓名；英文人名应使用|contributor-first=和|contributor-last=分别填写名和姓。必须与参数contribution搭配使用。如需添加内部链接，请使用contributor-link。具体用法参见author。
• translator：译者姓名。一般用于中文人名或机构名称；英文人名应使用|translator-first=和|translator-last=分别填写名和姓。如需添加内部链接，请使用translator-link。具体用法参见author。
• others：用于标注作者、编辑者、译者之外的其他贡献者（如插画师）。使用此参数时，请同时注明该姓名及其具体职责，例如：“John Smith (绘图)”。
• 注意：使用{{sfn}}或{{harv}}时，请勿在单个字段中包含多个姓名，否则锚点将无法匹配内联链接。

本字段的选项：

• |contributor=yes 显示contributor（章节作者）参数说明（仅限cite book和citation模板使用）
• |others=yes 显示others（其他贡献者）参数说明
• |aliases= 为author参数添加别名

编者（editor）

• editor：编者姓名。一般用于中文人名或机构（如编委会）名称；对于英文人名，优先使用|editor-first=和|editor-last=组合。请仅填写一位编者的姓名，多位编者的写法见下方说明。如需添加内部链接，请使用editor-link参数。别名：editor1。
  • editor-last：编者的姓氏（一般用于英文人名）；例如：“Smith”。如需添加内部链接，请使用editor-link参数。别名：editor-surname、editor1-last、editor-last1。
  • editor-first：编者的名字（一般用于英文人名）；例如：“John Michael”或“J. M.”。如需添加内部链接，请使用editor-link参数。别名：editor-given、editor1-first、editor-first1。必须与editor-last参数配合使用；若editor-last参数为空则不显示名字。
  • 或者：多位编者时使用editor1至editorn（中文人名）或editor-last1、editor-first1至editor-lastn、editor-firstn（英文人名），其中n为任意连续数字（每个editor-firstn需要对应的editor-lastn，但反之不成立）。别名：editor-surname1、editor-given1至editor-surnamen、editor-givenn。
  • editor-link：编者的维基百科条目名称，而非编者个人网站；请勿添加内部链接。别名：editor-link1、editor1-link。
  • 或者：多位编者时使用editor-link1至editor-linkn（别名editorn-link）。
  • name-list-style：接受有限的关键词值：设为amp或&时，在姓名列表最后两个名字间插入“&”符号；设为vanc时，当姓名参数采用last/first格式时，按温哥华格式显示姓名列表。
• veditors：温哥华格式的逗号分隔编者列表；机构名称需用双括号包裹。如适用可添加etal：

  |veditors=Smythe JB, ((Megabux Corp.)), etal

  • editor-linkn和editor-maskn可用于|veditors=中的个人姓名，用法同上
• 显示规则：

  使用display-editors指定显示的编者人数，其余编者以“et al.”形式省略显示。

  若存在作者：先显示作者，接着显示文献名称，然后是编者姓名和“(编)”，收录该文献的作品名称（如期刊名）。

  若无作者：编者显示在文献名称前，并显示“(编)”。

标题（title）

（另见Help:引文格式1 § 标题与章节）

• title：来源标题。可添加内部链接至现有条目或使用url添加外部链接，但二者不可同时使用。
  • script-title：非拉丁文字标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示，如：|script-title=ja:东京タワー。
  • trans-title：外文来源标题的中文翻译。显示在title后的方括号内。建议配合language参数使用。

含特殊字符的标题需经编码才能正确显示和链接：

换行符	[	]	|
空格	[	]	{{!}}（推荐）
	{{bracket|文本}}		| 或 {{pipe}} – 另见Help:表格 § 管道符渲染

• title-link：title所指来源的维基百科条目标题。若需添加外部链接请改用url参数

本字段的选项：

title_title设置“title”参数名的显示：

• encyclopedia = encyclopedia
• 默认值 = title

网页（web）

（另见Help:引文格式1 § 标题与章节、§ 作品载体与出版商）

• title：网站来源页面标题。
  • script-title：非拉丁文字标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示，如：|script-title=ja:东京タワー。
  • trans-title：外文来源标题的中文翻译。显示在title后的方括号内。建议配合language参数使用。

含特殊字符的标题需经编码才能正确显示和链接：

换行符	[	]	|
空格	[	]	|
	{{bracket|文本}}		{{pipe}} - 另见Help:表格 § 管道符本身渲染

此参数为必填项，若未定义将生成错误提示。条目、帮助和模板命名空间的错误页面会被归入Category:页面引用语法错误分类。如需在文档中展示错误示例，可通过设置|no-tracking=true禁用分类追踪。

• website：网站名称（当网站有明确名称时使用，而非域名）；可添加内部链接。别名：work

章节（chapter）

• chapter：来源的章节标题。可添加内部链接或使用chapter-url添加外部链接，但二者不可同时使用。
  • script-chapter：非拉丁文字章节标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示，如：|script-chapter=ja:东京タワー。
  • trans-chapter：外文来源章节标题的中文翻译。显示在chapter字段后的方括号内；若定义了chapter-url，则trans-chapter会包含在链接中。建议配合language参数使用。
• contribution：由author之外其他人撰写的书籍部分。可添加内部链接或使用contribution-url添加外部链接，但二者不可同时使用。贡献内容的作者信息通过contributor参数提供。

本字段的选项：

title_title设置显示标题：

• booktitle = booktitle
• 默认值 = chapter

类型（type）

• type：提供来源类型的附加信息。显示在标题后的括号内。若使用关键字none可禁用类型显示。例如：评论、论文、小册子、录用稿件、CD内页说明、新闻稿等。

本字段的选项：

• type_default：添加“默认值为type_default”的说明。

期刊（journal）

• work（{{cite journal}}和{{cite magazine}}必填）：包含来源文献的出版物名称。可添加内部链接。若出版物当前名称与来源发表时不同，应使用来源发表时的名称。当设置work时，chapter将不显示，并会生成错误提示。别名：journal、newspaper、magazine、periodical、website。
  • script-work：原文出版物名称（非拉丁文字）。必须前缀支持的语言代码以确保浏览器正确显示。拉丁文字出版物（捷克语、法语、土耳其语、越南语等）留空。别名：script-journal、script-newspaper、script-magazine、script-periodical、script-website。
  • trans-work：外文出版物名称的中文翻译。显示在work或script-work后的方括号内。别名：trans-journal、trans-newspaper、trans-magazine、trans-periodical、trans-website。
• issue：连续出版物的期号。若该期有专属标题，可连同期号一并给出，例如|issue=2, 现代加拿大文学。别名：number，根据出版物实际用词选择。若同时存在两种编号（通常一种按年编号，一种绝对编号），可合并标注（如|issue=2 #143）。显示在括号内，跟随volume之后。
• article-number：期刊为每篇文章分配的文章编号；显示在卷号/期号和页码之间。
• department：期刊或杂志中的常设栏目名称。例如“通讯”、“社论”、“读者来信”和“评论”。显示在title之后，以纯文本形式呈现。

本字段的选项：

• |article_num=yes 显示article_num参数的说明。
• |department=yes 显示department参数的说明。

版本（edition）

• edition：当出版物存在多个版本时使用，例如：“第二版”、“修订版”等。若已定义期刊类参数则不显示。

系列（series）

• series或version：当来源属于某个系列（如丛书或卷号重新编排的期刊）时使用。

剧集（series_episode）

• series：所属系列名称（如电视剧系列）。可添加内部链接。
  • series-link：对应维基百科条目名称，用于为series添加内部链接。通过添加跨语言前缀可链接至其他语言版本的维基条目。请勿输入网址。

活动（event）

• event：演讲或报告的活动名称。

通讯社（agency）

• agency：提供内容的通讯社（新闻机构）；如美联社、路透社、法新社。若内容直接发布在通讯社官网（如apnews.com或reuters.com）则不使用此参数，应改用work或publisher。可附对应的内部链接。

卷号（volume）

• volume：多卷本出版物的卷号。显示在title和series之后。纯数字、纯大写罗马数字或少于5个字符时加粗显示，其余情况不加粗。多卷书的分卷书名、卷次、册次等可直接写在title参数中，而不使用volume。极少数出版物同时标注连续卷号和年度卷号时合并标注，如|volume=IV/#10。

日期（date）

• date：引用来源的发布日期。可以是完整日期（年、月、日）或部分日期（年和月、年和季节或仅年份）。完整的年月日应当使用“YYYY-MM-DD”格式（如2026-07-01）。请勿添加内部链接。日期显示在作品载体和出版商之后。

使用简短脚注时，完整引用的锚点通过此参数指定的年份生成。若同一作者在同一年份有多部作品，可在年份后附加小写字母加以区分（如|date=1997b）；如果date参数填写的不是年份，而是完整的“YYYY-MM-DD”日期，此时不能通过添加字母来区分引用，而要同时填写year参数（例如：|date=1997-01-01 |year=1997b，其中“1997-01-01”用于显示，1997b用于创建锚点），或使用ref参数创建自定义锚点。

• year：出版年份。更灵活的|date=参数也可单独处理年份。除非如前文的情况，使用简短脚注时，需要区分同一作者同年的多部作品，否则不要与date参数同时使用。
• orig-year：文献最初发布的日期或年份；显示在date（或year）后的方括号内。为明确“最初发布”的含义，请提供具体说明，例如：|orig-year=首版于1859或|orig-year=创作于1904。

本字段的选项：

• |limited_param_list=yes 隐藏orig-year参数说明，因为该参数在有限参数模板中不允许使用

出版商（publisher）

（另见Help:引文格式1 § 作品载体与出版商）

• publisher：出版商名称。出版商是指出版被引用作品的公司、组织或其他法律实体，因此请勿输入出版物名称（如网站、书籍、百科全书、报纸、杂志、期刊等的名称）。一般省略“有限公司”或“股份有限公司”等公司标识。可添加对应的内部链接，但不要添加出版商网站的外部链接。若出版商当前名称与来源发表时不同，应使用出版物上标注的名称或来源发表时的名称。该参数最常用于书籍类来源（一般指书籍的出版社），较少用于网站或期刊来源（某些情况下可替代work）。出版商与作品载体名称相同或高度相似时，不要使用“publisher”参数（例如《纽约时报》由纽约时报公司出版，无需重复说明）。显示在title之后。
• publication-place：出版地。填写出版商所在地的城市名称（如|publication-place=北京，WP:列明来源中的写法）；城市名称有歧义，或不知名，宜附省/州名或国名。通常不添加内部链接。当出版物名称已包含出版地时可省略（如《波士顿环球报》《印度时报》）。若地名与来源发表时不同，请使用出版物上标注的地名或来源发表时的地名。显示在标题之后。别名：location、place。
  • 目前place、location严格来讲是新闻报道电头中的报道撰写地参数，但为了兼容性考虑，当未定义publication-place时仍将其作为出版地显示。具体规则：若仅定义了publication-place、place或location其中之一，将作为出版地显示在标题后；若同时定义了publication-place和place/location，则place/location作为报道撰写地以“写于”为前缀显示在标题前，而publication-place作为出版地显示在标题后。
• publication-date：出版日期，与作品创作日期不同时。若同时定义了不同的date（或year），则publication-date显示在publisher后的括号内；若未定义date（或year），则publication-date作为date显示。格式同date参数，不要添加内部链接。
• via：内容提供方名称（若不同于publisher）。via不能替代publisher参数，但可提供额外信息。适用于：文章署名其他出版物但无法溯源时（如雅虎新闻）；内容提供方以非原始格式提供内容时；内容提供方无法从URL直接识别时；或内容提供方要求署名时。访问限制显示参见access level参数；原始来源为通讯社时参见agency参数。

新闻组（newsgroup）

• newsgroup：新闻组名称；自动生成外部链接，请勿添加内部链接。

语言（language）

• language：来源使用的语言，请填写ISO 639-1语言代码，例如：|language=ru；可接受逗号分隔的多语言列表，例如：|language=fr, pt-br。请勿使用模板或内部链接。显示在括号内。使用被引文模块识别的语言会将页面归入Category:CS1外文来源相应子分类。别名：in

页码（pages）

• page：来源中包含佐证内容的单页页码。使用|page=或|pages=二者之一，两者显示效果一致，可不作明确区分。显示时前缀为冒号（:）。别名：p。
• 或：pages：来源中包含佐证内容的页码范围。使用|page=或|pages=二者之一。用短横线（-）表示范围，用逗号（,）分隔非连续页码。不可用于表示来源总页数。显示时前缀为冒号（:）。别名：pp。
• 或：at：用于页码不适用或不充分的情况。会被|page=或|pages=覆盖。|page=、|pages=和|at=三者仅能使用其一。
  示例：第几栏、第几段、第几节；第几音轨；时:分:秒；第几幕、第几场；某部分、扉页题词、封底、唱片内页、版权页、书籍末页、护封。

时间（time）

• minutes：来源中事件发生的具体时间；自动后接“记录于”。
• 或：time：来源中事件发生的具体时间；默认前缀“事件发生在”。
  • time-caption：修改time前的默认显示文字。

标识符1（id1）

• id：唯一标识符，在无专用标识符时使用；可添加内部链接或使用外部链接模板。例如|id=NCJ 122967将在引文末尾添加“NCJ 122967”。也可使用模板如|id={{NCJ|122967}}来显示NCJ 122967。

标识符2（id2）

下列标识符会生成外部链接。每个参数仅接受一个标识符值，输入多个值或多余内容将无法正确生成链接。指定标识符参数时，通常只需输入可变部分，例如|rfc=822或|pmc=345678。

• arxiv：arXiv标识符；例如：|arxiv=hep-th/9205027（2007年4月前）或|arxiv=0706.0001（2007年4月—2014年12月）或|arxiv=1501.00001（2015年1月起）。请勿包含“.pdf”或“.html”等无关文件扩展名。别名：ARXIV、eprint。
• asin：亚马逊标准识别号码；若首字符为数字，请使用isbn。由于此链接偏向特定分销商，仅在无标准标识符时使用。例如：|asin=B00005N5PF。别名：ASIN。
  • ASIN-TLD：非美国亚马逊网站的顶级域名。别名：asin-tld。
• bibcode：bibcode；用于多个天文数据系统；例如：1974AJ.....79..819H。别名：BIBCODE。
• biorxiv：bioRxiv标识符，需完整DOI（如10.1101/078733对应http://biorxiv.org/content/early/2016/10/01/078733或https://doi.org/10.1101/078733）。别名：无。
• citeseerx：CiteSeerX标识符，为URL中的数字与点组合（如10.1.1.176.341对应https://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.176.341）。别名：无。
• cn：国内统一刊号。别名：CN。
• doi：数字对象唯一标识符；以10.开头，例如：10.1038/news070508-7。别名：DOI。
  • doi-broken：DOI在https://doi.org失效的日期。格式为“YYYY-MM-DD”。别名：doi-broken-date、doi-inactive-date、doi_brokendate、doi_inactivedate。
• eissn：电子版国际标准期刊号；8位字符，通常用连字符分为两组；例如：|eissn=1557-2986。别名：EISSN。
• hdl：Handle系统数字对象标识符；例如：|hdl=20.1000/100。别名：HDL。
• isbn：国际标准书号；例如：978-0-8126-9593-9。（参见Help:各类书号和国际标准书号 § 概述）连字符可选但建议保留。请使用书籍印刷的ISBN。优先使用13位ISBN（以978或979开头）。若书籍仅印有10位ISBN则使用之。ISBN通常位于版权页（书名页背面）或条形码下方（以978或979开头的条形码）。9位SBN请使用。请勿通过简单添加978前缀将10位ISBN转为13位（末位为校验码，随意更改会导致ISBN无效）。此参数应仅包含ISBN不包含其他字符。系统会校验长度、非法字符（10位ISBN末位可为“X”）及校验码。别名：ISBN、isbn13、ISBN13。
• ismn：国际标准音乐编号；例如：979-0-9016791-7-7。连字符或空格可选。请使用作品印刷的ISMN。此参数应仅包含ISMN不包含其他字符。系统会校验长度、非法字符及校验码。别名：ISMN。
• issn：国际标准期刊号；8位字符，通常用连字符分为两组；例如：|issn=2049-3630。别名：ISSN。
• jfm：数学进展年鉴；值中请勿包含“JFM”；例如：|jfm=53.0144.01。别名：JFM。
• jstor：JSTOR标识符；例如：|jstor=3793107。别名：JSTOR。
• LCCN：美国国会图书馆控制号。字母前缀应为小写且无空格；例如：|lccn=79-57364或|lccn=2004042477或|lccn=e09001178。别名：lccn。
• MR：《数学评论》标识符；例如：|mr=630583。别名：mr。
• OCLC：开放图书馆标识符，用于在WorldCat联合目录检索；例如：|oclc=9355469。别名：oclc。
• ol：开放图书馆标识符；值中请勿包含“OL”；例如：|ol=7030731M。别名：OL。
• OSTI：美国能源部科学和技术信息办公室标识符；例如：|osti=4367507。别名：osti。
• PMC：PubMed Central文章编号；不包含“PMC”，如|pmc=345678。与下方的PMID参数不同。别名：pmc。
  • embargo：PMC开放日期；在此日期之前不会生成链接。别名：无。
• PMID：PubMed唯一标识符；例如：|pmid=17322060与上方的PMC参数不同。别名：pmid。
• RFC：RFC（请求意见稿）编号；例如：|rfc=3143。别名：rfc。
• SSRN：SSRN；例如：|ssrn=1900856。别名：ssrn。
• s2cid：语义学者语料库ID；例如：|s2cid=37220927。别名：S2CID。
• unified：统一书号。别名：csbn、CSBN。
• ZBL：数学文摘期刊标识符；例如：|zbl=0472.53010。对于类似JFM 35.0387.02的zbMATH搜索结果请使用|jfm=35.0387.02。别名：zbl。

部分标识符可通过对应的|参数-access=参数指定访问状态。

无需通过|url=重复填写标识符自动生成的链接地址。此时|url=可用于提供便捷访问链接。

网址（url）

• url：可获取title指定出版物文本的在线地址。若title已添加内部链接则不可使用。如适用，链接可指向具体引用页。需移除URL中的跟踪参数（如#ixzz2rBr3aO94或?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...）。请勿链接至商业售书网站（如亚马逊），而应使用|isbn=或|oclc=提供中立图书检索链接。含空格等无效URL将触发错误提示。
  • access-date：最后验证url链接的内容支持条目内容的日期；必须与url参数同时使用；格式为“YYYY-MM-DD”。对于内容不会发生变动的来源无需使用该参数（例如通过DOI获取的文献或纸质书籍链接）；但对于商业网站的新闻文章应使用该参数（这些内容可能随时变更，即使同时有纸质版本发布）。需注意access-date不仅是验证链接可访问的日期，更是确认网页内容支持所引用条目内容的日期（当前网页内容可能发生变更而不再支持）。别名：accessdate。
  • archive-url：网页存档快照的URL（参见WP:失效链接）。通常指向互联网档案馆（参见WP:使用时光机）或archive.today（参见Help:使用archive.today）等服务；需配合archive-date和url使用。默认优先显示存档链接，原始链接置于末尾（可通过设置|url-status=live优先显示原始链接）。别名：archiveurl。
    • archive-date：存档服务快照日期；默认前缀“原始内容存档于”。格式为“YYYY-MM-DD”。别名：archivedate。
    • url-status：控制|title=的标题文字链接至|url=还是|archive-url=；需同时定义url和archive-url。网址无存档时，使用{{dead link}}标记链接已失效。标注链接是否失效曾使用dead-url参数：yes表示已失效，no表示未失效。

      接受多组关键词：

      • dead—（默认状态）链接至|archive-url=
      • live—链接至|url=；用于预防性存档的链接
      • deviated—链接至|archive-url=；用于原网址仍可访问但不再支撑文中论述（参见WP:列明来源 § 原地更新的来源）
      • unfit或usurped—链接至|archive-url=；用于原网址已被劫持用于垃圾信息、广告或不适合展示时，原网址链接被将隐藏

    • archive-format：archive-url指向文件的格式（如DOC、XLS），用法同format。
  • url-access：详见URL参数访问指示
• format：url指向文件的格式（如DOC、XLS），显示在标题后的括号内。（媒体格式请用type参数。）HTML为默认格式无需指定，PDF会自动检测无需指定。不影响外部链接图标。

URL必须以支持的URI方案开头。所有浏览器均支持http://和https://；而ftp://、gopher://、irc://、ircs://、mailto:和news:可能需要插件或外部应用支持，通常应避免使用。当前不支持IPv6主机名。

若引文模板参数中的URL包含特定字符，将无法正确显示和链接。这些字符需进行百分号编码。例如空格必须替换为%20。编码替换规则如下：

字符	空格	"	'	<	>	[	]	{	|	}
编码	%20	%22	%27	%3C	%3E	%5B	%5D	%7B	%7C	%7D

单引号无需编码，但未编码的多个引号会被解析为斜体/粗体标记。单个右花括号无需编码，但未编码的成对花括号会被解析为模板嵌入的结束符。

本字段的选项：

• media将描述文字中的“出版物文本”替换为“媒体文件”

章节网址（chapterurl）

• chapter-url：可获取chapter或contribution指定文本的在线地址。若这些参数已添加内部链接则不可使用。如已填写url，应与其属于同一站点。使用chapter-url时，仅当著作起始部分与被引章节位于站点不同网页时才需使用url。别名：contribution-url、section-url。
• chapter-format：chapter-url指向文件的格式（如DOC、XLS），显示在chapter后的括号内。HTML为默认格式无需指定，PDF会自动检测无需指定。不影响外部链接图标。

引文（quote）

• quote：从来源引用的相关文本。显示在引号内。需包含终止标点（默认情况下引文会抑制引文终止符句号）。
  • script-quote：非拉丁文字引文（阿拉伯文、西里尔文等）。必须前缀支持的语言代码以确保浏览器正确显示，如：|script-quote=ja:东京タワー。
  • trans-quote（暂不支持）：外文引文的中文翻译。显示在quote之后的方括号内。

本字段的选项：

• |cs2=yes 取消“需包含终止标点（默认情况下引文会抑制引文终止符句号）”的默认提示

通俗摘要（lay）

• laysummary：面向非专业人士对来源的摘要或评论的URL；显示为带有“通俗摘要”标题的外部链接。
  • laysource：通俗摘要的来源名称，可添加内部链接。显示为斜体，在“通俗摘要”之后，通过破折号连接。
  • laydate：通俗摘要的日期。显示在圆括号内。

引用锚点（ref）

• ref：为简短脚注创建锚点。默认不生成锚点。（详见Help:引文格式1 § 锚点）
  • 特殊值|ref=harv会生成兼容{{harv}}、{{sfn}}模板的锚点格式。
  • 设置|ref=ID会生成指定ID的自定义锚点，可使用{{harvid}}模板。

显示选项（display）

• mode：用于指定分隔符和末尾标点的设置。|mode=cs1使用半角句号（.）作为分隔符和末尾标点；|mode=cs2使用半角逗号（,）作为分隔符和末尾标点。分别对应引文样式1和样式2。覆盖默认末尾标点设置请使用postscript参数。
• author-mask：
• contributor-mask：
• editor-mask：
• interviewer-mask：
• subject-mask：
• translator-mask：

  将第一位作者（或编者等）显示的姓名替换为横线或指定文本。设为数字n时显示n em横线（—）；设为文本时直接显示该文本，且其后不带分隔符。特殊值“0”将直接隐藏第一位作者，但此时元数据仍保留真实作者姓名，故不要省略作者参数。此参数主要用于简短脚注的参考文献列表中，同一作者的多部作品连续列出时。不应在{{reflist}}或<references />生成的文献列表中使用（因为文献的显示顺序易发生改变）。如需省略第二位及以后特定作者的姓名，使用|authorn-mask=参数。

• display-authors：
• display-contributors：
• display-editors：
• display-interviewers：
• display-subjects：
• display-translators：

  控制显示的作者（或编者等）数量，默认全部显示；超过显示数量将以“et al.”代替。例如|display-authors=2仅显示前两位作者。特殊值|display-authors=0隐藏所有作者及“et al.”。|display-authors=etal则显示全部作者后追加“et al.”。

• postscript：控制引用末尾的标点。默认为半角句号（.）；设为|postscript=none取消末尾标点（留空效果等同，但语义模糊故不建议）。包含额外文本或多字符标点模板时会生成维护提示。定义quote参数时本参数无效。

本字段的选项：

• cs2：设置时将：
  • postscript默认值改为“无标点”
  • separator默认值改为“逗号(,)”

订阅或注册要求（registration）

维基百科允许引用需要注册或订阅的在线来源。为方便读者和其他编者，建议注明引用的外部链接的获取限制级别。这些级别仅说明获取材料的限制条件，不涉及内容的重用许可或版权状态（因其与可供查证无关）。

可使用四种访问级别：

• 标识符访问指示：
  • 可免费查阅 free：任何人都可免费阅读全文
• URL参数访问指示：
  • 需要免费注册 registration：需免费注册才能查阅（但部分预览/摘要可能无需注册）
  • 有限度免费查阅，超限则需付费订阅 limited：有限度免费查阅，超限则需付费订阅
  • 需要付费订阅 subscription：必须付费订阅才能查阅（“付费墙”）

同一引用的不同链接可能有不同访问级别，需为每个链接单独指定级别。

URL参数访问指示

|url=、|article-url=等URL参数指定的链接默认视为可免费访问。若非免费访问，应通过对应参数指定访问级别以显示提示标识。因默认视为免费访问，故无需标记free。若服务已终止导致无法注册/订阅，则应移除访问级别参数，并添加|archive-url=和|archive-date=存档信息。

URL参数与访问指示

URL参数	访问参数	允许值
|url=	|url-access=	registration 需要免费注册 limited 有限度免费查阅，超限则需付费订阅 subscription 需要付费订阅
|article-url=	|article-url-access=
|chapter-url=	|chapter-url-access=
|contribution-url=	|contribution-url-access=
|entry-url=	|entry-url-access=
|map-url=	|map-url-access=
|section-url=	|section-url-access=

例如需要免费注册的文献应这样标注：

• {{cite web |url=https://example.com/nifty_data.php |url-access=registration |date=2021-04-15 |title=Nifty example data}}

  Nifty example data需要免费注册. 2021-04-15.  含有内容需登录查看的页面 (link)

标识符访问指示

由标识符生成的链接（后文列出的除外）默认假定需要订阅或注册。若实际可免费访问，应通过对应参数指定访问级别。若标识符仅提供摘要服务（无全文），则不可标记为limited、registration或subscription。

命名标识符与访问指示

标识符	访问参数	允许值
|bibcode=	|bibcode-access=	free 可免费查阅
|doi=	|doi-access=
|hdl=	|hdl-access=
|jstor=	|jstor-access=
|ol=	|ol-access=
|osti=	|osti-access=
|ssrn=	|ssrn-access=
|s2cid=	|s2cid-access=

以下标识符始终提供免费访问，系统会自动标注访问级别（无需额外参数）：

• |arxiv=
• |biorxiv=
• |citeseerx=
• |medrxiv=
• |pmc=
• |rfc=

未来将开放的PMC付费内容参见embargo。

地图系列（map_series）

• scale：地图的比例尺数值。
• series：地图所属系列名称。
• cartography：地图制作者，显示为“Cartography by XXX”。

地图页码（map_pages）

• page：来源中包含佐证内容的单页页码；会被at参数覆盖。
• 或：pages：来源中包含佐证内容的页码范围。用短横线（-）表示范围，用逗号（,）分隔非连续页码；不可用于表示来源总页数。
• inset：引用的专题插图名称（如“市中心区”）；显示为“插图名称 inset”；会被at参数覆盖。
• section：引用的地图区域编号（如A6、B9等）；会被at参数覆盖。
• at：当上述参数不足以描述来源位置时使用。

示例：页；插图；节；地图或图集中的其他自定义位置。

受访者（interview_author）

• last：受访者（非采访者）姓氏。请勿添加内部链接——应使用subject-link。对于姓氏前置（如中文）或机构受访者，直接使用last保持与来源相同格式。
  • first：受访者名字（可含头衔），如“Firstname Middlename”或“Firstname M.”或“Firstname M., Sr”；请勿添加内部链接——应改用subject-link参数。
  • 或：多位受访者时使用firstn和lastn组合。

• subject-link：受访者维基百科条目标题——非个人网站；请勿添加内部链接。别名：subject-link、author-link、author-linkn；subject-linkn、authorn-link
• 或：多位受访者时使用subject-linkn。

别名：subject、last、lastn、authorn、author、subjectn。

采访者（interview_interviewer）

• interviewer-last：单个采访者的姓氏。请勿添加内部链接——应改用interviewer-link。对于来源中仅列出一个名称的采访者，可直接使用interviewer或其别名（如|interviewer=Bono）。别名：interviewer-last1、interviewer1-last、interviewer-surname、interviewer-surname1、interviewer1-surname、interviewer、interviewer1。
  • interviewer-first：采访者的名字或教名；例如：“Firstname Middlename”或“Firstname M.”或“Firstname M., Sr.”。请勿添加内部链接——应改用interviewer-link。别名：interviewer-first1、interviewer1-first、interviewer-given、interviewer-given1、interviewer1-given。必须与interviewer-last配合使用；若interviewer-last为空则不显示名字。
  • interviewer：此参数用于填写单个采访者的全名（包含名和姓）。不可填写多个采访者姓名。
  • 多位采访者时，使用interviewer-last1、interviewer-first1至interviewer-lastn、interviewer-firstn，其中n为任意连续数字（每个interviewer-firstn需要对应的interviewer-lastn，但反之不成立）。参见display参数调整显示的采访者数量。interviewer-last1至interviewer-lastn的别名：interviewer1至interviewern。如需同时标注全名采访者和单名采访者，可使用|interviewer-first1=… |interviewer-last1=… |interviewer2=…组合。

季数（season）

• season：通常用于美剧的季数编号。
• 或：series-number：通常用于英剧的系列编号。别名：series-no。
• number：多数剧集通过季数和集数组合标识。部分剧集采用包含季数的单集编号格式，此时可省略季数字段。

电视网（network）

• network：播出该剧集的电视网名称（如ABC、NBC、CBS、Fox、迪士尼、USA电视网、BBC）。
  • station：当地电视台呼号（如有）。

文字记录（transcript）

• transcript：原始来源的文字记录。
  • transcript-url：文字记录的在线地址。

会议（conference）

• conference：会议名称。
  • conference-url：会议议程网址（若与url不同）。

上述文档嵌入自Template:Citation Style documentation/doc。（编辑 | 历史）
编者可以在本模板的沙盒（创建 | 镜像）和测试样例（创建）页面进行实验。
请在/doc子页面中添加分类。本模板的子页面。