跳转到内容

Help:引文格式1

维基百科，自由的百科全书
（重定向自Wikipedia:CS1）
引文格式1模板
{{Cite arXiv}}arXiv預印本
{{Cite AV media}}影音媒體
{{Cite AV media notes}}影音媒體內頁說明
{{Cite bioRxiv}}bioRxiv預印本
{{Cite book}}書籍
{{Cite citeseerx}}CiteSeerX論文
{{Cite conference}}會議論文
{{Cite encyclopedia}}引用百科全書的資料
{{Cite episode}}廣播和電視節目
{{Cite interview}}訪談
{{Cite journal}}學術期刊
{{Cite magazine}}雜誌和期刊
{{Cite mailing list}}公共郵件列表
{{Cite map}}地圖
{{Cite news}}新聞報導
{{Cite newsgroup}}線上新聞群組
{{Cite podcast}}播客
{{Cite press release}}新聞稿
{{Cite report}}報告
{{Cite serial}}廣播和電視節目系列
{{Cite sign}}標誌、匾額、銘牌或徽章
{{Cite speech}}演講
{{Cite ssrn}}SSRN論文
{{Cite techreport}}技術報告
{{Cite thesis}}學位論文
{{Cite tweet}}Twitter推文
{{Cite web}}上述模板未包含的其他網路資料
參見

引文格式1（CS1）是一组参考文献引用模板的集合，可为不同引用材料创建不同的样式。其目的是为维基百科上的参考文献提供一组默认格式。该系列模板使用了Module:Citation/CS1模块。

使用CS1或模板并非强制要求。

样式

[编辑]

有许多模板都以cite开头，但它们并非都符合引文格式1。还有一些模板使用通用模板作为元模板来引用特定来源。

符合引文格式1要求的模板必须满足以下条件：

  • 基于Module:Citation/CS1模块或下列模板之一。
  • 使用半角句号区分各成分，并标记引用的结束。
  • 使用半角分号区分各独立作者名及编者名。

模板用法

[编辑]

CS1系列模板提供了一致的输出格式，主要区别在于针对不同引用类型优化的参数。例如：{{cite book}}模板包含“title”（书名）和“chapter”（章节）字段；{{cite journal}}模板则包含“journal”（期刊名）和“title”（文章标题）字段。

本帮助页面使用该系列模板中最常用的参数名称，具体参数说明请参阅各模板文档。

作者

[编辑]
  • 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。
  • others：作品的其他贡献者（如插画师）。例如：“插图由John Smith绘制”。
  • 注意：使用{{sfn}}或{{harv}}时，请勿在单个字段中包含多个姓名，否则锚点将无法匹配内联链接。

日期

[编辑]
  • date：引用来源的发布日期。可以是完整日期（年、月、日）或部分日期（年和月、年和季节或仅年份）。完整的年月日应当使用“YYYY-MM-DD”格式（如2025-05-29）。请勿添加内部链接。日期显示在作品载体和出版商之后。
使用简短脚注（英语：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。

标题与章节

[编辑]
  • title：引用来源的标题。若引用来源本身具有知名度且有维基百科条目，可为标题添加内部链接。但添加内部链接后将无法使用“url”参数链接到外部来源，因此仅当引用无需外部链接的作品时才这样做。优先链接实际来源而非维基百科条目。
  • script-title：用于非拉丁文字标题（日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等）。该参数会将RTL文字用特殊HTML标记包裹以隔离左右混排文本，其中包含浏览器用于正确显示文字的语言属性。编者须在文字前添加支持的语言代码前缀和冒号：|script-title=ar:العربية。无法识别的代码将被忽略并直接显示。
  • trans-title：若引用来源为外文，可在此提供标题的中文翻译。该字段会显示在标题后的方括号内，若使用|url=参数则会一并链接。
  • chapter：引用章节的完整标题，显示在书名前。对于分栏的网站，“at”参数功能类似：|at=精选新闻
  • script-chapter：非拉丁字母书写的章节标题处理方式同script-title，需添加语言代码前缀：|script-chapter=ar:العربية。
  • trans-chapter：外文来源章节标题的中文翻译，显示在章节字段后的方括号中。

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

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

|script-<param>= 语言代码

[编辑]

