查看“帮助:注脚”的源代码

{{帮助}}

'''注脚'''是一种标明资料来源、为文章补充注解的方法。注脚一般会在文章内以符号或数字标示出来，然后在文章末端（也就是文章的「脚」的部位），列出所有的补充信息，以及资料来源的详情。注脚能使编者在保持版面整洁之余，得以补充细节，且不影响行文的聚焦。

==用法==
*开始标签<code><nowiki><ref></nowiki></code>和结束标签<code><nowiki></ref></nowiki></code>之间的文字，会集中在使用模板<code><nowiki>{{reflist}}</nowiki></code>的地方列出。若没有<code><nowiki>{{reflist}}</nowiki></code>，则所有注脚会被显示在条目页面的结尾。
*您正在阅读的这个页面就使用了注脚，会显示成这样子：<ref>这是用法一段的注脚。</ref>，查阅本页的原始码就可以看见使用注脚功能的实例。
<div style="display:none;"><references /></div>
*<code><nowiki><ref></nowiki></code>标签内无法使用模板subst语法，而且也不能嵌套<code><nowiki><ref></nowiki></code>标签，所以往往也使用<code><nowiki>{{refn}}</nowiki></code>来替代。两者的使用方式完全相同，仅仅是两种不同写法的差异，编者可以自由选择其中之一。

例子如下：

<div class="toccolours" style="border:1px dotted #296dad;padding:1em"><tt>
科学家说，太阳是挺大的<span style="background-color: #FFFF66">'''&lt;ref>'''张三（2005年）：《太阳》，第23页，香港：学术出版社。'''&lt;/ref>'''</span>。
<br />
<br /> 
不过，月亮就没有那么大了<span style="background-color: #FFFF66">'''<nowiki>{{refn|</nowiki>'''李四：《月亮的大小》，载《科学选辑》第46期，第78页，北京：科学研究社。'''<nowiki>}}</nowiki>'''</span>。
<br />
<br />
&#61;= 注释 ==<br />
<span style="background-color: #FFFF66">'''<nowiki>{{reflist}}</nowiki>'''</span>
</tt></div>

显示效果：
<div class="toccolours" style="float:none; padding:0.3em 1em;"> 
科学家说，太阳是挺大的<ref>张三（2005年）：《太阳》，第23页，香港：学术出版社。</ref>。

不过，月亮就没有那么大了{{refn|李四：《月亮的大小》，载《科学选辑》第46期，第78页，北京：科学研究社。}}。

<div style="BACKGROUND: none transparent scroll repeat 0% 0%; PADDING-BOTTOM: 0.17em; MARGIN: 0px; COLOR: black; PADDING-TOP: 0.5em; BORDER-BOTTOM: #aaa 1px solid;FONT-SIZE:150%;FONT-WEIGHT:bold;MARGIN-BOTTOM:0.6em">注释</div>
{{reflist}}
</div>
需要注意的是，使用本模板时若注释内容含有<code>=</code>、<code>|</code>等会被解析为wikitext的符号时，请使用<code><nowiki>{{=}}</nowiki></code>、<code><nowiki>{{!}}</nowiki></code>等辅助模板替换此类符号，或是改用<code><nowiki><ref></ref></nowiki></code>标签。

===多处标明同一项注脚===
如果想多处标明同一项注脚，请用<code><nowiki>{{refn|name=Example|...}}</nowiki></code> 代替<code><nowiki><ref></nowiki></code>，Example是该注脚的名称。文章后段如果需要参照同一个注脚，您只需再次输入带有Example的注脚就可以了，第二个和以后的注脚里面写的东西不仅不会显示出来，还会导致系统报错。'''在末端输入斜线可产生空标签'''：<code><nowiki>{{refn|name=Example}}</nowiki></code>。

以下例子使用了同一项注脚三次：

