Template:Citation Style documentation

模板文档[查看] [编辑] [历史] [清除缓存]

使用方法

本模板用于为引文格式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=}}

完整纵向样式

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

三栏格式

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

<!--
* Start with: 
-->
{{csdoc|usage vertical}}
<pre style="margin:0px;">
<!--
* Create the vertical list column
* Separate the next column with:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* Create the prerequisites column; blank lines must include a &nbsp;
* Separate the next column with:
-->
</pre>
{{csdoc|usage vertical mid}}
<pre style="margin:0px;">
<!--
* Create the instructions column; blank lines must include a &nbsp;
* End with:
-->
</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）

Template:Citation Style documentation/usage vertical |}

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

Template:Citation Style documentation/usage vertical mid |}

纵向样式结束栏（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填写，此参数将被忽略）

在列出别名（aliases）的地方，只能定义一个参数；如果定义了多个别名参数（aliased parameters），那么只有一个会被显示。

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禁用分类，主要用于文档中展示错误示例。

新增功能（whats new）

已弃用参数（deprecated）

引文格式1/2过时参数

过时参数	替换参数
|coauthor= |coauthors=	|last1=、|first1=、|last2=、|first2=等；或 |author1=、|author2=等；或 |vauthors=或 |authors=

作者（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：温哥华格式的逗号分隔作者列表；机构作者名需用双括号包裹。如适用可添加etal：

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

  • author-link和author-mask可用于|vauthors=中的个人姓名，用法同上
• authors：已弃用自由格式的作者列表参数；不建议使用此参数，因其不贡献引文元数据；并非last的别名
• translator：译者姓名。一般用于中文人名或机构名称；对于英文人名，优先使用|translator-first=和|translator-last=组合。如需添加内部链接，请使用translator-link。支持按原样显示标记。别名：translator1。
  • translator-last：译者姓氏（一般用于英文人名）。如需添加内部链接，请使用translator-link。别名：translator-surname、translator1-last、translator-last1。
  • translator-first：译者名字（一般用于英文人名）。如需添加内部链接，请使用translator-link。别名：translator-given、translator1-first、translator-first1。
  • 或者：多位译者时使用translator1至translatorn（中文人名）或translator-last1、translator-first1至translator-lastn、translator-firstn（英文人名），其中n为任意连续数字。别名：translator1-last、translator1-first至translatorn-last、translatorn-first。
  • translator-link：译者的维基百科条目名称，而非其个人网站；请勿添加内部链接。别名：translator-link1、translator1-link。
  • 或者：多位译者时使用translator-link1至translator-linkn。别名：translator1-link至translatorn-link。

• 注意：使用{{sfn}}或{{harv}}时，请勿在单个字段中包含多个姓名，否则锚点将无法匹配内联链接。

本字段的选项：

• |contributor=yes 添加贡献者字段（仅限cite book和citation模板使用）
• |others=yes 添加others：用于记录作品的其他贡献者，例如“插图：史密斯”或“翻译：史密斯”
• |aliases= 为last参数添加别名

编者（editor）

• editor-last：编辑的姓氏。请勿添加内部链接——应改用editor-link。对于姓氏通常写在前面（如中文）或机构编辑的情况，直接使用editor-last保持与来源相同的格式。别名：editor-last1、editor1-last、editor-surname、editor-surname1、editor1-surname、editor、editor1。
  • editor：此参数用于填写单个编辑的全名（包含名和姓）或编辑委员会名称。此参数不应填写超过一个编辑的姓名。支持按原样显示标记。
  • editor-first：编辑的名字或教名，包含头衔；例如：“Firstname Middlename”或“Firstname M.”或“Dr. Firstname M., Sr.”。请勿添加内部链接——应改用editor-link。别名：editor-first1、editor1-first、editor-given、editor-given1、editor1-given。
  • 或者：多位编辑时使用editor-last1、editor-first1至editor-lastn、editor-firstn（别名：editorn-last、editor-surnamen或editorn-surname；editorn-first、editor-givenn或editorn-given；editorn）。如需同时标注个人编辑和机构编辑，可使用|editor-first1=…|editor-last1=… |editor2=…组合。
  • editor-link：指向编辑维基百科条目的标题——非编辑个人网站；请勿添加内部链接。别名：editor-link1。
  • 或者：多位编辑时使用editor-link1至editor-linkn（别名editorn-link）。
  • name-list-style：接受有限的关键词值：设为amp、ampersand或&时，在姓名列表最后两个名字间插入“&”符号；设为and时插入“and”连接词；设为vanc时，当姓名参数采用last/first格式时，按温哥华格式显示姓名列表。
