跳转到内容

Template:Citation Style documentation/doc

本页使用了标题或全文手工转换
维基百科,自由的百科全书

使用方法

[编辑]

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

上述参数是按上下文逻辑而非字母顺序排列的。以下参数虽然通常至少在某些引用模板中可用,但未包含在上述完整参数集中:authorsbook-titleclassdegreedocketencyclopediamailing-listmessage-idnumberpublication-datesectionsheetsheetstitle-links2cid

横式排列的最常用参数

[编辑]
  • {{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英语COinS元数据,供文献管理软件提取书目信息(参见WP:COinS英语WP:COinS。因此使用模板时:

  • 每个参数仅包含单一数据项,不附加说明文字。例如应使用|date=2007-09-27,而非|date=2007-09-27(纸质版为9月25日)
  • 不建议在引用模板内嵌套其他模板,以防冗余HTML/CSS代码混入元数据。
  • 影响元数据的参数中不应使用HTML实体(如&nbsp;&ndash;&#160;)。
以下参数参与生成COinS元数据

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

  • periodicaljournalnewspapermagazineworkwebsiteencyclopediaencyclopaediadictionary
  • chapterscript-chaptercontributionscript-contributionentryscript-entryarticlescript-articlesectionscript-section
  • titlescript-titlebook-title
  • publication-placeplacelocation
  • dateyearpublication-date
  • seriesversion
  • volumeissuenumber
  • pagepagesatquote-pagequote-pages
  • edition
  • publisherinstitution
  • urlchapter-urlcontribution-urlsection-url
  • author-lastauthor-last#author#-lastauthor-surnameauthor-surname#author#-surnamelastlast#surnamesurname#authorauthor#subjectsubject#hosthost#
  • author-firstauthor-first#author#-firstauthor-givenauthor-given#author#-givenfirstfirst#givengiven#
  • degree
  • arxivbibcodebiorxivciteseerxdoieissneprinthdlisbnissnjfmjstorlccnmessage-idmroclcostipmcpmidrfcssrns2cidzbl

句号分隔符(sep_period)

[编辑]

[编辑子模板]

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

逗号分隔符(sep_comma)

[编辑]

[编辑子模板]

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

必填参数(required)

[编辑]

[编辑子模板]

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

已弃用参数(deprecated)

[编辑]

[编辑子模板]


引文格式1/2过时参数
过时参数 替换参数
|coauthor=
|coauthors=
  • |last1=|first1=|last2=|first2=等;或
  • |author1=|author2=等;或
  • |vauthors=
  • |authors=

作者(author)

[编辑]

[编辑子模板]

  • author:作者姓名。一般用于中文人名或机构名称;英文人名应使用|first=|last=分别填写名和姓。多位作者需分别填写,详见下文说明。如需添加内部链接,请使用author-link参数。请勿使用斜体。别名:author1
    • last:作者的姓氏(一般用于英文人名);例如:“Smith”。如需添加内部链接,请使用author-link参数。别名:surnamelast1surname1
    • first:作者的名字(一般用于英文人名);例如:“John Michael”或“J. M.”。如需添加内部链接,请使用author-link参数。别名:givenfirst1given1。必须与last参数配合使用;若last参数为空则不显示名字。
    • 或者:多位作者时使用author1authorn(中文人名)或last1first1lastnfirstn(英文人名),其中n为任意连续数字,支持无限数量的作者(每个firstn需要对应的lastn,但反之不成立)。参见display参数来调整显示作者数量。别名:surname1given1surnamengivenn
    • author-link:作者的维基百科条目名称,而非作者个人网站;仅填写条目名称即可,无需特殊语法。别名:author-link1author1-linkauthorlink
    • 或者:多位作者时使用author-link1author-linkn。别名:author1-linkauthorn-link
    • name-list-style:(罕用)姓名显示格式。设为amp&时,用“&”连接最后两位作者;设为vanc时,按温哥华格式显示姓名列表(需使用last/first参数填写姓名)。
  • vauthors温哥华格式的作者列表(用逗号分隔);机构名需用双括号包裹,如:|vauthors=Smythe JB, ((Megabux Corp.)), etal
    • author-linkauthor-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-surnameeditor1-lasteditor-last1
    • editor-first:编者的名字(一般用于英文人名);例如:“John Michael”或“J. M.”。如需添加内部链接,请使用editor-link参数。别名:editor-giveneditor1-firsteditor-first1。必须与editor-last参数配合使用;若editor-last参数为空则不显示名字。
    • 或者:多位编者时使用editor1editorn(中文人名)或editor-last1editor-first1editor-lastneditor-firstn(英文人名),其中n为任意连续数字(每个editor-firstn需要对应的editor-lastn,但反之不成立)。别名:editor-surname1editor-given1editor-surnameneditor-givenn
    • editor-link:编者的维基百科条目名称,而非编者个人网站;请勿添加内部链接。别名:editor-link1editor1-link
    • 或者:多位编者时使用editor-link1editor-linkn(别名editorn-link)。
    • name-list-style:接受有限的关键词值:设为amp&时,在姓名列表最后两个名字间插入“&”符号;设为vanc时,当姓名参数采用last/first格式时,按温哥华格式显示姓名列表。
  • veditors温哥华格式的逗号分隔编者列表;机构名称需用双括号包裹。如适用可添加etal:
    |veditors=Smythe JB, ((Megabux Corp.)), etal
    • editor-linkneditor-maskn可用于|veditors=中的个人姓名,用法同上
  • 显示规则:
    使用display-editors指定显示的编者人数,其余编者以“et al.”形式省略显示。
    若存在作者:先显示作者,接着显示文献名称,然后是编者姓名和“(编)”,收录该文献的作品名称(如期刊名)。
    若无作者:编者显示在文献名称前,并显示“(编)”。

标题(title)

[编辑]

[编辑子模板]

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

  • title:来源标题。可添加内部链接至现有条目或使用url添加外部链接,但二者不可同时使用。
    • script-title:非拉丁文字标题(日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等)。必须前缀支持的语言代码以确保浏览器正确显示,如:|script-title=ja:東京タワー
    • trans-title:外文来源标题的中文翻译。显示在title后的方括号内。建议配合language参数使用。
含特殊字符的标题需经编码才能正确显示和链接:
换行符 [ ] |
空格 &#91; &#93; {{!}}(推荐)
{{bracket|文本}} &#124; 或 {{pipe}}另见Help:表格 § 管道符渲染
  • title-linktitle所指来源的维基百科条目标题。若需添加外部链接请改用url参数
本字段的选项:

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

  • encyclopedia = encyclopedia
  • 默认值 = title

网页(web)

[编辑]

[编辑子模板]

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

  • title:网站来源页面标题。
    • script-title:非拉丁文字标题(日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等)。必须前缀支持的语言代码以确保浏览器正确显示,如:|script-title=ja:東京タワー
    • trans-title:外文来源标题的中文翻译。显示在title后的方括号内。建议配合language参数使用。
含特殊字符的标题需经编码才能正确显示和链接:
换行符 [ ] |
空格 &#91; &#93; &#124;
{{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将不显示,并会生成错误提示。别名:journalnewspapermagazineperiodicalwebsite
    • script-work:原文出版物名称(非拉丁文字)。必须前缀支持的语言代码以确保浏览器正确显示。拉丁文字出版物(捷克语、法语、土耳其语、越南语等)留空。别名:script-journalscript-newspaperscript-magazinescript-periodicalscript-website
    • trans-work:外文出版物名称的中文翻译。显示在workscript-work后的方括号内。别名:trans-journaltrans-newspapertrans-magazinetrans-periodicaltrans-website
  • issue:连续出版物的期号。若该期有专属标题,可连同期号一并给出,例如|issue=2, 现代加拿大文学。别名:number,根据出版物实际用词选择。若同时存在两种编号(通常一种按年编号,一种绝对编号),可合并标注(如|issue=2 #143)。显示在括号内,跟随volume之后。
  • article-number:期刊为每篇文章分配的文章编号;显示在卷号/期号和页码之间。
  • department:期刊或杂志中的常设栏目名称。例如“通讯”、“社论”、“读者来信”和“评论”。显示在title之后,以纯文本形式呈现。
本字段的选项:
  • |article_num=yes 显示article_num参数的说明。
  • |department=yes 显示department参数的说明。

版本(edition)

[编辑]

[编辑子模板]

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

系列(series)

[编辑]

[编辑子模板]

  • seriesversion:当来源属于某个系列(如丛书或卷号重新编排的期刊)时使用。

剧集(series_episode)

[编辑]

[编辑子模板]

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

活动(event)

[编辑]

[编辑子模板]

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

通讯社(agency)

[编辑]

[编辑子模板]

  • agency:提供内容的通讯社(新闻机构);如美联社路透社法新社。若内容直接发布在通讯社官网(如apnews.com或reuters.com)则不使用此参数,应改用workpublisher。可附对应的内部链接。

卷号(volume)

[编辑]

[编辑子模板]

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

日期(date)

[编辑]

[编辑子模板]

  • date:引用来源的发布日期。可以是完整日期(年、月、日)或部分日期(年和月、年和季节或仅年份)。完整的年月日应当使用“YYYY-MM-DD”格式(如2025-06-02)。请勿添加内部链接。日期显示在作品载体和出版商之后。
使用简短脚注英语Help:Shortened footnotes时,完整引用的锚点通过此参数指定的年份生成。若同一作者在同一年份有多部作品,可在年份后附加小写字母加以区分(如|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:列明来源中的写法);城市名称有歧义,或不知名,宜附省/州名或国名。通常不添加内部链接。当出版物名称已包含出版地时可省略(如《波士顿环球报》《印度时报》)。若地名与来源发表时不同,请使用出版物上标注的地名或来源发表时的地名。显示在标题之后。别名:locationplace
    • 目前placelocation严格来讲是新闻报道电头英语Dateline中的报道撰写地参数,但为了兼容性考虑,当未定义publication-place时仍将其作为出版地显示。具体规则:若仅定义了publication-placeplacelocation其中之一,将作为出版地显示在标题后;若同时定义了publication-placeplace/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)

[编辑]

[编辑子模板]

标识符2(id2)

[编辑]

[编辑子模板]

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

  • arxivarXiv标识符;例如:|arxiv=hep-th/9205027(2007年4月前)或|arxiv=0706.0001(2007年4月—2014年12月)或|arxiv=1501.00001(2015年1月起)。请勿包含“.pdf”或“.html”等无关文件扩展名。别名:ARXIVeprint
  • asin亚马逊标准识别号码;若首字符为数字,请使用isbn。由于此链接偏向特定分销商,仅在无标准标识符时使用。例如:|asin=B00005N5PF。别名:ASIN
    • ASIN-TLD:非美国亚马逊网站的顶级域名。别名:asin-tld
  • bibcodebibcode;用于多个天文数据系统;例如:1974AJ.....79..819H。别名:BIBCODE
  • biorxivbioRxiv标识符,需完整DOI(如10.1101/078733对应http://biorxiv.org/content/early/2016/10/01/078733或https://doi.org/10.1101/078733)。别名:无。
  • citeseerxCiteSeerX标识符,为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-datedoi-inactive-datedoi_brokendatedoi_inactivedate
  • eissn:电子版国际标准期刊号;8位字符,通常用连字符分为两组;例如:|eissn=1557-2986。别名:EISSN
  • hdlHandle系统英语Handle System数字对象标识符;例如:|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”)及校验码。别名:ISBNisbn13ISBN13
  • ismn國際標準音樂編號;例如:979-0-9016791-7-7连字符或空格可选。请使用作品印刷的ISMN。此参数应仅包含ISMN不包含其他字符。系统会校验长度、非法字符及校验码。别名:ISMN
  • issn国际标准期刊号;8位字符,通常用连字符分为两组;例如:|issn=2049-3630。别名:ISSN
  • jfm数学进展年鉴英语Jahrbuch über die Fortschritte der Mathematik;值中请勿包含“JFM”;例如:|jfm=53.0144.01。别名:JFM
  • jstorJSTOR标识符;例如:|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美国能源部科学和技术信息办公室英语Office of Scientific and Technical Information标识符;例如:|osti=4367507。别名:osti
  • PMCPubMed Central文章编号;不包含“PMC”,如|pmc=345678与下方的PMID参数不同。别名:pmc
    • embargoPMC开放日期;在此日期之前不会生成链接。别名:无。
  • PMIDPubMed唯一标识符;例如:|pmid=17322060与上方的PMC参数不同。别名:pmid
  • RFCRFC(请求意见稿)编号;例如:|rfc=3143。别名:rfc
  • SSRNSSRN;例如:|ssrn=1900856。别名:ssrn
  • s2cid语义学者语料库ID;例如:|s2cid=37220927。别名:S2CID
  • unified统一书号。别名:csbnCSBN
  • 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英语Help:Using archive.today等服务;需配合archive-dateurl使用。默认优先显示存档链接,原始链接置于末尾(可通过设置|url-status=live优先显示原始链接)。别名:archiveurl
      • archive-date:存档服务快照日期;默认前缀“原始内容存档于”。格式为“YYYY-MM-DD”。别名:archivedate
      • url-status:控制|title=的标题文字链接至|url=还是|archive-url=;需同时定义urlarchive-url。网址无存档时,使用{{dead link}}标记链接已失效。标注链接是否失效曾使用dead-url参数:yes表示已失效,no表示未失效。
        接受多组关键词:
        • dead—(默认状态)链接至|archive-url=
        • live—链接至|url=;用于预防性存档的链接
        • deviated—链接至|archive-url=;用于原网址仍可访问但不再支撑文中论述
        • unfitusurped—链接至|archive-url=;用于原网址已被劫持用于垃圾信息、广告或不适合展示时,原网址链接被将隐藏
      • archive-formatarchive-url指向文件的格式(如DOC、XLS),用法同format
    • url-access详见URL参数访问指示
  • formaturl指向文件的格式(如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:可获取chaptercontribution指定文本的在线地址。若这些参数已添加内部链接则不可使用。如已填写url,应与其属于同一站点。使用chapter-url时,仅当著作起始部分与被引章节位于站点不同网页时才需使用url。别名:contribution-urlsection-url
  • chapter-formatchapter-url指向文件的格式(如DOC、XLS),显示在chapter后的括号内。HTML为默认格式无需指定,PDF会自动检测无需指定。不影响外部链接图标

引文(quote)

[编辑]

[编辑子模板]

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

通俗摘要(lay)

[编辑]

[编辑子模板]

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

引用锚点(ref)

[编辑]

[编辑子模板]

显示选项(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. 
标识符访问指示
[编辑]

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

命名标识符与访问指示
标识符 访问参数 允许值
|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参数。
    • 或:多位受访者时使用firstnlastn组合。
  • subject-link:受访者维基百科条目标题——非个人网站;请勿添加内部链接。别名:subject-linkauthor-linkauthor-linknsubject-linknauthorn-link
  • 或:多位受访者时使用subject-linkn
别名:subjectlastlastnauthornauthorsubjectn

采访者(interview_interviewer)

[编辑]

[编辑子模板]

  • interviewer-last:单个采访者的姓氏。请勿添加内部链接——应改用interviewer-link。对于来源中仅列出一个名称的采访者,可直接使用interviewer或其别名(如|interviewer=Bono)。别名:interviewer-last1interviewer1-lastinterviewer-surnameinterviewer-surname1interviewer1-surnameinterviewerinterviewer1
    • interviewer-first:采访者的名字或教名;例如:“Firstname Middlename”或“Firstname M.”或“Firstname M., Sr.”。请勿添加内部链接——应改用interviewer-link。别名:interviewer-first1interviewer1-firstinterviewer-giveninterviewer-given1interviewer1-given。必须与interviewer-last配合使用;若interviewer-last为空则不显示名字。
    • interviewer:此参数用于填写单个采访者的全名(包含名和姓)。不可填写多个采访者姓名。
    • 多位采访者时,使用interviewer-last1interviewer-first1interviewer-lastninterviewer-firstn,其中n为任意连续数字(每个interviewer-firstn需要对应的interviewer-lastn,但反之不成立)。参见display参数调整显示的采访者数量interviewer-last1interviewer-lastn的别名:interviewer1interviewern。如需同时标注全名采访者和单名采访者,可使用|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不同)。