Help:引文格式1错误

本页面是中文维基百科上的一份操作指南。

该页面介绍的是由引文格式1（CS1）报告的错误信息，包括其含义及编者该如何解决这些错误。

2013年前，引文格式1模板使用的一直是元模板{{Citation/core}}。2013年，作为en:WP:Lua项目的一部分，编者使用单一Lua模块升级了引文格式1的系列模板。Module:Citation/CS1是控制着引文格式1如何显示及通过en:COinS元数据如何将引用数据传递到外部参考文献工具的引擎。该升级可以提高性能，降低模板复杂性及冗余性。

显示控制错误信息[编辑]

随着引文引文格式1的发展，原先许多被隐藏的错误信息现在被显示了出来。编者想要看到所有引文格式1错误信息，可以通过更新其common或皮肤CSS包含以下内容实现：

.citation-comment {display: inline !important;} /* show all Citation Style 1 error messages */

某页面已存在于某个跟踪分类中，但维基百科的缓存仍未更新时，此时即使安装了这个CSS也无法显示这些错误信息。更新服务器缓存可以解决该问题。

编者若不想看到任何引文格式1错误信息，其也可以通过common或皮肤CSS包含以下内容实现：

.citation-comment {display: none;} /* hide all Citation Style 1 error messages */

使用|accessdate=需要含有|url=[编辑]

求助

使用|accessdate=需要含有|url=

含有该错误的页面会被自动归入Category:含有访问日期但无网址的引用的页面。^{[注 1]}

使用|archiveurl=需要含有|archivedate=[编辑]

求助

使用|archiveurl=需要含有|archivedate=

|archivedate=是用来标记网络来源存档日期的参数。

给|archivedate=赋值即可解决该问题。对于存档于archive.org的网络来源^[1]，其存档日期可以在|archiveurl=中找到；对于存档于webcitation.org的网络来源^[2]，其缓存日期包含于档头中。

含有该错误的页面会被自动归入Category:含有存档网址错误的引用的页面。^{[注 1]}

使用|archiveurl=需要含有|url=[编辑]

求助

使用|archiveurl=需要含有|url=

在正确的引文格式中，若使用|archiveurl=和|archivedate=则需要含有|url=。当引文包含|deadurl=no时，原网址将优先显示。

给|url=赋值即可解决该问题。对于存档于archive.org的网络来源^[1]，原网址可以在|archiveurl=中找到；对于存档于webcitation.org的网络来源^[2]，原网址包含于档头中。

含有该错误的页面会被自动归入Category:含有存档网址错误的引用的页面。^{[注 1]}

请检查|doi=值[编辑]

求助

请检查|doi=值

当引文格式1模板包含|doi=时，其会检测DOI值的前缀是否包含了适当的“10.”注册识别码。此外不进行进一步的验证。

确保|doi=值的正确即可解决该问题。

含有该错误的页面会被自动归入Category:含有DOI错误的引用的页面.^{[注 1]}

请检查|isbn=值[编辑]

求助

请检查|isbn=值

当引文格式1模板包含|isbn=时，其会检测ISBN值是否为恰当的长度（10位或13位），并根据ISBN规范校验末尾的校验码。因为整个|isbn=值包含于COinS 元数据的引用中，所以在字段中只允许存在一个ISBN值。参见en:Wikipedia:COinS。当ISBN值超过一个或值内含有非ISBN字符时，其会损坏COinS元数据，并也会损坏Special:BookSources的链接。

确保|isbn=值的正确，保证只有存在一个ISBN，并不包含其他字符，即可解决该问题。

在非常罕见的情况下，出版者会发布格式错误的ISBN。若您确定该错误的ISBN真正能够对应一个出版物，则可以在引文中加入|ignore-isbn-error=true参数忽略错误消息。在大多数情况下，出版者会补发一个正确的ISBN，所以若可能，则应该使用正确的ISBN。