• veditors：温哥华格式的逗号分隔编辑列表；机构名称需用双括号包裹。如适用可添加etal：

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

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

  使用display-editors控制显示的编辑姓名列表长度，并指定何时包含“etal”。

  若存在作者：先显示作者，接着显示被引作品，然后是“In”和编辑者，最后显示主作品。

  若无作者：编辑者显示在被引作品前；单个编辑者后加“ed.”；多位编辑者后加“eds.”。

标题（title）

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

• 标题：来源标题。可添加内部链接至现有条目或使用url添加外部链接，但二者不可同时使用。
  • script-title：非拉丁文字标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示：

    ... |script-title=ja:東京タワー |trans-title=东京塔 ...

  • trans-title：外文来源标题的中文翻译。显示在标题后的方括号内。建议配合language参数使用。

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

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

• title-link：title所指来源的维基百科条目标题——不要使用网址；请勿添加内部链接。

本字段的选项：

title_title设置显示标题：

• encyclopedia = 百科全书
• 默认值 = 标题

网页（web）

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

• title：网站来源页面标题。
  • script-title：非拉丁文字标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示：

    ... |script-title=ja:東京タワー |trans-title=东京塔 ...

  • trans-title：外文来源标题的中文翻译。显示在title后的方括号内。建议配合language参数使用。

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

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

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

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

章节（chapter）

• chapter：来源的章节标题。可添加内部链接或使用chapter-url，但二者不可同时使用。
  • script-chapter: 非拉丁文字章节标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。必须前缀支持的语言代码以确保浏览器正确显示：

    ... |script-chapter=ja:東京タワー |trans-chapter=东京塔 ...

  • trans-chapter: 外文来源章节标题的英文翻译。显示在chapter字段后的方括号内；若定义了chapter-url，则trans-chapter会包含在链接中。建议配合language参数使用。
• contribution：由author之外其他人撰写的书籍部分。可添加内部链接或使用contribution-url，但二者不可同时使用。贡献内容的作者信息通过contributor参数提供。

本字段的选项：

title_format设置显示格式：

• italics = 显示为斜体
• work = 若定义了work参数，则title显示为引号内文本，否则显示为斜体
• 默认值 = 显示为引号内文本

title_title设置显示标题：

• booktitle = booktitle
• 默认值 = chapter

类型（type）

• type：提供来源媒体类型的附加信息。也可用于标识标题链接的稿件类型（若非最终版本，例如预印本可免费获取但正式版本需付费）。显示在标题后的括号内。保留关键字none可禁用类型显示。例如：论文、小册子、录用稿件、CD内页说明、新闻稿。别名：medium。

本字段的选项：

• type_default: Adds "Defaults to type_default"

期刊（journal）

• work（{{cite journal}}和{{cite magazine}}必填）：包含来源的出版物名称；相关时可添加内部链接。若出版物名称随时间变更，请使用来源发表时的名称。别名：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：周期性出版物的期号。别名：number。若该期有专属标题，可连同期号一并给出，例如|issue=2, 现代加拿大文学。请根据实际出版物选用|issue=或|number=。若出版物同时标注期号和编号（通常一个为年度相对值，一个为绝对值），请一并提供，例如|issue=2 #143。显示在括号内跟随volume后。

当设置work时，将改变同一引用中其他参数的格式：

chapter不显示（并会生成错误提示）

本字段的选项：

• department参数添加：

• department：期刊或杂志中的常规部门或栏目。例如“通讯”、“社论”、“读者来信”和“评论”。显示在title之后，以纯文本形式呈现。

版本（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之后；纯数字输入（如“37”）。纯数字、全大写罗马数字或少于5个字符的卷号会加粗显示，5个及以上字符的字母数字组合不加粗。极少数出版物同时标注连续卷号和年度卷号时需一并提供，例如|volume=IV/#10。

日期（date）

• date：引用来源的发布日期。可以是完整日期（日、月、年）或部分日期（月和年、季节和年或仅年份）。格式需与文中其他引用保持一致。请勿添加内部链接。显示在网站和出版商之后。可接受的日期格式参见Help:引文格式1 § 日期。

