帮助:引用

This page is a translated version of the page Help:Cite and the translation is 99% complete.
Outdated translations are marked like this.

引用可以让你在一个页面中加入脚注。

技术细节请见Cite extension 页面。

用法

‎<ref>标签的基本概念是,插入由ref标签包含的文本,并作为用‎<references />标签指定的脚注部分,此格式不能与旧格式互换使用——您必须选择其中一种。

可以在文中插入多个占位符标签‎<references />,到那个点的所有‎<ref>在那个组内都会插入到这里。

如果你忘记在文章中包含一个‎<references />,那么脚注不会显示,但是参考仍会在页面结尾显示。

该页面本身使用脚注,例如这句话末尾的脚注。[note 1] 如果你点击“编辑此页面”以查看本页面源代码,你可以看到脚注的一个生效示例。

维基文本 渲染
太阳很大。<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> 然而月亮不大。<ref>R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>

==註釋==
<references />

太阳很大。[1] 然而月亮不大。[2]

註釋
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

同一脚注的多种用法

如要给脚注一个单独的标识符,使用‎<ref name="name">。 你可以使用带有这个名称的ref标签来复用相同的脚注。 第二个标签内的文本不起作用,因为文本已存在与第一个引用中。 你可以复制整个脚注,或者直接使用自我闭合的标签:‎<ref name="name" />

在下面的例子中,相同的来源引用了三次。

维基文本 结果
这是多个参考使用一个脚注的例子。<ref name="multiple">记住当你多次引用相同的脚注时,会使用第一个引用中的文本。</ref>

有多个语句来自相同来源时,这样引用来源会十分有用。<ref name="multiple" /> 任何复用标签都不应该包含额外文本,否则会产生错误。 仅使用空标签。

进行多次引用的简洁方法是使用空的ref标签,在末尾加上斜杠。
尽管这样子减少繁杂工作,但是请注意,如果以后有个编辑者移除了第一个引用,后面使用空的ref标签的引用都会丢失。<ref name="multiple" />

== 註釋 ==
<references />

这是多个参考使用一个脚注的例子。[1]

有多个语句来自相同来源时,这样引用来源会十分有用。[1] 任何复用标签都不应该包含额外文本,否则会产生错误。 仅使用空标签。

进行多次引用的简洁方法是使用空的ref标签,在末尾加上斜杠。 尽管这样子减少繁杂工作,但是请注意,如果以后有个编辑者移除了第一个引用,后面使用空的ref标签的引用都会丢失。[1]

註釋
  1. 1.0 1.1 1.2 记住当你多次引用相同的脚注时,会使用第一个引用中的文本。
注意name属性使用的标识符必须要有字母字符,仅有数字会产生错误消息。 引号是可以省略的,除非name包含空格、标点或者其他标记。 建议名称保持简单并限制为ASCII字符集。


<span id="The_‎<references />_tag">

‎<references />标签

‎<references />标签会将所有用‎<ref>定义的引用的文本插入在页面的这个位置。 例如,基于上面的引用,note组中应该有引用。

维基文本 结果
<references group="note"/>
  1. 此脚注用作“如何使用”部分中的示例。

引用列表可以有一个响应宽度(部分情况下,显示为多列)。 这种情况下,用responsive属性来配置这个行为。 在使用默认配置的wiki上,这在每个页面都会发生,但是对于其他wiki,你需要手动激活。

如果页面包含多个‎<references />列表,每个列表都会包含在先前的引用列表之后定义的‎<ref>标签。 如果这些引用列表是由模板产生的,每个都会列表在第一个引用列表之前定义的ref标签,因此会产生错误消息,显示有ref标签但是没有引用列表。


分组参考

如有需要,可通过$wgAllowCiteGroups = false;禁用。

以下示例为引用和杂项的脚注生成单独的引用列表:

维基文本 结果
科学家称,太阳很大。<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> 事实上,非常大。<ref group="footnotes"> 相信他们的话。 千万不要直视太阳!</ref>

==註釋==
<references group="footnotes" />

==参考资料==
<references />
科学家称,太阳很大。[1] 事实上,非常大。[footnotes 1]
註釋
  1. 相信他们的话。 千万不要直视太阳!
參考資料
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.

匿名组会像之前的那样运作,而指向命名的组的引用只会显示在指定的‎<references />元素中。

注意group属性使用的标识符必须要有字母字符,仅有数字会产生错误消息。 引号是可以省略的,除非name包含空格、标点或者其他标记。 建议名称保持简单并限制为ASCII字符集。