含有该错误的页面会被自动归入Category:含有ISBN错误的引用的页面.^{[注 1]}

请检查|ol=值[编辑]

求助

请检查|ol=值

|ol=为开发图书馆识别码的参数。其会验证最后一个字符是否为A（作者）、M（书名）或W（作品名）。此外不进行进一步的验证。

确保|ol=值的正确即可解决该问题。

含有该错误的页面会被自动归入Category:含有OL错误的引用的页面.^{[注 1]}

请检查|url=格式[编辑]

求助

请检查|url=格式

其会对网址字段进行检查，以确保其包含一个半角冒号（:）或一个双斜杠（//）。此外不进行进一步的验证。

确保|url=值的正确即可解决该问题。

含有该错误的页面会被自动归入Category:含有网址格式错误的引用的页面.^{[注 1]}

建议使用|displayauthors=[编辑]

求助

建议使用|displayauthors=

在引入Lua之前，引文格式1模板是不支持超过9个作者名。如果指定了9个（或更多）作者名，则模板只会显示8个作者名并在之后加入“et al.”来表示该列表已被截断。部分编者使用这样的方法来制作“et al.”（或“等.”）标签。例如：

{{ cite book \| last12=Twelfth \| last6=Sixth \| last10=Tenth \| last3=Third \| last2=Second \| last11=Eleventh \| last7=Seventh \| title=Twelve Little Authors \| last4=Fourth \| last9=Ninth \| last8=Eighth \| last5=Fifth \| last=First }}
旧式	First; Second; Third; Fourth; Fifth; Sixth; Seventh; Eighth 等.. Twelve Little Authors.
Lua式	First; Second; Third; Fourth; Fifth; Sixth; Seventh; Eighth; Ninth; Tenth; Eleventh; Twelfth. Twelve Little Authors.

基于Lua的引用模板可以容纳任意数量的作者名参数。与旧的模板相比，基于Lua的引用模板可以使用|displayauthors=明确指定“et al.”标签出现的位置。

{{ cite book \| last12=Twelfth \| last6=Sixth \| last10=Tenth \| displayauthors=3 \| last3=Third \| last2=Second \| last11=Eleventh \| last7=Seventh \| title=Twelve Little Authors \| last4=Fourth \| last9=Ninth \| last8=Eighth \| last5=Fifth \| last=First }}
旧式	First; Second; Third; Fourth; Fifth; Sixth; Seventh; Eighth 等.. Twelve Little Authors.
Lua式	First; Second; Third et al. Twelve Little Authors.

旧式的模板最多只支持9个作者名。为了保持旧模板的引用模式，基于Lua的引用模板仍会在第9个作者名后显示“et al.”标签。但如果编者创建的作者名恰好为9个时，新的Lua模板并不能知晓，仍会“et al.”标签。所以这时就会显示错误信息以报告该引用恰有9个作者名，但缺少|displayauthors=。

添加剩余的作者名，或设置|displayauthors=至第8个或更低的作者名。如果恰好只有9个作者名，可以设置|displayauthors=至第9个作者名，则此时将不会出现“et al.”标签。

含有该错误的页面会被自动归入Category:含有旧式缩略标签的引用的页面^{[注 1]}

建议使用|displayeditors=[编辑]

求助

建议使用|displayeditors=

在引入Lua之前，引文格式1模板是不支持超过4个编者名。如果指定了4个（或更多）作者名，则模板只会显示3个编者名并在之后加入“et al.”来表示该列表已被截断。部分编者使用这样的方法来制作“et al.”（或“等.”）标签。例如：

