模板:Cite report/doc
![]() | 此页面是Template:Cite report的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
![]() | 此模板使用Lua语言: |
{{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模板用于为reports by government departments, instrumentalities, operated companies, etc.创建引文。
- These reports are to be published in the Wikipedia sense of verifiability: a responsible organisation must have fact checked them; and the selection process for publication must not have been automatic.
- Examples include: government printed reports which lack ISSN or ISBN numbers, and reports from major semi-governmental instrumentalities that are freely circulating and available for verification, but which lack a formal ISBN / ISSN publication process.
Usage
[编辑]复制以下其中一个空白的版本来使用。几乎所有参数名称仅支持小写形式(部分缩写如|isbn=
有对应的大写别名如|ISBN=
,这些大写形式也可使用)。每个参数之间使用“|”(管道)字符分隔。未使用的参数可以删除,以避免编辑窗口杂乱。本文档页中的部分示例可能包含当前日期。若日期显示不准确,请刷新页面。
|
Template:Citation Style documentation/usage vertical
{{cite report | author = <!-- or |last= and |first= --> | author-link = | authors = | date = <!-- or |year= --> | title = | url = | publisher = | format = | others = | edition = | location = | chapter = | section = | page = | pages = | docket = | access-date = | quote = }}
Template:Citation Style documentation/usage vertical mid
Template:Citation Style documentation/usage vertical mid
Template:Citation Style documentation/usage vertical end
Example
[编辑]{{cite report |title=Rhode Island Roads |publisher=Rhode Island Department of Public Works |date=1956}}
- Rhode Island Roads (报告). Rhode Island Department of Public Works. 1956.
Parameters
[编辑]Syntax
[编辑]嵌套参数依赖于其母参数:
- 母参数
- 或者:母参数2—可以代替母参数使用
- 子参数—可以与母参数一同使用(若母参数填写,此参数将被忽略)
- 或者:子参数2—可以代替子参数使用(若母参数2填写,此参数将被忽略)
- 在列出别名(aliases)的地方,只能定义一个参数;如果定义了多个别名参数(aliased parameters),那么只有一个会被显示。
默认情况下,字段组以句号(.)作为终止符。
COinS
[编辑]该模板在HTML输出中嵌入了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
Deprecated
[编辑]过时参数 | 替换参数 |
---|---|
|coauthor= |coauthors= |
|
Description
[编辑]Authors
[编辑]- 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,但反之不成立)。 。别名: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绘制”。
Date
[编辑]- date:引用来源的发布日期。可以是完整日期(日、月、年)或部分日期(月和年、季节和年或仅年份)。格式需与文中其他引用保持一致。[date 1]请勿添加内部链接。显示在网站和出版商之后。
- 简短脚注通过此参数指定的年份定位完整引用。当年份格式非YYYY-MM-DD时,可在年份后添加小写字母以区分
{{sfn}}
链接中同作者同年的不同作品[详情]。 - 网页、PDF等无可见日期的来源,可通过查看页面源代码或文档代码中的
created
/updated
日期确定;可添加编辑注释如date=2021-12-25<!--页面代码日期--> |orig-date=原始日期2011-01-01
。
- year:出版年份。更灵活的
|date=
参数也可单独处理年份。除非满足以下两个条件,否则不要与|date=
参数同时使用: - orig-date:原始发布日期或年份;显示在date(或year)后的方括号内。为明确起见,请提供具体说明,例如:
|orig-date=首版于1859
或|orig-date=创作于1904
。由于|orig-date=
不支持自动日期格式化,请使用与|date=
参数一致的格式。别名:orig-year
- ^ 同一文章中所有引用的出版日期格式应保持一致,该格式可能与存档/访问日期的格式不同。
Editors
[编辑]- 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
[编辑]
- 标题:来源标题。可添加内部链接至现有条目或使用url添加外部链接,但二者不可同时使用。无格式显示,不加引号。
- script-title:非拉丁文字标题(日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等)。必须前缀支持的语言代码以确保浏览器正确显示:
... |script-title=ja:東京タワー |trans-title=东京塔 ...
- trans-title:外文来源标题的中文翻译。显示在标题后的方括号内。建议配合language参数使用。
- script-title:非拉丁文字标题(日文、韩文、阿拉伯文、西里尔文、希腊文、希伯来文等)。必须前缀支持的语言代码以确保浏览器正确显示:
- 含特殊字符的标题需经编码才能正确显示和链接:
换行符 | [ | ] | | |
---|---|---|---|
空格 | [ | ] | {{!}} (推荐)
|
{{bracket|文本}} | | 或 {{pipe}} – |
- title-link:title所指来源的维基百科条目标题——不要使用网址;请勿添加内部链接。
- language:来源使用的语言(可接受逗号分隔的多语言列表),推荐使用ISO 639语言代码或完整语言名称。例如:
|language=ru
;|lang=fr, pt-br
。请勿使用模板或内部链接。显示在括号内。使用被引文模块识别的语言会将页面归入Category:CS1外文来源相应子分类。别名:in
URL
[编辑]- url:可获取title指定出版物文本的在线地址。若title已添加内部链接则不可使用。如适用,链接可指向具体引用页。需移除URL中的跟踪参数(如
#ixzz2rBr3aO94
或?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...
)。 。请勿链接至商业售书网站(如亚马逊),应使用|isbn=
或|oclc=
提供中立图书检索链接。含空格等无效URL将触发错误提示。- access-date:最后验证url内容支撑文中论述的完整日期;需配合url使用;格式需与其他访问/存档日期一致[date 1]。不适用于内容不变的链接文档。例如:无出版日期的个人网站等在线资源必须提供访问日期(参见WP:CITEWEB),但已发表论文或书籍的链接无需提供。注意此日期仅表示验证网址有效且支撑引文内容的日期。注册用户可隐藏或自定义样式。别名:accessdate。
- archive-url:网页存档快照的URL。通常指向互联网档案馆 或archive.today 等服务;需配合archive-date和url使用。默认(可被
|url-status=live
覆盖)优先显示存档链接,原始链接置于末尾。别名:archiveurl。- archive-date:存档服务快照日期;默认前缀“存档于原页面”。格式需与其他访问/存档日期一致[date 1]。请勿添加内部链接;不建议使用模板日期。别名: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:URLREQusurped
- 选择|archive-url=
;用于域名被劫持转向不良内容时,将隐藏原网址链接bot: unknown
- 机器人无法判定网址状态时遗留的值,页面会自动归入Category:CS1 maint: bot: original URL status unknown,编者需手动评估并修正参数值
- 接受多组关键词:
- archive-format:archive-url指向文件的格式(如DOC/XLS),显示在存档链接后的括号内。HTML为默认格式无需指定,PDF会自动检测无需指定。不影响外部链接图标(PDF除外)。注意:链接图标不含替代文本,故无法为视障用户提供格式信息(PDF因自动添加“(PDF)”描述文本而无此问题)。
- url-access:
- format:url指向文件的格式(如DOC/XLS),显示在标题后的括号内。(媒体格式请用type参数。)HTML为默认格式无需指定,PDF会自动检测无需指定。不影响外部链接图标(PDF除外)。注意事项同archive-format。
URL必须以支持的URI方案开头。所有浏览器均支持http://
和https://
;而ftp://
、gopher://
、irc://
、ircs://
、mailto:
和news:
可能需要插件或外部应用支持,通常应避免使用。当前不支持IPv6主机名。
若引文模板参数中的URL包含特定字符,将无法正确显示和链接。这些字符需进行百分号编码。例如空格必须替换为%20
。编码替换规则如下:
字符 | 空格 | " | ' | < | > | [ | ] | { | | | } |
---|---|---|---|---|---|---|---|---|---|---|
编码 | %20 | %22 | %27 | %3C | %3E | %5B | %5D | %7B | %7C | %7D |
单引号无需编码,但未编码的多个引号会被解析为斜体/粗体标记。单个右花括号无需编码,但未编码的成对花括号会被解析为模板嵌入的结束符。
Periodical
[编辑]- 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后。 - department:期刊或杂志中的常规栏目名称。例如“通讯”、“社论”、“读者来信”和“评论”。显示在title之后,以纯文本形式呈现。
当设置work时,将改变同一引用中其他参数的格式:
- chapter不显示(并会生成错误提示)
Publisher
[编辑]- publisher:出版商名称;可添加对应的内部链接[1]。出版商是指出版被引用作品的公司、组织或其他法律实体。请勿将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);或分发方要求署名时。
Edition, series, volume
[编辑]- edition:当出版物存在多个版本时使用,例如:“第二版”、“修订版”等。若已定义期刊类字段则不显示。
- series或version:当来源属于重新编号的系列出版物时使用(如丛书或期刊)。
- volume:多卷出版物的卷次信息。显示在title和series之后;纯数字输入(如“37”)。纯数字、全大写罗马数字或少于5个字符的卷号会加粗显示,5个及以上字符的字母数字组合不加粗。极少数出版物同时标注连续卷号和年度卷号时需一并提供,例如|volume=IV/#10。
In-source locations
[编辑]- page:来源中支撑内容的具体单页页码。使用
|page=
或|pages=
二者之一。别名:p。 - 或:pages:来源中支撑内容的页码范围。使用
|page=
或|pages=
二者之一。用短横线(–)分隔连续页码,用逗号(,)分隔非连续页码;不可用于表示来源总页数。
别名:pp。 - 或:at:用于页码不适用或不充分的情况。会被
|page=
或|pages=
覆盖。|page=
、|pages=
和|at=
三者仅能使用其一。
示例:页(p.)或页数(pp.);节(sec.)、栏(col.)、段(para.);音轨;时分秒;幕、场、篇章、书、部分、对开页、诗节、封底、唱片内页、版权页、书籍末页、护封、诗句。 - 与
|quote=
配合使用的|quote-page=
和|quote-pages=
参数说明参见此处。
Identifiers
[编辑]- id:唯一标识符,在无专用标识符时使用;可添加内部链接或使用外部链接模板。例如
|id=NCJ 122967
将在引文末尾添加“NCJ 122967”。也可使用模板如|id={{NCJ|122967}}
来显示美国犯罪司法参考服务数据库 122967。 - docket: Docket number.
以下标识符会生成链接,且仅接受单一数值。使用多个数值或其他文本会破坏链接和/或使标识符失效。通常参数只需包含标识符的可变部分,例如|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
。 连字符可选但建议保留。请使用书籍印刷的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。
- 可使用{{Format 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”。 。别名:pmc。- embargo:PMC开放日期;若该日期在未来,则在此之前不会生成链接。别名:none。
- PMID:PubMed唯一标识符;示例
|pmid=17322060
。别名: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=
)可用于提供直接文档链接或便捷访问链接。
Subscription or registration required
[编辑]为方便读者和其他编者,编者应在引用的外部链接中标注材料获取限制级别。这些级别描述获取材料的条件限制,不涉及材料版权状态或重用权限(因其与可供查证无关)。
可使用四种访问级别:
- 命名标识符访问指示:
free
:所有人可免费阅读
- URL参数访问指示:
registration
:需在提供方免费注册才能访问(即使可能有无需注册的有限预览/摘要)limited
:有限度免费查阅,超限则需付费订阅subscription
:仅限付费订阅用户访问(“付费墙”)
URL参数访问指示
[编辑]|url=
、|article-url=
等URL参数默认指向免费访问内容。若非免费访问,需用对应访问指示参数添加图标。因默认免费访问,故无需标记free
。若注册/订阅内容失效,应移除访问指示并添加|archive-url=
和|archive-date=
。
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。
Lay summary
[编辑]
- laysummary:指向非技术性摘要或来源评论的URL链接;链接标题设为“通俗摘要”。
- laysource:laysummary的来源名称。前面带有破折号。
- laydate:摘要的日期。
Quote
[编辑]- quote:从来源引用的相关文本。显示为引号内文本。需包含终止标点(默认情况下引文会抑制引文终止符句号)。
- script-quote:非拉丁文字引文(阿拉伯文、西里尔文等)。必须前缀支持的语言代码以确保浏览器正确显示:
... |script-quote=ja:東京タワー |trans-quote=东京塔 ...
- trans-quote:外文引文的中文翻译。显示在方括号内。
- script-quote:非拉丁文字引文(阿拉伯文、西里尔文等)。必须前缀支持的语言代码以确保浏览器正确显示:
- quote-page:
|quote=
所引用的单页页码。使用|quote-page=
或|quote-pages=
二者之一。应为|page=
、|pages=
或|at=
指定页面的子集。 - 或:quote-pages:
|quote=
引用的页面列表或范围。使用|quote-page=
或|quote-pages=
二者之一。应为|pages=
或|at=
指定页面的子集。用短横线(–)分隔连续页码,用逗号(,)分隔非连续页码。
Anchor
[编辑]- ref:设置引用的HTML锚点标识符。默认不生成锚点。设置
|ref=ID
会生成指定ID
的锚点(对应<cite id="ID">
标签的id
属性)。此参数允许通过内部链接定位完整引用,这对简短脚注和括号引用特别有用。特殊值|ref=harv
会生成兼容{{harv}}模板的锚点格式。
Display options
[编辑]- 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=
)对特定姓名应用掩码。
- 用破折号或文本替换(首位)作者姓名。设为数字n时显示n倍宽破折号;设为文本时直接显示该文本(不带后续分隔符,如“with”)。特殊值0需配合<name>-link使用,此时显示链接文本。无论何种情况,仍需提供完整姓名以生成元数据。主要用于同一作者多部作品连续列出的参考文献(如Template:Sfnote)。不可在
- 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参数时本参数无效。
此模板生成COinS元数据;背景信息请参阅维基百科:COinS。
TemplateData
[编辑]This template formats a citation to an article in a magazine or journal, using the provided source information (e.g. journal name, author, title, issue, URL) and various formatting options.
参数 | 描述 | 类型 | 状态 | |
---|---|---|---|---|
URL | url URL | The URL of the online location where the text of the publication can be found | 单行文本 | 推荐 |
Title | title | The title of the article; can be wikilinked to an existing Wikipedia article or url may be used to add an external link, but not both. Displays in quotes. | 内容 | 必需 |
Last name | last author author1 authors last1 | The surname of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors | 单行文本 | 推荐 |
First name | first first1 | Given or first name, middle names, or initials of the author; don't wikilink, use 'authorlink'; can suffix with a numeral to add additional authors | 单行文本 | 推荐 |
Last name 2 | last2 author2 | The surname of the second author; don't wikilink, use 'authorlink2'. | 单行文本 | 可选 |
First name 2 | first2 | Given or first name, middle names, or initials of the second author; don't wikilink. | 单行文本 | 可选 |
Source date | date | Full date of the source; do not wikilink | 日期 | 必需 |
Publisher | publisher | Name of the publisher; displays after title | 内容 | 可选 |
Issue | issue | Issue identifier when the source is part of a series that is published periodically | 单行文本 | 推荐 |
DOI | doi | Digital Object Identifier; begins with '10.' | 字符串 | 推荐 |
DOI broken date | doi-broken-date | The date that the DOI was determined to be broken | 日期 | 可选 |
Location of publication | location | Geographical place of publication; usually not wikilinked. | 字符串 | 可选 |
Publication date | publication-date | Date of publication when different from the date the work was written; do not wikilink | 日期 | 可选 |
Edition | edition | When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed with ' ed.' | 单行文本 | 可选 |
Volume | volume | For one publication published in several volumes | 单行文本 | 推荐 |
Page | page | Page in the source that supports the content; displays after 'p.' | 单行文本 | 可选 |
Pages | pages | Pages in the source that support the content (not an indication of the number of pages in the source; displays after 'pp.' | 单行文本 | 可选 |
Language | language | The language in which the source is written, if not English; use the full language name; do not use icons or templates | 内容 | 可选 |
arXiv identifier | arxiv | An identifier for arXive electronic preprints of scientific papers | 单行文本 | 可选 |
ASIN | asin | Amazon Standard Identification Number; 10 characters | 单行文本 | 可选 |
ASIN TLD | asin-tld | ASIN top-level domain for Amazon sites other than the US | 单行文本 | 可选 |
Bibcode | bibcode | Bibliographic Reference Code (REFCODE); 19 characters | 单行文本 | 可选 |
biorXiv | biorxiv | biorXiv identifier; 6 digits | 单行文本 | 可选 |
CiteSeerX | citeseerx | CiteSeerX identifier; found after the 'doi=' query parameter | 单行文本 | 可选 |
ISBN | isbn | International Standard Book Number; use the 13-digit ISBN where possible | 单行文本 | 可选 |
ISSN | issn | International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen | 单行文本 | 可选 |
jfm code | jfm | Jahrbuch über die Fortschritte der Mathematik classification code | 单行文本 | 可选 |
JSTOR | jstor | JSTOR identifier | 单行文本 | 可选 |
LCCN | lccn | Library of Congress Control Number | 单行文本 | 可选 |
MR | mr | Mathematical Reviews identifier | 单行文本 | 可选 |
OCLC | oclc | Online Computer Library Center number | 数字 | 可选 |
OL | ol | Open Library identifier | 单行文本 | 可选 |
OSTI | osti | Office of Scientific and Technical Information identifier | 单行文本 | 可选 |
PMC | pmc | PubMed Center article number | 数字 | 可选 |
PMID | pmid | PubMed Unique Identifier | 单行文本 | 推荐 |
id | id | A unique identifier used where none of the specialized ones are applicable | 单行文本 | 可选 |
docket | docket | Docket number | 单行文本 | 可选 |
Quote | quote | Relevant text quoted from the source; displays last, enclosed in quotes; needs to include terminating punctuation | 内容 | 可选 |
Last name 3 | last3 author3 | The surname of the third author; don't wikilink, use 'authorlink3'. | 单行文本 | 可选 |
First name 3 | first3 | Given or first name, middle names, or initials of the third author; don't wikilink. | 单行文本 | 可选 |
Last name 4 | last4 author4 | The surname of the forth author; don't wikilink, use 'authorlink4'. | 单行文本 | 可选 |
First name 4 | first4 | Given or first name, middle names, or initials of the forth author; don't wikilink. | 单行文本 | 可选 |
Last name 5 | last5 author5 | The surname of the fifth author; don't wikilink, use 'authorlink5'. | 单行文本 | 可选 |
First name 5 | first5 | Given or first name, middle names, or initials of the fifth author; don't wikilink. | 单行文本 | 可选 |
Last name 6 | last6 author6 | The surname of the sixth author; don't wikilink, use 'authorlink6'. | 单行文本 | 可选 |
First name 6 | first6 | Given or first name, middle names, or initials of the sixth author; don't wikilink. | 单行文本 | 可选 |
Last name 7 | last7 author7 | The surname of the seventh author; don't wikilink, use 'authorlink7'. | 单行文本 | 可选 |
First name 7 | first7 | Given or first name, middle names, or initials of the seventh author; don't wikilink. | 单行文本 | 可选 |
Last name 8 | last8 author8 | The surname of the eighth author; don't wikilink, use 'authorlink8'. | 单行文本 | 可选 |
First name 8 | first8 | Given or first name, middle names, or initials of the eighth author; don't wikilink. | 单行文本 | 可选 |
Last name 9 | last9 author9 | The surname of the ninth author; don't wikilink, use 'authorlink9'. If nine authors are defined, then only eight will show and 'et al.' will show in place of the last author. | 单行文本 | 可选 |
First name 9 | first9 | Given or first name, middle names, or initials of the ninth author; don't wikilink. | 单行文本 | 可选 |
Author link | author-link authorlink | Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors | 页面名称 | 可选 |
Author link 2 | author-link2 author2-link authorlink2 | Title of existing Wikipedia article about the second author. | 页面名称 | 可选 |
URL access date | access-date accessdate | The full date when the original URL was accessed; do not wikilink | 日期 | 推荐 |
Archive URL | archive-url archiveurl | The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archivedate' | 单行文本 | 可选 |
Archive date | archive-date | Date the url in the field 'archive-url' was archived.
| 日期 | 可选 |
Author link 3 | author-link3 author3-link authorlink3 | Title of existing Wikipedia article about the third author. | 页面名称 | 可选 |
Author link 4 | author-link4 author4-link authorlink4 | Title of existing Wikipedia article about the forth author. | 页面名称 | 可选 |
Author link 5 | author-link5 author5-link authorlink5 | Title of existing Wikipedia article about the sixth author. | 页面名称 | 可选 |
Author link 6 | author-link6 author6-link authorlink6 | Title of existing Wikipedia article about the sixth author. | 页面名称 | 可选 |
Author link 7 | author-link7 author7-link authorlink7 | Title of existing Wikipedia article about the seventh author. | 页面名称 | 可选 |
Author link 8 | author-link8 author8-link authorlink8 | Title of existing Wikipedia article about the eighth author. | 页面名称 | 可选 |
Author link 9 | author-link9 author9-link authorlink9 | Title of existing Wikipedia article about the ninth author. | 页面名称 | 可选 |
Format | format | Format of the work referred to by 'url' ('url' is required when using 'format'); examples: PDF, DOC, XLS; do not specify HTML | 内容 | 可选 |
URL access level | url-access | Classification of the access restrictions on the URL ('registration', 'subscription' or 'limited') | 字符串 | 可选 |
Bibcode access level | bibcode-access | If the full text is available from ADS via this Bibcode, type 'free'. | 字符串 | 可选 |
DOI access level | doi-access | If the full text is free to read via the DOI, type 'free'. | 字符串 | 可选 |
HDL access level | hdl-access | If the full text is free to read via the HDL, type 'free'. | 字符串 | 可选 |
Jstor access level | jstor-access | If the full text is free to read on Jstor, type 'free'. | 字符串 | 可选 |
OpenLibrary access level | ol-access | If the full text is free to read on OpenLibrary, type 'free'. | 字符串 | 可选 |
HDL access level | osti-access | If the full text is free to read on OSTI, type 'free'. | 字符串 | 可选 |
- ^ 管道符技巧在参考文献内无效,请务必使用完整内部链接。