简短脚注通过此参数指定的年份定位完整引用。当年份格式非YYYY-MM-DD时，可在年份后添加小写字母以区分{{sfn}}链接中同作者同年的不同作品^[详情]。

网页、PDF等无可见日期的来源，可通过查看页面源代码或文档代码中的created/updated日期确定；可添加编辑注释如date=2021-12-25<!--页面代码日期--> |orig-date=原始日期2011-01-01。

• year：出版年份。更灵活的|date=参数也可单独处理年份。除非满足以下两个条件，否则不要与|date=参数同时使用：
  1. 简短脚注需要区分同姓氏同年的多个引用（这种情况需要使用CITEREF消歧义字母）
  2. |date=格式为YYYY-MM-DD（此格式会阻止年份后添加消歧义字母）
• orig-date：原始发布日期或年份；显示在date（或year）后的方括号内。为明确起见，请提供具体说明，例如：|orig-date=首版于1859或|orig-date=创作于1904。由于|orig-date=不支持自动日期格式化，请使用与|date=参数一致的格式。别名：orig-year

本字段的选项：

• limited_param_list隐藏orig-date参数，因为该参数在有限参数模板中不允许使用

出版商（publisher）

• publisher：出版商名称；可添加对应的内部链接。出版商是指出版被引用作品的公司、组织或其他法律实体。请勿将publisher参数用于出版物名称（如网站、书籍、百科全书、报纸、杂志、期刊等）。若出版商名称随时间变更，请使用出版物上标注的名称或来源发表时的名称。通常不包含“有限公司”、“股份公司”等企业标识。该参数最常用于书籍，较少用于网站或期刊（某些情况下可替代work）。当出版商名称与出版物名称基本相同时可省略（例如《纽约时报》由纽约时报公司出版，无需重复说明）。显示在title之后。
• place：对于含电头的新闻报道，指报道撰写地点。若地名随时间变更，请使用出版物上标注的名称或来源发表时的名称。在早期模板版本中此为出版地，为保持兼容性，当未定义publication-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显示。格式需与文中其他日期一致；请勿添加内部链接。
• via：内容分发方名称（若不同于publisher）。via不是publisher的替代参数，而是提供额外信息。适用于：文章署名其他出版物（如雅虎新闻）但无法溯源时；内容分发方（如NewsBank）以非原始格式呈现时；提供的URL未明确分发方身份时；无URL或DOI时（如EBSCOhost）；或分发方要求署名时。访问限制显示参见access level参数；原始来源为通讯社时参见agency参数。

本字段的选项：

• |work=no取消“若定义了work，则publisher和location显示在括号内”的默认规则
• |map=yes将改变：
  • publisher：出版商名称。出版商是指出版被引用作品的公司。请勿将publisher参数用于出版物名称（如书籍、百科全书、报纸等）。显示在标题前。请勿添加内部链接——应改用publisher-link。
  • publisher-link：指向出版商维基百科条目的标题——非出版商网站；请勿添加内部链接。

新闻组（newsgroup）

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

语言（language）

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

页码（pages）

• page：来源中支撑内容的具体单页页码。使用|page=或|pages=二者之一。别名：p。
• 或：pages：来源中支撑内容的页码范围。使用|page=或|pages=二者之一。用短横线（–）分隔连续页码，用逗号（,）分隔非连续页码；不可用于表示来源总页数。
  别名：pp。
• 或：at：用于页码不适用或不充分的情况。会被|page=或|pages=覆盖。|page=、|pages=和|at=三者仅能使用其一。
  示例：页（p.）或页数（pp.）；节（sec.）、栏（col.）、段（para.）；音轨；时分秒；幕、场、篇章、书、部分、对开页、诗节、封底、唱片内页、版权页、书籍末页、护封、诗句。
• 与|quote=配合使用的|quote-page=和|quote-pages=参数说明参见此处。

时间（time）

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

标识符1（id1）

• id：唯一标识符，在无专用标识符时使用；可添加内部链接或使用外部链接模板。例如|id=NCJ 122967将在引文末尾添加“NCJ 122967”。也可使用模板如|id={{NCJ|122967}}来显示美國犯罪司法參考服務資料庫 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）。别名：none。
• citeseerx：CiteSeerX标识符，为URL中的数字与点组合（如10.1.1.176.341对应https://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.176.341）。别名：none。
• cn：国内统一刊号。别名：CN。
• doi：数字对象标识符（DOI）；例如：10.1038/news070508-7。系统会验证其是否以(10.)开头。别名：DOI。
  • 支持按原样显示标记以接受非标准格式的有效DOI。
  • doi-broken：DOI在https://doi.org失效的日期。格式需与文中其他日期一致。别名：doi-broken-date、doi-inactive-date、doi_brokendate、doi_inactivedate。
