引用可以让你在一个页面中加入脚注,这是求闻百科实现参考资料的基本方式。这是由MediaWiki的Cite扩展提供的。
用法
<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 />
同一脚注的多种用法
如要给脚注一个单独的标识符,请使用name
属性。你可以使用带有这个name的ref标签来复用统一脚注。第二个标签内的文本不起作用,因为文本已存在与第一个引用中。你可以复制整个脚注,或者直接使用自我闭合的标签:<ref name="name" />
。
在下面的例子中,相同的来源引用了三次。
这是多个参考使用一个脚注的例子。<ref name="multiple">记住当你多次引用相同的脚注时,会使用第一个引用中的文本。</ref>
有多个语句来自相同来源时,这样引用来源会十分有用。<ref name="multiple" /> 任何复用标签都不应该包含额外文本,否则会产生错误。 仅使用空标签。
进行多次引用的简洁方法是使用空的ref标签,在末尾加上斜杠。
尽管这样子减少繁杂工作,但是请注意,如果以后有个编辑者移除了第一个引用,后面使用空的ref标签的引用都会丢失。<ref name="multiple" />
== 註釋 ==
<references />

<references />
标签
<references />
标签会将所有用<ref>
定义的引用的文本插入在页面的这个位置。
例如,基于上面的引用,note组中应该有引用。
<references group="note"/>
- ↑ 此脚注用作“如何使用”部分中的示例。
在求闻百科,你可以使用模板链接:{{reflist}}模板来显示长的引用。引用的内容会自动分栏。
如果页面包含多个<references />
列表,每个列表都会包含在先前的引用列表之后定义的<ref>
标签。如果这些引用列表是由模板产生的,每个都会列表在第一个引用列表之前定义的ref标签,因此会产生错误消息,显示有ref标签但是没有引用列表。
分组参考
以下示例为引用和杂项的脚注生成单独的引用列表:
科学家称,太阳很大。<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> 事实上,非常大。<ref group="footnotes"> 相信他们的话。 千万不要直视太阳!</ref>
== 註釋 ==
<references group="footnotes" />
== 参考资料 ==
<references />
科学家称,太阳很大。[1] 事实上,非常大。[footnotes 1]
- ↑ 相信他们的话。 千万不要直视太阳!
- ↑ E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
匿名组会像之前的那样运作,而指向命名的组的引用只会显示在指定的<references />
元素中。

如需在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 |

<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
从文本中拆分参考资料
文内引用可以轻松地将文本复制到另一个页面,另一方面又会使阅读变得困难。包含大量数据、引述或精心设计的引文模板的参考文献在来源中所占的比例可能比实际可见的文本要大得多。为了避免这种情况,扩展程序允许将部分或全部引用移动到<references />
部分,到它们实际出现在读者面前的位置。
科学家称,太阳很大。<ref name="miller" /> 然而月亮不大。<ref name="smith" />
== 註釋 ==
<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>
这样,上面的代码输出的效果和第一个例子相同,尽管参考的标号和顺序并不总是一样的。
替换引用和嵌入解析器函数
由于Cite扩展程序的<ref>
标签是在MediaWiki的解析器函数和变量或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 />
将两个文本合并至一个参考文献中
有时候引用会占用同一材料的多个页面。对于第一部分引用,可以通过<ref name="name">...</ref>
标签合并,然后使用标签<ref follow="name">...</ref>
用相同名称标记后面的部分。
例子:
这是将多个文本合并到相同脚注的例子。<ref name="main">记住所有的文本都会包含在含有name="…"属性的参考中。</ref>
<ref follow="main">在带有follow="…"属性的标签内,简单包含额外文本,并符合第一个参考的名称。</ref>
== 參考資料 ==
<references/>
使用这种语法时,注意脚注的follow部分会作为参考的第一部分包含在相同页面。
注意参考的名称不能以数字开头,所以始终要包含一些文本,比如<ref name="p32">
和<ref follow="p32">
。
自定义
<ref>
和<references>
的输出格式是完全可定制的,可以通过MediaWiki消息进行根据wiki配置通过MediaWiki命名空间进行修改。
- 不完整列表
cite_reference_link_key_with_num
- key
- num
cite_reference_link_prefix
cite_reference_link_suffix
cite_references_link_prefix
cite_references_link_suffix
cite_reference_link
- ref ID
- backlink ID
- 显示个数
cite_references_link_one
- 用来格式化
<references />
输出的来源列表,会配置:backlink ID、ref ID和注释文本。
- backlink ID — 用来创建来源列表的数字顺序
- ref ID — 用来往回链接到文本中的实际参考来源,这里你可以配置
^
符号。 - 注释文本 — 用于描述来源信息的文本
- 用来格式化
cite_references_link_many
- backlink ID
- list of links
- 注释文本
cite_references_link_many_format
- ref ID
- 用作反向链接的数值
- 自定义值(
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找到。
从 | 至 |
---|---|
<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>
|
从 | 至 |
---|---|
<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>
|
将$2替换为$3会将1.0、1.1、1.2这样的链接替换为a、b、c等…
从 | 至 |
---|---|
<sup>[[#$1|$2]]</sup>
|
<sup>[[#$1|$3]]</sup>
|
第一次搜索这些页面会没有任何匹配。简单创建“创建此页面”来编辑代码。这个改变不会生效,直到带有引用的页面被重建。
受损参考
如果不恰当使用<ref>
和<references />
标签,Cite扩展就会给页面添加一个错误消息,并加入到“有参考资料错误的页面”分类。这些错误消息将以用户界面语言显示在文章内容或参考部分中。例如:
这是参考资料错误消息的一个例子。<ref broken>预期文本。</ref>
== 註釋 ==
<references />
这是参考资料错误消息的一个例子。引证错误:<ref>
标签无效;name(名称)无效,例如有多个name
参见
- mw:Help:Cite/zh:本页来源