如需在wiki自定义指定组的渲染,可以创建MediaWiki:Cite_link_label_group-<name>,并按照出现的顺序列举出使用的符号,用空格或新行隔开。

例如,如果MediaWiki:Cite_link_label_group-lower-alpha创建了如下内容

a b c d e f g h i j k l m n o p q r s t u v w x y z

那么第一个<ref group="lower-alpha">...</ref>渲染为[a],第二个渲染为[b],以此类推,第26个渲染为[z]

如果使用超过定义的符号的个数的组,就会发生错误,所以该组内第27个脚注发生错误。

以下组名称通常分别被以下消息定义为自定义组:

组名 消息
upper-alpha MediaWiki:Cite link label group-upper-alpha
lower-alpha MediaWiki:Cite link label group-lower-alpha
upper-roman MediaWiki:Cite link label group-upper-roman
lower-roman MediaWiki:Cite link label group-lower-roman
lower-greek MediaWiki:Cite link label group-lower-greek
默认不会创建Cite link label group页面。 如果wiki没有进行配置,像<ref group="lower-alpha">...</ref>这样的标记就会渲染为lower-alpha 1

引用相同来源的不同部分

在一篇文章中,一个来源的多个部分用作参考时,你可以在引用段落中将其聚集。 这让读者能够识别哪些参考文献来自同一来源。 同时你也能够引用同一个来源的不同部分,而不需要每次重复整个来源。

维基文本 结果
科学家称,太阳很大。<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005).</ref> 事实上,非常大。<ref extends="Miller">p. 123</ref> 相信他们的话。 千万不要直视太阳!<ref extends="Miller">p. 42</ref>

== 參考資料 ==
<references />
科学家称,太阳很大。[1] 事实上,非常大。[1.1] 相信他们的话。 千万不要直视太阳![1.2]
參考資料

1. E. Miller, The Sun, (New York: Academic Press, 2005)
   1.1 ↑ p. 123
   1.2 ↑ p. 42

请注意,此功能尚未在beta cluster之外的wiki上运行,这就是为什么上面的示例是模拟的。 你可以在m:WMDE Technical Wishes/Book referencing上关注此项目。

从文本中拆分参考资料

文内引用可以轻松地将文本复制到另一个页面,另一方面又会使阅读变得困难。 包含大量数据、引述或精心设计的引文模板的参考文献在来源中所占的比例可能比实际可见的文本要大得多。 为了避免这种情况,扩展的最新版本允许将部分或全部引用移动到‎<references />部分,到它们实际出现在读者面前的位置。

维基文本 结果
科学家称,太阳很大。<ref name="miller" /> 然而月亮不大。<ref name="smith" />

<span id="Notes"></span>
==註釋==
<references>
<ref name="miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref>
<ref name="smith">R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>
</references>

科学家称,太阳很大。[1] 然而月亮不大。[2]

注释
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

这样,上面的代码输出的效果和第一个例子相同,尽管参考的标号和顺序并不总是一样的。

替换引用和嵌入解析器函数