<div class="toccolours" style="border:1px dotted #296dad;padding:1em"><tt>
这是多处标明同一项注脚的例子<span style="background-color: #FFFF66">'''<nowiki>{{refn|name=multiple|</nowiki>'''请谨记，多次使用同一项注脚，系统只会参照第一次的注脚文字。'''<nowiki>}}</nowiki>'''</span>。
<br />
<br />
这种方法可以表明，同一项注释作出了多项表述<span style="background-color: #FFFF66">'''<nowiki>{{refn|name=multiple|</nowiki>'''这裡写的字是多馀的，不仅哪裡都不会显示，还会导致报错文本出现呦。'''<nowiki>}}</nowiki>'''</span>。
<br />
<br />
不填写文本参数即可<span style="background-color: #FFFF66">'''<nowiki>{{refn|name=multiple}}</nowiki>'''</span>。
<br />
<br />
&#61;= 注释 ==
<br />
<span style="background-color: #FFFF66"><nowiki>{{reflist}}</nowiki>'''</span>
</tt></div>


上述文字码会显示成：
<div class="toccolours" style="float:none; padding:0.3em 1em;"> 
这是多处标明同一项注脚的例子{{refn|name=multiple|请谨记，多次使用同一项注脚，系统只会参照第一次的注脚文字。}}。

这种方法可以表明，同一项注释作出了多项表述{{refn|name=multiple|<!--这裡写的字是多馀的，不仅哪裡都不会显示，还会导致报错文本出现呦。-->}}。

不填写文本参数即可{{refn|name=multiple}}。

<div style="BACKGROUND: none transparent scroll repeat 0% 0%; PADDING-BOTTOM: 0.17em; MARGIN: 0px; COLOR: black; PADDING-TOP: 0.5em; BORDER-BOTTOM: #aaa 1px solid;FONT-SIZE:150%;FONT-WEIGHT:bold;MARGIN-BOTTOM:0.6em">注释</div>
<references /><span class="error mw-ext-cite-error" lang="zh" dir="ltr">引用错误：无效<code>&lt;ref&gt;</code>标签；name属性“multiple”使用不同内容定义了多次</span>
</div>


<b style="color:#FF0000;">注意：</b>
*name属性不能是单一的数字。
*name属性对大小写和繁简都敏感。
*删除多项注脚的第一项标签的时候，应当特别留意，以免影响文章后段的一切注脚连结。

===参注分组===
为了让注释和参考文献的排列更加有条理，推荐将参考和注释分开来为两组。继续使用<code><nowiki>{{refn|文本}}</nowiki></code>来表示参考文献，而使用使用<code><nowiki>{{note|文本}}</nowiki></code>来表示注释（此处相当于<code><nowiki>{{refn|group=注|文本}}</nowiki></code>）。例如：
<div class="toccolours" style="border:1px dotted #296dad;padding:1em"><tt>
AAA<span style="background-color:#FFFF66"><nowiki>{{refn|</nowiki>参考a<nowiki>}}</nowiki></span>BBB<span style="background-color:#bbddff"><nowiki>{{note|</nowiki>注b<nowiki>}}</nowiki></span>CCC<span style="background-color: #FFFF66"><nowiki>{{refn|</nowiki>参考c<nowiki>}}</nowiki></span>
<br /><nowiki>----</nowiki>
<br /><nowiki>;</nowiki>参考文献注脚：
<br /><span style="background-color:#FFFF66"><nowiki>{{reflist}}</nowiki></span>
<br /><nowiki>;</nowiki>注释注脚：
<br /><span style="background-color:#bbddff"><nowiki>{{notelist}}</nowiki></span>
</tt></div>
则会显示成：
<div class="toccolours" style="float:none; padding:0.3em 1em;">
AAA{{refn|参考a}}BBB{{note|注b}}CCC{{refn|参考c}}
----
;参考文献注脚：
{{reflist}}
;注释注脚：
{{notelist}}</div>

以下为相关模板及其功能的参考：

{| class="wikitable"
|- style="vertical-align:top;"
! 参注分组 !! 标注模板 !! 对应的列表模板 !! 标注效果 !! 备注
|-
| 参考|| <code><nowiki><ref>..</ref></nowiki></code><br />{{tl|Ref}}={{tl|Refn}}={{tl|Refnest}}={{tl|RefTag}}|| {{tl|Reflist}}={{tl|RefFoot}}={{tl|refs}}|| {{dummy ref|1}}{{dummy ref|2}}{{dummy ref|3}}|| <code><nowiki><ref></nowiki></code>标签本身无法进行嵌套
|-
| 注解|| {{tl|Note}}={{tl|NoteTag}} || {{tl|Notelist}}={{tl|NoteFoot}}={{tl|notes}} || {{dummy ref|注 1}}{{dummy ref|注 2}}{{dummy ref|注 3}}|| 
|}

也可以自定义分组的数量和名称。使用<code>-{}-<nowiki>{{refn|</nowiki>group=分组名称|文本<nowiki>}}</nowiki></code>，group是该注脚的组别，显示成这样<ref group="分组名称">文本</ref>。而使用<code>-{}-<nowiki>{{reflist|</nowiki>group=分组名称<nowiki>}}</nowiki></code>便可把该组的注脚显示。
<div style="display:none;"><references group="分组名称" /></div>
以下例子使用了两组注脚：
<div class="toccolours" style="border:1px dotted #296dad;padding:1em"><tt>
AAA<span style="background-color:#FFFF66">&lt;ref group="A">参考a&lt;/ref></span>BBB<span style="background-color:#bbddff">&lt;ref group="B">注b&lt;/ref></span>CCC<span style="background-color: #FFFF66">&lt;ref group="A">参考c&lt;/ref></span>
<br /><nowiki>----</nowiki>
<br /><nowiki>;</nowiki>A组注脚：
<br /><span style="background-color:#FFFF66"><nowiki><references group="A" /></nowiki></span>
<br /><nowiki>;</nowiki>B组注脚：
<br /><span style="background-color:#bbddff"><nowiki><references group="B" /></nowiki></span>
</tt></div>
则会显示成：
<div class="toccolours" style="float:none; padding:0.3em 1em;">
AAA<ref group="A">参考a</ref>BBB<ref group="B">注b</ref>CCC<ref group="A">参考c</ref>
----
;A组注脚：
<references group="A" />
;B组注脚：
<references group="B" />
</div>


<span style="color:#FF0000;">'''注意'''：</span>
*group属性对大小写和繁简都敏感。
*使用{{tl|note}}或自定义分组时必须同时使用对应的列表模板，否则会报引用错误。

===注脚文本写在列表区===

如果希望在注脚列表区（通常位于注释章节）编辑注脚文本，而不是在条目正文的<code><nowiki><ref></nowiki></code>处书写，可以使用带name属性的<code><nowiki><ref></nowiki></code>标签。

即在需要注释的地方用<code><nowiki><ref name="x1" /></nowiki></code>，同时在参考文献章节使用
<pre><references>
<ref name="x1">foo</ref>
<ref name="x2">foo</ref>
……
</references></pre>
便实现注脚集中书写。

每一个<code><nowiki><ref></nowiki></code>的name值要取一个唯一的名字，除非是需要多处标明同一项注脚。

以下例子使用了两组注脚：
<div class="toccolours" style="border:1px dotted #296dad;padding:1em"><tt>
AAA<span style="background-color:#FFFF66">&lt;ref name="ref1" /></span>BBB<span style="background-color:#bbddff">&lt;ref name="ref2" /></span>CCC<span style="background-color: #FFFF66">&lt;ref name="ref1" /></span>
<br /><nowiki>----</nowiki>
<br /><nowiki>;</nowiki>注脚：
<br /><span style="background-color:#FFFF66"><nowiki><references></nowiki>
<br /><nowiki><ref name="ref1">foo</ref></nowiki>
<br /><nowiki><ref name="ref2">bar</ref></nowiki><br />
<nowiki></references></nowiki></span>
</tt></div>
则会显示成：
<div class="toccolours" style="float:none; padding:0.3em 1em;">
AAA<ref name="ref1"/>BBB<ref name="ref2"/>CCC<ref name="ref1"/>
----
;注脚：
<references>
<ref name="ref1">foo</ref>
<ref name="ref2">bar</ref>
</references>
</div>

== 相关模板 ==
=== {{tl|注解}} ===
该模板可以将需要注解的文字高亮化，并在鼠标悬停于文字时显示注解（PC版）或在右上角显示注解（移动版）。例如：
<blockquote>
<pre>-{}-[[更新姬]]没有{{注解|欧派|胸部}}。</pre>
[[更新姬]]没有{{注解|欧派|胸部}}。
</blockquote>
注意：
*注解部分仅能使用纯文本而不能带有wikitext或HTML格式。
*如果注解部分过长，在移动版的显示效果可能较差。
*该模板的注解不会在<code><nowiki><references /></nowiki></code>中列出。
因此，一般来说请优先使用上文的ref形式，尤其是想在注释中使用格式或注释部分过长时。

=== {{tl|refer}} ===
该模板为特性介于{{tl|注解}}和&lt;ref&gt;标签之间的注解模板，需配合{{tl|references}}使用。例如：
<blockquote>
<pre>-{}-[[更新姬]]没有{{refer|欧派|胸部}}。
{{references}}</pre>
[[更新姬]]没有{{refer|欧派|胸部}}。
{{references}}
</blockquote>
模板中还提供了更多可定制内容，用于不能使用原生注脚的情形。

=== Cite系列模板 ===
源自维基百科的一系列来源注释模板，包括{{tl|Cite web}}、{{tl|Cite news}}、{{tl|Cite book}}、{{tl|Cite journal}}等，用在ref标签内部，具体用法详见各模板文档。这些模板可以以整齐、统一的格式显示来源信息，在来源较多或条目比较严肃时利于使用，不过需要填写的参数较为复杂，目前并不强制使用或推广。