cs1|2支持的非拉丁文字语言代码包括：

  • ar：阿拉伯语
  • bg：保加利亚语
  • bs：波斯尼亚语
  • dv：迪维希语
  • el：希腊语
  • fa：波斯语
  • he：希伯来语
  • hy：亚美尼亚语
  • ja：日语
  • ka：格鲁吉亚语
  • ko：韩语
  • ku：库尔德语
  • mk：马其顿语
  • ps：普什图语
  • ru：俄语
  • sd：信德语
  • sr：塞尔维亚语
  • th：泰语
  • ug：维吾尔语
  • uk：乌克兰语
  • yi：意第绪语
  • zh：中文

类型

[编辑]
  • type：指定引用作品的类型。紧接在标题后以括号形式显示。某些模板使用可覆盖的默认值；例如：{{cite press release}}默认会显示“(新闻稿)”。

语言

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

作品载体与出版商

[编辑]
  • work：作品载体，用于某些模板如{{cite web}}（别名为website——网站名称）、{{cite news}}（别名为newspaper——报纸名称）、{{cite magazine}}（别名为magazine——杂志名称）、{{cite journal}}（别名为journal——期刊名称）等，通常用于引用大型作品（本“work”参数）中的特定项目（在“title”参数中给出），最常见的是网站文章、期刊论文，或电视剧单集。切勿与“publisher”参数混淆，后者指出版商。若该载体作品有独立条目，应在首次出现时添加内部链接。如果“title”已包含外部链接，则“work”不要添加外部链接。当载体名称与出版商名称相同或高度相似时，应省略“publisher”参数（详见下文）。
对于网站，“work”通常指网站名称（一般显示在网站的logo/横幅区域，和/或首页<title>中，可能会显示在浏览器标签页标题中，具体取决于浏览器）。如果网站实际名称不含“.com”等后缀，则不要添加。一般情况下该参数不要填写域名（WP:列明来源方针明确规定）；只有无法明确网站名称，或名称确实是域名时，则填写网站的域名；不要使用描述性文字（如“[某出版商]的网站”、“[某出版商]主页”）来伪装网站名称。
如果引用的项目是某个更大作品载体的一部分，如丛书中的单册、期刊的特辑或网站下的子站点（如某大学网站中的法学院网站），优先使用具体载体名而非上级载体名。各种引文模板为处理此类情况提供了单独的字段，例如{{Cite book}}中的|chapter=|title=|volume=|series=。如果作品载体的性质及其与网站、书籍或其他上下文有复杂的联系或令人困惑，可在引文模板之后、关闭引文的</ref>之前补充说明。
  • publisher：实际出版来源的组织名称。省略“有限公司”或“股份有限公司”等公司标识，除非会产生歧义或提及该组织时常带有该标识（如苹果公司需保留“公司”以区别苹果唱片）。如果出版商在“work”之外有独立条目，“publisher”参数可添加内部链接，但不要添加出版商网站的外部链接。是否填写出版商参数在一定程度上取决于作品类型，有时也取决于其可识别性。WP:列明来源和大多数维基百科外的引文指南建议应将其用于书籍（即使是著名书籍），但不一定用于其他作品。知名媒体、主要学术期刊，或出版商与作品载体名称相同或基本相同时，不要使用“publisher”参数。例如，以下示例中应省略“publisher”参数：
    |work=[[Amazon.com]]|publisher=Amazon Inc.
    |newspaper=[[人民日报]]|publisher=人民日报社
    |journal=[[自然 (期刊)|自然]]|publisher=[[自然出版集团]]