由于Cite的‎<ref>标签会在MediaWiki的解析器函数(如{{#ifexpr:…}})、变量(如{{PAGENAME}})或subst:之前解析的,因此在引用参考内不会起效果。 你应该使用魔术字{{#tag:…}}才对。

维基文本 结果
Foo<ref>这不起作用,参见 {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|而这样就会起作用,参见 {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}}} bar baz…
<references />

Foo[1] bar baz… Foo[2] bar baz…

  1. 这不起作用,参见 "Search" . Retrieved on [[{{subst:#time:Y-m-d|now}}]]. 
  2. 而这样就会起作用,参见 "Search" . Retrieved on 2021-03-11. 

在参考列表前添加自动标题

到MediaWiki 1.2.8为止,可以使用系统消息MediaWiki:Cite references prefix来定义在整个wiki范围内的标题,这样标题会自动插入在每个参考列表之前。 在MediaWiki 1.29,这个系统消息移除了。 如果还是想要这样做,可以通过往MediaWiki:Common.js添加以下代码实现:

$(document).ready(function(){
    $('.mw-references-wrap').before('<h2>参考资料</h2>');
});

注意这会无条件添加标题,例如如果你已经有了标题,仍然还会添加,导致创建重复的标题。

如果你只是需要一个文本标题(没有链接或者其他活跃元素),可以往MediaWiki:Common.css中添加以下内容(Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):

.mw-references-wrap::before {
  content: "Blue references";
  color: #0645ad;
  text-decoration: none;
  background: none;
  font-style: italic;
  font-size: 100%;
  font-weight: bold;
  line-height: 1.6;
  direction: ltr;
  font-family: sans-serif;
}

将两个文本合并至一个参考文献中

一个典型的维基文库问题是,引用会占用同一材料的多个页面。 对于第一部分引用,可以通过‎<ref name="name">标签合并,然后使用标签‎<ref follow="name">用相同名称标记后面的部分。

例子:

维基文本 结果
这是将多个文本合并到相同脚注的例子。<ref name="main">记住所有的文本都会包含在含有name="…"属性的参考中。</ref>

<ref follow="main">在带有follow="…"属性的标签内,简单包含额外文本,并符合第一个参考的名称。</ref>

<span id="References"></span>
== 參考資料 ==
<references/>

这是将多个文本合并到相同脚注的例子。[1]


參考資料

  1. 记住所有的文本都会包含在含有name="…"属性的参考中。 在带有follow="…"属性的标签内,简单包含额外文本,并符合第一个参考的名称。

使用这种语法时,注意脚注的follow部分会作为参考的第一部分包含在相同页面。

注意参考的名称不能以数字开头,所以始终要包含一些文本,比如<ref name="p32"><ref follow="p32">


自定义

‎<ref>‎<references>的输出格式是完全可定制的,可以通过MediaWiki消息进行根据wiki配置通过MediaWiki名字空间进行修改。

对于控制‎<ref>‎<references>及其值的输出的消息列表,如果有,参见可以直接从MediaWiki获取的一项实时更新的默认值,这些消息会传入如$1、$2、$3。

不完整列表
  • cite_reference_link_key_with_num
    1. key
    2. num
  • cite_reference_link_prefix
  • cite_reference_link_suffix
  • cite_references_link_prefix
  • cite_references_link_suffix
  • cite_reference_link
    1. ref ID
    2. backlink ID
    3. 显示个数
  • cite_references_link_one
    • 用来格式化‎<references />输出的来源列表,会配置:backlink ID、ref ID和注释文本。
    1. backlink ID — 用来创建来源列表的数字顺序
    2. ref ID — 用来往回链接到文本中的实际参考来源,这里你可以配置^符号。
    3. 注释文本 — 用于描述来源信息的文本
  • cite_references_link_many
    1. backlink ID
    2. list of links
    3. 注释文本
  • cite_references_link_many_format
    1. ref ID
    2. 用作反向链接的数值
    3. 自定义值(cite_references_link_many_format_backlink_labels中定义,用作反向链接)
  • cite_references_link_many_format_backlink_labels
  • cite_references_link_many_sep
  • cite_references_link_many_and
  • cite_references_suffix

设置参考文献使用^和字母

要将默认的向上箭头(↑)替换为^,可修改以下系统消息。 可以在Special:AllMessages找到所有这些页面。

MediaWiki:Cite references link one
<li id="$1"$4><span class="mw-cite-backlink">[[#$2|↑]]</span> $3</li>
<li id="$1"$4><span class="mw-cite-backlink">[[#$2|^]]</span> $3</li>
MediaWiki:Cite references link many
<li id="$1"$4><span class="mw-cite-backlink">↑ $2</span> $3</li>
<li id="$1"$4><span class="mw-cite-backlink">^ $2</span> $3</li>
MediaWiki:Cite references link many format

将$2替换为$3会将1.0、1.1、1.2这样的链接替换为a、b、c等…

<sup>[[#$1|$2]]</sup>
<sup>[[#$1|$3]]</sup>

第一次搜索这些页面会没有任何匹配。 简单创建“创建此页面”来编辑代码。 这个改变不会生效,直到带有引用的页面被重建。

设置参考和参考编号突出显示

MediaWiki 1.26 开始,用于突出显示的选择器包含在Cite/modules/ext.cite.css中了。 因此不需要手动加入下面的这个CSS代码。

将以下代码添加到MediaWiki:Common.css页面、

/* 使得Cite扩展参考列表变小一些,并将点击的参考资料突出显示为蓝色。 */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }

受损参考

如果不恰当使用‎<ref>‎<references />标签,Cite扩展就会给页面添加一个错误消息,并加入到“有参考文献错误的页面”分类。 这些错误消息将以用户界面语言显示在文章内容或参考部分中。 例如:

维基文本 结果
这是参考资料错误消息的一个例子。<ref broken>预期文本。</ref>

==註釋==
<references />

这是参考资料错误消息的一个例子。Cite error: Invalid <ref> tag; invalid names, e.g. too many

註釋

参见Parsoid引用错误表示的规范

參見