• eissn：电子版国际标准期刊号；8位字符可用连字符分为两组（不可用短横线或空格）；示例|eissn=1557-2986。别名：EISSN。
  • 支持按原样显示标记以接受非标准格式的有效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。
  • 可使用{{Format ISBN}}模板自动添加连字符：|isbn={{Format ISBN|9780812695939}}。
  • 支持按原样显示标记以接受非标准格式的有效ISBN。
• ismn：國際標準音樂編號；例如：979-0-9016791-7-7。连字符或空格可选。请使用作品印刷的ISMN。此参数应仅包含ISMN不包含其他字符。系统会校验长度、非法字符及校验码。别名：ISMN。
• issn：国际标准期刊号；8位字符可用连字符分为两组（不可用短横线或空格）；示例|issn=2049-3630。别名：ISSN。
  • 支持按原样显示标记以接受非标准格式的有效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：OCLC号用于在WorldCat联合目录检索；示例|oclc=9355469。别名：oclc。
• ol：开放图书馆标识符；值中请勿包含“OL”；示例|ol=7030731M。别名：OL。
• OSTI：科技信息办公室；示例|osti=4367507。别名：osti。
• PMC：PubMed Central；使用开放获取期刊文章编号，如|pmc=345678。值中请勿包含“PMC”。另见下方PMID参数，此为两种不同标识符。别名：pmc。
  • embargo：PMC开放日期；若该日期在未来，则在此之前不会生成链接。别名：none。
• PMID：PubMed唯一标识符；示例|pmid=17322060另见上方PMC参数，此为两种不同标识符。别名：pmid。
• 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=参数指定访问状态。

对于{{cite journal}}，当未使用|url=和|title-link=时，某些标识符（指定免费资源）会自动链接至标题。可通过|title-link=的特殊关键字（|title-link=pmc或|title-link=doi）手动选择链接目标，或使用|title-link=none禁用此功能。

若标识符生成的链接与现有链接完全相同，则无需额外指定URL。此时|url=（或|title-link=）可用于提供直接文档链接或便捷访问链接。

网址（url）

• url：可获取title指定出版物文本的在线地址。若title已添加内部链接则不可使用。如适用，链接可指向具体引用页。需移除URL中的跟踪参数（如#ixzz2rBr3aO94或?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...）。PDF文件或Google图书的页面链接参见WP:PAGELINKS。请勿链接至商业售书网站（如亚马逊），应使用|isbn=或|oclc=提供中立图书检索链接。含空格等无效URL将触发错误提示。
  • access-date：最后验证url内容支撑文中论述的完整日期；需配合url使用；格式需与其他访问/存档日期一致。不适用于内容不变的链接文档。例如：无出版日期的个人网站等在线资源必须提供访问日期（参见WP:CITEWEB），但已发表论文或书籍的链接无需提供。注意此日期仅表示验证网址有效且支撑引文内容的日期。注册用户可隐藏或自定义样式。别名：accessdate。
  • archive-url：网页存档快照的URL。通常指向互联网档案馆（参见WP:使用时光机）或archive.today（参见en:Help:Using archive.today）等服务；需配合archive-date和url使用。默认（可被|url-status=live覆盖）优先显示存档链接，原始链接置于末尾。别名：archiveurl。
    • archive-date：存档服务快照日期；默认前缀“存档于原页面”。格式需与其他访问/存档日期一致。请勿添加内部链接；不建议使用模板日期。别名：archivedate。
    • url-status：控制参数，选择通过|title=链接|url=或|archive-url=；需同时定义url和archive-url。无存档网址时，使用{{dead link}}标记失效|url=。

      接受多组关键词：

      • dead - （默认状态）选择|archive-url=
      • live - 选择|url=；用于预防性存档的链接
      • deviated - 选择|archive-url=；用于原网址仍有效但不再支撑文中论述
      • unfit - 选择|archive-url=；用于原网址指向赌博/色情/广告/恶意软件/钓鱼等不良内容时，将隐藏原网址链接。若整个域名不可用，可考虑域名接管或黑名单，机器人辅助参见en:WP:URLREQ
      • usurped - 选择|archive-url=；用于域名被劫持转向不良内容时，将隐藏原网址链接
      • bot: unknown - 机器人无法判定网址状态时遗留的值，页面会自动归入Category:CS1 maint: bot: original URL status unknown，编者需手动评估并修正参数值

    • archive-format：archive-url指向文件的格式（如DOC/XLS），显示在存档链接后的括号内。HTML为默认格式无需指定，PDF会自动检测无需指定。不影响外部链接图标（PDF除外）。注意：链接图标不含替代文本，故无法为视障用户提供格式信息（PDF因自动添加“(PDF)”描述文本而无此问题）。参见format参数用法
  • url-access：参见url参数访问权限指示器