个人出版物建议明确标注（如何标注尚无共识），关于其可靠性的说明见WP:SELFPUB。经查证仍无法确定出版商时，标注为|publisher=<!--来源未注明-->，以免其他编者浪费时间重复查找；而不要猜测出版商。有关多机构合作出版及如何指定多个出版商及其位置，请参阅下一项。
  • location（别名|publication-place=）：出版地（不是资料获取地或内容涉及地）。填写城市名（如|location=北京，WP:列明来源中的格式）或国家+城市名。当出版物名称隐含地点时（例如《悉尼先驱晨报》），应省略location参数；当出版地是期刊常用称谓的一部分但不是实际标题时，应使用location参数。若使用特定版本，需注明实际出版地（例如，如果出版商在纽约和伦敦都有业务，而您使用的是伦敦出版的版本，则使用|location=伦敦，即使出版商的总部在纽约）。如果您的版本明确给出了多个地点，可以用例如|location=纽约/伦敦表示。同样的方法可用于合出版作品，只需确保两个参数中的顺序对应。模板没有单独的|location1=、|publisher1=等参数。对于仍然值得引用且可查阅的古籍等历史文献（如通过谷歌图书获取的扫描件），需区分出版商（赞助机构）与印刷商（实际印刷厂）；当无法确定时，可同时列出。
  • publication-date：出版日期，与作品创作日期不同时。仅当date或year已定义且不同时显示，否则将publication-date作为date显示。格式需与条目其他日期一致；不要添加内部链接。显示在publisher之后；如果未定义work，则日期前会添加“出版于”并显示在括号内。
  • via（可选）：内容分发平台的名称（当不是出版商时）。“via”不是“publisher”的替代品，而是提供额外细节。当内容分发平台以非原始格式提供内容，来源URL未明确显示传递平台身份时，可以使用此参数。另见§ 订阅或注册要求。此参数的典型用途是识别书籍数字化项目，如互联网档案馆、谷登堡计划和谷歌图书；学术索引服务，例如中国知网、维普资讯、JSTOR；以及其他内容聚合平台，如百度学术、Dictionary.com。优先使用标准标识符（参见§ 标识符）而非via。示例：{{Cite dictionary |entry=skeptic |entry-url=https://www.dictionary.com/browse/skeptic?s=t#collins-section |title=[[Collins English Dictionary]] |edition=Complete & Unabridged Digital |date=2012 |location=London |publisher=[[HarperCollins]] |via=[[Dictionary.com]] |access-date=2025-05-29}}

页码

[编辑]
CS1/CS2模板对
|volume=、|issue=、|page(s)=的支持
模板 |volume= |issue= |page(s)=
{{citation}} 是 是 是
{{cite arXiv}} 否 否 是
{{cite AV media}} 是 否 否
{{cite AV media notes}} 否 否 是
{{cite bioRxiv}} 否 否 是
{{cite book}} 是 否 是
{{cite citeseerx}} 否 否 是
否 否 是
是 是 是
{{cite encyclopedia}} 是 否 是
{{cite episode}} 否 是 否
{{cite interview}} 是 是 是
{{cite journal}} 是 是 是
{{cite magazine}} 是 是 是
{{cite mailing list}} 否 否 否
是 否 是
  • {{cite map}}
  • （作为期刊或杂志）
 是 是 是
{{cite news}} 是 是 是
{{cite newsgroup}} 否 否 否
{{cite podcast}} 否 否 否
{{cite press release}} 否 否 是
{{cite report}} 是 否 是
{{cite serial}} 否 否 否
{{cite sign}} 否 否 否
{{cite speech}} 否 否 否
{{cite ssrn}} 否 否 是
{{cite tech report}} 是 否 是
{{cite thesis}} 是 否 是
{{cite web}} 否 否 是

编者可在引文中使用|pages=、|page=或|at=之一来指定包含佐证文章内容的来源具体位置。若同一引文中使用多个上述参数，|page=会覆盖|pages=和|at=，并显示错误信息。

  • page：来源中包含佐证信息的单页，如|page=52。
  • pages：来源中包含佐证信息的多个页面。用短横线（-）表示范围，如|pages=236-239；非连续页用逗号或分号分隔，如|pages=157, 159；混合格式如|pages=461, 466-467。
    • 注：CS1引文不记录来源总页数，请勿将此参数用于该用途。
  • at：当页码不适用时，描述信息来源位置。如第几栏、第几段、第节段，也可视来源类型使用第几音轨、时:分:秒、第几幕/场等。例如|at=第2段。

同一来源需引用不同页码时，应创建独立引文。变通方案是使用简短引文{{sfn}}或{{rp}}提供带链接的页码标注。

版本标识符

[编辑]
  • edition：当引用来源存在多个版本时，标识的特定版本，例如“第二版”、“修订版”等。若同一作品的不同版本间无内容差异（如仅ISBN号或封面设计不同的英美版本），或影片不同版本的播放时间和剪辑完全相同，则可省略此参数。
  • series：当引用来源属于某个系列（如丛书或卷号重新编排的期刊）时使用。
  • volume：多卷本出版物使用。在标题和series参数后以粗体显示。也可将卷次信息直接包含在title参数中。连续卷次用短横线（-）连接（如|volume=I-IV），非连续卷次用逗号/分号分隔（如|volume=I, III-V）。
  • issue：周期性出版物的期号。别名：number。若某期有专属标题，可附带标注（如|issue=2，现代加拿大文学）。根据出版物实际用词选择issue或number参数。若同时存在两种编号（通常一种按年编号，一种绝对编号），可合并标注（如|issue=2 #143）。数字范围用短横线连接，非连续数字用逗号/分号分隔。

外部链接

[编辑]
  • url：为标题添加链接
  • chapter-url：为章节添加链接
  • format：指定URL指向文档的格式（如PDF、XLS等）。HTML作为默认格式无需特别说明。请勿将此参数用于完全不同的用途（如标注文献类型标识、“需付费”、“重印”等注释），其设计用途是告知读者文件格式（例如某些浏览器可能无法兼容，或读者可能希望将链接保存至本地而非直接在浏览器中打开）。访问限制应使用相应的|url-access=参数标注，参见订阅或注册要求章节。关于重印等其他说明应置于引用模板之后，</ref>标签之前。

使用|format=参数

[编辑]

当MediaWiki遇到带有“.pdf”或“.PDF”文件扩展名的外部链接URL时，它会用PDF图标替代常规的外部链接图标。为了使cs1/2引文模板中链接到PDF文档的引用更符合无障碍，cs1/2会自动添加“(PDF)”标注，以便使用屏幕阅读器的读者了解链接文件的类型。这种做法并不完美，因为有些网站会将.pdf网页重定向到.html的登录页面（这在需要付费或注册才能查看的PDF文档中很常见）。由于“(PDF)”标注是自动添加的，编辑者无需特意设置|format=PDF参数（不过设置也无妨）。

在线资源

[编辑]
主页面：Wikipedia:外部链接和Wikipedia:列明来源

来源链接作为便利性补充，除纯网络来源外并非必须。许多数字图书馆资源可作为有效来源。

  • 应链接至来源的完整版本
  • 可包含需要付费或订阅的在线资源

请勿链接至：

  • 未获授权转载或侵犯版权的网站
  • 商业网站（如亚马逊、当当网），除非无其他选择
  • 作品评论

链接格式

[编辑]

链接应尽可能简洁。例如，在谷歌图书搜索Monty Python and Philosophy，原始链接可能显示为：

https://books.google.com/books?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false

但可简化为：

https://books.google.com/?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false

或：

https://books.google.com/?id=NPDgD546-doC&printsec=frontcover

或：

https://books.google.com/?id=NPDgD546-doC （如果谷歌图书不提供封面页）。

页码链接

[编辑]

若网站支持，可直接链接至特定页码。例如谷歌图书上Monty Python and Philosophy第172页的链接：

https://books.google.com/?id=NPDgD546-doC&pg=PA172

写为:

|page=[https://books.google.com/?id=wPQelKFNA5MC&pg=PA172 172]

特殊字符

[编辑]

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

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

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

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

访问日期

[编辑]
  • access-date：记录通过url链接的内容最后一次被验证支持条目内容的完整日期；不要添加内部链接；必须与url参数同时使用；日期格式需与文中其他引用中的访问/存档日期格式保持一致。对于不会更新的链接文档无需使用该参数。例如：通过DOI获取的已发表研究论文或已出版书籍的链接无需添加访问日期，但商业网站上的新闻文章链接应使用该参数（这些内容可能随时变更，即使它们也有实体版本）。需注意access-date不仅是验证链接可访问的日期，更是确认网页内容支持所引用条目内容的日期（当前网页内容可能已不支持）。注册用户可通过CSS代码隐藏或调整其显示样式。别名：accessdate。

网页存档

[编辑]
更多信息：Wikipedia:Link rot
  • archive-url：存档链接。别名：archiveurl
  • archive-date：存档日期。别名：archivedate

原始链接可能失效。当找到存档版本时，需保留原始URL并添加|archive-url=参数（链接至网页存档副本，通常来自互联网档案馆等服务）。必须添加|archive-date=参数注明网页存档日期（非添加链接的日期）。使用|archive-url=时，必须同时提供|url=和|archive-date=参数，否则会显示错误。使用存档链接时，引文显示效果是标题链接至存档，原始链接显示在末尾： Monty Python and Philosophy. （原始内容存档于2013-05-01）. 

  • url-status：若需将标题保持链接原始网址并在末尾显示存档链接，设置|url-status=live：
Monty Python and Philosophy. （原始内容存档于2013-05-01）. 

当原始URL已被劫持用于垃圾信息、广告或不适合展示时，设置|url-status=unfit或|url-status=usurped可隐藏原始URL显示（但仍需提供|url=和|archive-url=）。当原始URL仍可访问但已不支持条目内容时，设置|url-status=deviated。更多参数说明参见Template:Cite web § csdoc urlstatus。

标识符

[编辑]

以下标识符会生成链接，且仅接受单一数值。使用多个数值或其他文本会破坏链接和/或使标识符失效。通常参数只需包含标识符的可变部分，例如|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-broken：DOI在https://doi.org失效的日期。格式需与文中其他日期一致。别名：doi-broken-date、doi-inactive-date、doi_brokendate、doi_inactivedate。
  • eissn：电子版国际标准期刊号；8位字符可用连字符分为两组（不可用短横线或空格）；示例|eissn=1557-2986。别名：EISSN。
  • hdl：Handle系统（英语：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”）及校验码。别名：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：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=）可用于提供直接文档链接或便捷访问链接。

A custom identifier can be specified through

  • id：唯一标识符（英语：Unique identifier），在无专用标识符时使用；可添加内部链接或使用外部链接模板。例如|id=NCJ 122967将在引文末尾添加“NCJ 122967”。也可使用模板如|id={{NCJ|122967}}来显示美國犯罪司法參考服務資料庫 122967。

订阅或注册要求

[编辑]

为方便读者和其他编者，编者应在引用的外部链接中标注材料获取限制级别。这些级别描述获取材料的条件限制，不涉及材料版权状态或重用权限（因其与可供查证无关）。

可使用四种访问级别：

  • 命名标识符访问指示：
    • 可免费查阅 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. 
命名标识符访问指示
[编辑]

默认认为命名标识符链接需付费/注册（例外见下）。若可免费访问，需用对应参数添加图标。若标识符仅提供摘要服务（无全文），则不可标记为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。

引文

[编辑]
  • 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=指定页面的子集。用短横线（–）分隔连续页码，用逗号（,）分隔非连续页码。

锚点

[编辑]
  • ref：为简短脚注（英语：Help:Shortened footnotes）创建锚点（HTML的id属性）。这些样式使用内文引用，其中的链接可跳转到CS1模板创建的锚点。中文维基默认不启用锚点功能，所以从英文维基翻译的条目，如果使用了简短脚注，需要为完整引用添加|ref=harv。（详见{{Harvard citation documentation}}）
  • |ref=harv：根据最多四个作者姓氏和年份创建锚点，格式为CITEREF姓氏年份，适用于{{harv}}、{{sfn}}等模板。例如：
{{cite book |first=Gary L. |last=Hardcastle |title=Monty Python and Philosophy |year=2006 |ref=harv}}
创建名为CITEREFHardcastle2006的锚点，可通过{{harv|Hardcastle|2006|pp=12-34}}链接。
{{cite book |first=Gary L. |last=Hardcastle |first2=George A. |last2=Reisch |title=Monty Python and Philosophy |year=2006 |ref=harv}}
创建名为CITEREFHardcastleReisch2006的锚点，可通过{{harv|Hardcastle|Reisch|2006|pp=12-34}}链接。
  • |ref=ID：创建由ID定义的自定义锚点。适用于中文作者，或作者和/或日期未知的情况。可使用{{harvid}}模板创建适用于{{harv}}、{{sfn}}等的锚点。例如：
ref={{harvid|Monty Python and Philosophy|2006}}
创建可通过{{harv|Monty Python and Philosophy|2006|pp=12-34}}链接的锚点。

显示选项

[编辑]

这些功能不常使用，但可以自定义显示样式以配合其他格式需求。

  • 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参数时本参数无效。

打印输出

[编辑]

当浏览页面时，CS1模板会将URL渲染为标题链接；但在打印时，URL会直接显示。外部链接图标不会被打印出来。

未包含元素

[编辑]

并非所有关于文献来源的准确信息都会包含在引文格式1的引用中。以下是不包含的信息示例：

  • 引用文献的总页数
  • 提供电子版文献访问权限的图书馆名称
  • 拥有实体文献副本的图书馆名称
  • 实体文献副本的图书馆记录或书架位置

工具

[编辑]
主页面：Help:參考文獻工具

生成CS1引文

[编辑]
  • 参考文献工具列（RefToolbar）是默认源代码编辑器的一部分。[1]它包含一个“模板”菜单，提供{{cite web}}、{{cite news}}、{{cite book}}和{{cite journal}}模板。使用参考文献工具列填写模板时，点击放大镜图标可自动填充模板参数。[2]
  • 可视化编辑器中的“引用”选项会根据URL或其他标识符尝试构建完整引文。[2]它会自动选择合适的引文模板。
  • ProveIt提供了可选的图形界面，用于编辑、添加和引用参考文献。[2]
  • reFill在更新/填充标题/日期/出版商/访问日期等时向模板添加参考文献。[3]
  • Zotero可以导出维基百科兼容格式的引文。
  • Citer - 为给定的谷歌图书URL、ISBN或DOI生成完整引文、简短引文。它还支持一些主要新闻网站。
生成和编辑通用CS1模板
模板 用途 RefToolbar ProveIt
{{Cite arXiv}} arXiv预印本
{{Cite AV media}} 音频和视频来源 支持
{{Cite AV media notes}} 专辑、DVD、CD等音像媒体的内页说明
{{Cite book}} 书籍 支持 支持
{{Cite conference}} 会议论文 支持 支持
{{Cite encyclopedia}} 百科全书 支持 支持
{{Cite episode}} 电视或广播节目及剧集 支持
{{Cite interview}} 访谈
{{Cite journal}} 期刊论文 支持 支持
{{Cite magazine}} 杂志和简报 支持
{{Cite mailing list}} 存档的公共邮件列表
{{Cite map}} 地图
{{Cite news}} 印刷版、视频、音频或网络版的新闻 支持 支持
{{Cite newsgroup}} 在线新闻组
{{Cite podcast}} 音频或视频播客
{{Cite press release}} 新闻稿 支持
{{Cite report}} 政府部门、机构、运营公司等的报告 支持
{{Cite serial}} 音频或视频连续剧
{{Cite sign}} 标志、牌匾和其他视觉来源 支持
{{Cite speech}} 演讲
{{Cite tech report}} 技术报告
{{Cite thesis}} 学位论文 支持
{{Cite web}} 其他模板未涵盖的网络来源 支持 支持

其他小工具

[编辑]

常见问题

[编辑]
快捷方式
|access-date=（访问日期）未显示
若未提供|url=参数，则|access-date=不会显示，此为设计特性
原始URL显示在标题前
若|title=字段包含换行符或无效字符，链接将格式错误，参见网页链接章节
标题显示为红色
若提供了URL，则标题不能添加内部链接
URL未生成链接且显示在方括号中
URL必须包含URI方案（如http://）才能被MediaWiki识别为链接。例如：www.example.org/应写为http://www.example.org/
字段内容被截断
字段值中的竖线符号（|）会导致截断，应改用{{!}}模板
模板代码直接显示
字段中使用了双开括号“[[”但未闭合双括号“]]”
作者名显示为带外部链接图标的方括号
|author-link=参数误用了URL链接，此参数应填写作者维基百科条目名而非网站地址
定义了多位作者/编者但部分未显示
参数必须按顺序使用，例如若未定义|last=或|last1=，则|last2=不会显示，此为设计特性
|page=、|pages=或|at=未显示
这些参数互斥，仅会显示其中一个，此为设计特性

参见

[编辑]

注释

[编辑]
  1. ^ “源代码编辑”WikiEditor包含refToolbar 2.0，是默认编辑器。
  2. ^ 2.0 2.1 2.2 自动填充由Citoid服务处理，该服务可根据URL、DOI、ISBN、PMID、PMCID或QID自动填充模板参数。
  3. ^ 这是旧版Reflinks工具的开源版本。
检索自“https://zh.wikipedia.org/w/index.php?title=Help:引文格式1&oldid=87501502”