{{ cite book \| last=Milquetoast \| editor-last=First \| first=Caspar \| title=If You Won't Think it Presumptuous of Me \| editor5-last=Fifth \| authorlink=Caspar Milquetoast \| editor2-last=Second \| editor4-last=Fourth \| editor3-last=Third }}
旧式	Milquetoast, CasparFirst; Second; Third .. s. If You Won't Think it Presumptuous of Me.
Lua式	Milquetoast, Caspar. First; Second; Third; Fourth; Fifth, 编. If You Won't Think it Presumptuous of Me.

基于Lua的引用模板可以容纳任意数量的编者名参数。与旧的模板相比，基于Lua的引用模板可以使用|displayeditors=明确指定“et al.”标签出现的位置。

{{ cite book \| last=Milquetoast \| editor-last=First \| first=Caspar \| displayeditors=2 \| title=If You Won't Think it Presumptuous of Me \| editor5-last=Fifth \| authorlink=Caspar Milquetoast \| editor2-last=Second \| editor4-last=Fourth \| editor3-last=Third }}
旧式	Milquetoast, CasparFirst; Second; Third .. s. If You Won't Think it Presumptuous of Me.
Lua式	Milquetoast, Caspar. First; Second et al., 编. If You Won't Think it Presumptuous of Me.

旧式的模板最多只支持4个编者名。为了保持旧模板的引用模式，基于Lua的引用模板仍会在第4个编者名后显示“et al.”标签。但如果编者创建的编者名恰好为9个时，新的Lua模板并不能知晓，仍会“et al.”标签。所以这时就会显示错误信息以报告该引用恰有4个编者名，但缺少|displayeditors=。

添加剩余的编者名，或设置|displayeditors=至第3个或更低的作者名。如果恰好只有4个编者名，可以设置|displayeditors=至第4个编者名，则此时将不会出现“et al.”标签。

含有该错误的页面会被自动归入Category:含有旧式缩略标签的引用的页面^{[注 1]}

空引用[编辑]

求助

空引用

“空”意味着该引文格式1模板未包含可识别的参数标识符。例如有些引用虽然含有有用的信息：

{{cite web | http://www.foobar.com | The Foobar Bar}}

但仍为“空”，因为其未包含必要的参数标识符（如|url=和|title=）来告诉{{cite web}}如何使用这些信息。

添加适当的参数标识符即可解决该问题。编者也可以考虑用另一个模板替换，如{{fact}}或{{quote}}。

含有该错误的页面会被自动归入Category:含有空引用的页面.^{[注 1]}

|pages或|at多余[编辑]

求助

|pages或|at多余

移除不恰当的参数即可解决该问题。

含有该错误的页面会被自动归入Category:含有页码指定冲突的引用的页面‎.^{[注 1]}

使用|format=需要含有|url=[编辑]

求助

使用|format=需要含有|url=

删除|format=、赋值|url=或改用|type=即可解决该问题。

含有该错误的页面会被自动归入Category:含有网络文件格式但无网址的引用的页面.^{[注 1]}

缺少或|title=为空[编辑]

有两种略不同的错误条件会导致引文格式1模板出现缺乏标题。这两种情况均会报告错误信息。错误的原因决定解决方法的不同。

无标题的裸露网址[编辑]

求助

xxx缺少标题

当含有不能与相关联的标题匹配的网址参数时，所有基于Lua的引文格式1模板都会报告该错误。当因引文包含冲突的|titlelink=参数而导致|title=不能与|url=链接时，也会报告该错误。

网址参数及与之相关联的标题参数
网址参数	标题参数
`\|chapterurl=`	`\|chapter=`, `\|contribution=`, `\|entry=`, `\|article=`
`\|conferenceurl=`	`\|conference=`
`\|contributionurl=`	`\|chapter=`, `\|contribution=`, `\|entry=`, `\|article=`
`\|transcripturl=`	`\|transcript=`

因为裸露的网址有碍官感，且不能提供信息，所以编辑应该为每一个网址提供一个有意义的标题。在大多数情况下，可以通过使用|title=参数解决。

含有该错误的页面会被自动归入Category:含有裸露网址的引用的页面.^{[注 1]}

不存在任何形式的标题[编辑]

求助

缺少或|title=为空

当任何形式的标题参数留白或缺少时，引文格式1模板则报告该错误。根据引用的类型（如{{cite web}}、{{cite book}}、{{cite journal}}等），可能的标题参数包括|title=、|chapter=、|article=、|journal=、|booktitle=等。每一个引用中至少应该存在一个标题参数。

有些编者错误的将引文格式1模板当作{{sfn}}或{{harv}}模板作为脚注使用时则会出现这样的错误。当编者用{{citation}}来模拟{{citation needed}}时也会出现该错误。

给|title=赋值，或使用为脚注时将该模板改为脚注模板，即可解决该问题。

含有该错误的页面会被自动归入Category:含有缺少标题的引用的页面.^{[注 1]}

缺少或|url=为空[编辑]

求助

缺少或|url=为空

当使用{{cite web}}引文格式1模板而|url=留白或缺少时，则会报告该错误信息。|url=参数是必须的，这样才能将|title=链接至网络来源处。

给|url=赋值或改用一个更合适的引文格式1模板即可解决该问题。

含有该错误的页面会被自动归入Category:含有缺少网址的网站引用的页面‎.^{[注 1]}

|param1=、|param2=及|param3=只需其一[编辑]

求助

|param1=、|param2=及|param3=只需其一

当引文格式1模板内多个参数对应同一意义时，则会报告该错误。如当|author=、|last=及|last1=均对应同一个名称时，在一个引用只需使用其中一个参数即可。

删除或修改冗余的参数即可解决该问题。

含有该错误的页面会被自动归入Category:含有冗余参数的引用的页面.^{[注 1]}

已忽略文本“xxx”[编辑]

求助

已忽略文本“xxx”

与其他模板不同的是引文格式1模板不使用未命名或位置参数。当引用竖线（|）之间的文本不包含等号（=）时，CS1则会忽略该文本并报错。即是文本为一个有效参数的名称也如此。

当网址或标题中存在竖线时也会出现该错误。当在网址中需要使用竖线时可以用%7c等价替换。而当在非网址处要使用竖线时则可以使用|等价替换。

删除多余的文本，加入“=”，加入适当的参数名称以完成参数，或使用正确的形式编码网址及标题即可解决该问题。

含有该错误的页面会被自动归入Category:含有未命名参数的引用的页面.^{[注 1]}

使用|trans-chapter=需要含有|chapter=[编辑]

求助

使用|trans-chapter=需要含有|chapter=

当引文格式1模板含有翻译而来的章节标题|trans-chapter=但不含其原语言的章节标题|chapter=时，则会报告该错误。

给|chapter=赋值即可解决该问题。也可以考虑加入|language=。

含有该错误的页面会被自动归入Category:含有不带原名的译名的引用的页面.^{[注 1]}

使用|trans-title=需要含有|title=[编辑]

求助

使用|trans-title=需要含有|title=

当引文格式1模板含有翻译而来的标题|trans-title=但不含其原语言的标题|title=时，则会报告该错误。

给|title=赋值即可解决该问题。也可以考虑加入|language=。

含有该错误的页面会被自动归入Category:含有不带原名的译名的引用的页面.^{[注 1]}

已忽略未知参数|xxx=[编辑]

求助

已忽略未知参数xxx=

当引文格式1模板含有的参数|名称=值名称部分无法被识别为一个有效的名称时，则会报告该错误。通常情况下，该错误是由于拼写错误造成的。

在旧式模板中，模板内无法识别的参数的信息会被简单的忽略掉。但基于Lua的引文格式1引擎不会忽略未知的参数。其目的是为了让编者正确的使用该模板，而不是将其用作为注释或辅助资料库。

确保各参数名称的拼写正确，并确保参数名称、竖线（|）及等号（=）之间除了空格外不存在其他字符。有效参数列表了查询Help:引文格式1，或参见各特定模板的描述页，如{{cite web}}、{{cite book}}、{{cite journal}}等。也可以考虑将未知参数的信息移动至适当的参数内或页面的讨论页内。

对于常见的拼写错误，可以考虑将其列入常见参数名称拼写错误列表中。

含有该错误的页面会被自动归入Category:含有未知参数的引用的页面.^{[注 1]}

已忽略未知参数|xxx=（建议使用|yyy=）[编辑]

求助

已忽略未知参数|xxxx=（建议使用|yyyy=）

CS1引用引擎会从有效参数列表或常见参数名称拼写错误列表中提供建议的参数名称。参考建议的参数名称，更正错误的参数名称，即可解决该问题。

含有该错误的页面会被自动归入Category:含有未知参数的引用的页面.^{[注 1]}

在网址标题中嵌入维基链接[编辑]

此错误已被暂时禁用，直到现有的类似| title = {{lang|ja| TEXT }}的用法获得适当的解决方案。

求助

在网址标题中嵌入维基链接

可使用的链接参数包括网址参数|url=、|chapterurl=等，及标题参数|title=、|chapter=等。当网址参数为空时，标题参数中可以使用维基内链将其与其他页面链接。当存在网址参数而标题参数中又存在维基内链时，维基内链则被忽略而呈现网址参数中的外部链接。

部分模板如果作为标题参数的一部分，当该模板可输出维基内链时则会导致出现该错误。例如{{lang}}模板。在网址参数中的模板也可能破坏引用的COinS元数据。所以一般情况下，应避免在标题参数中使用模板，除非可以确定该模板完全不会影响引用的显示。

该错误也可能出现于基于标识符的模板（如{{cite doi}}等）。当出现该错误时，错误信息会显示于文章中，但实际该错误存在于基于标识符的模板。

若要解决该问题，可删除标题参数中的维基内链，或删除网址参数中的外部链接。如果可输入维基内链的模板是不可缺少的，那么可将其移出引文格式1模板，而将其置于引文<ref>……</ref>标记内。部分由其他模板提供的功能也可以通过引文格式1模板参数实现。

若要解决基于标识符的模板的错误，则该模板必须进行修正。基于标识符的模板通常广泛使用，所以在编辑时务必审慎行事。

含有该错误的页面会被自动归入Category:含有将维基内链嵌入网址标题的引用的页面.^{[注 1]}

注释[编辑]

^ ^1.00 ^1.01 ^1.02 ^1.03 ^1.04 ^1.05 ^1.06 ^1.07 ^1.08 ^1.09 ^1.10 ^1.11 ^1.12 ^1.13 ^1.14 ^1.15 ^1.16 ^1.17 ^1.18 ^1.19 ^1.20 ^1.21 用户页、用户讨论页、维基百科讨论页名字空间不包含在错误追踪分类中。

参考文献[编辑]

^ ^1.0 ^1.1 archive.org website.
^ ^2.0 ^2.1 webcitation.org website.

[categories-1] 1.00 ^1.01 ^1.02 ^1.03 ^1.04 ^1.05 ^1.06 ^1.07 ^1.08 ^1.09 ^1.10 ^1.11 ^1.12 ^1.13 ^1.14 ^1.15 ^1.16 ^1.17 ^1.18 ^1.19 ^1.20 ^1.21 用户页、用户讨论页、维基百科讨论页名字空间不包含在错误追踪分类中。

[archive.org-2] 1.0 ^1.1 archive.org website.

[webcitation.org-3] 2.0 ^2.1 webcitation.org website.

[注 1]

[1]

[2]

网址参数	标题参数
`\|chapterurl=`	`\|chapter=`, `\|contribution=`, `\|entry=`, `\|article=`
`\|conferenceurl=`	`\|conference=`
`\|contributionurl=`	`\|chapter=`, `\|contribution=`, `\|entry=`, `\|article=`
`\|transcripturl=`	`\|transcript=`