• format：url指向文件的格式（如DOC/XLS），显示在标题后的括号内。（媒体格式请用type参数。）HTML为默认格式无需指定，PDF会自动检测无需指定。不影响外部链接图标（PDF除外）。注意事项同archive-format。参见format参数用法

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指向文件的格式（如PDF/DOC/XLS），显示在chapter后的括号内。HTML为默认格式无需指定。不影响外部链接图标。注意：链接图标不含替代文本，无法为视障用户提供格式信息。

引文（quote）

• quote：从来源引用的相关文本。显示为引号内文本。需包含终止标点（默认情况下引文会抑制引文终止符句号）。
  • script-quote：非拉丁文字引文（阿拉伯文、西里尔文等）。必须前缀支持的语言代码以确保浏览器正确显示：

    ... |script-quote=ja:東京タワー |trans-quote=东京塔 ...

  • trans-quote：外文引文的中文翻译。显示在方括号内。
• quote-page：|quote=所引用的单页页码。使用|quote-page=或|quote-pages=二者之一。应为|page=、|pages=或|at=指定页面的子集。
• 或：quote-pages：|quote=引用的页面列表或范围。使用|quote-page=或|quote-pages=二者之一。应为|pages=或|at=指定页面的子集。用短横线（–）分隔连续页码，用逗号（,）分隔非连续页码。

本字段的选项：

• |cs2=yes取消“引文需包含终止标点”的默认提示

引用锚点（ref）

• ref：设置引用的HTML锚点标识符。默认不生成锚点。设置|ref=ID会生成指定ID的锚点（对应<cite id="ID">标签的id属性）。此参数允许通过内部链接定位完整引用，这对简短脚注和括号引用特别有用。特殊值|ref=harv会生成兼容{{harv}}模板的锚点格式。

显示控制（display）

• mode：根据设定值调整元素分隔符、默认终止标点和特定大写规则。|mode=cs1使用句号（.）作为分隔符和终止标点；|mode=cs2使用逗号（,）作为分隔符，无终止标点，特定单词保持小写。分别对应引文样式1和样式2。覆盖默认终止标点请使用postscript参数。

• author-mask（作者掩码）：
• contributor-mask（贡献者掩码）：
• editor-mask（编辑掩码）：
• interviewer-mask（采访者掩码）：
• subject-mask（主题掩码）：
• translator-mask（译者掩码）：

  用破折号或文本替换（首位）作者姓名。设为数字n时显示n倍宽破折号；设为文本时直接显示该文本（不带后续分隔符，如“with”）。特殊值0需配合<name>-link使用，此时显示链接文本。无论何种情况，仍需提供完整姓名以生成元数据。主要用于同一作者多部作品连续列出的参考文献（如Template:Sfnote）。不可在{{reflist}}或<references />生成的列表中使用（因无法控制引用显示顺序）。可通过添加枚举值（如|authorn-mask=）对特定姓名应用掩码。

• display-authors（显示作者数）：
• display-contributors（显示贡献者数）：
• display-editors（显示编辑数）：
• display-interviewers（显示采访者数）：
• display-subjects（显示主题数）：
• display-translators（显示译者数）：

  控制显示的作者（或其他贡献者）姓名数量。默认显示全部姓名。例如|display-authors=2仅显示前两位作者（不影响其他贡献者显示）。特殊值|display-authors=0隐藏所有作者（包括“etal”）。|display-authors=etal显示全部姓名后接“etal”。

• 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：地图制作者，显示为“制图：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：会议名称，若与location不同可包含地点信息，若与date或year不同可包含日期。
  • conference-url：会议议程网址（若与url不同）。

注释

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