Template:Ref
模板文档 |
本模板全部或部分內容原来自中文维基百科页面Help:注脚，依 CC BY-SA 3.0 授权引入；原贡献者可以在这里看到。 |
注脚是一种标明资料来源、为文章补充注解的方法。注脚一般会在文章内以符号或数字标示出来，然后在文章末端（也就是文章的「脚」的部位），列出所有的补充信息，以及资料来源的详情。注脚能使编者在保持版面整洁之余，得以补充细节，且不影响行文的聚焦。
用法
- 开始标签
<ref>和结束标签</ref>之间的文字，会集中在使用模板{{reflist}}的地方列出。若没有{{reflist}}，则所有注脚会被显示在条目页面的结尾。 - 您正在阅读的这个页面就使用了注脚，会显示成这样子：[1]，查阅本页的原始码就可以看见使用注脚功能的实例。
<ref>标签内无法使用模板subst语法，而且也不能嵌套<ref>标签，所以往往也使用{{refn}}来替代。两者的使用方式完全相同，仅仅是两种不同写法的差异，编者可以自由选择其中之一。
例子如下：
科学家说，太阳是挺大的<ref>张三（2005年）：《太阳》，第23页，香港：学术出版社。</ref>。
不过，月亮就没有那么大了{{refn|李四：《月亮的大小》，载《科学选辑》第46期，第78页，北京：科学研究社。}}。
== 注释 ==
{{reflist}}
显示效果：
需要注意的是，使用本模板时若注释内容含有=、|等会被解析为wikitext的符号时，请使用{{=}}、{{!}}等辅助模板替换此类符号，或是改用<ref></ref>标签。
多处标明同一项注脚
如果想多处标明同一项注脚，请用{{refn|name=Example|...}} 代替<ref>，Example是该注脚的名称。文章后段如果需要参照同一个注脚，您只需再次输入带有Example的注脚就可以了，第二个和以后的注脚里面写的东西不仅不会显示出来，还会导致系统报错。在末端输入斜线可产生空标签：{{refn|name=Example}}。
以下例子使用了同一项注脚三次：
这是多处标明同一项注脚的例子{{refn|name=multiple|请谨记，多次使用同一项注脚，系统只会参照第一次的注脚文字。}}。
这种方法可以表明，同一项注释作出了多项表述{{refn|name=multiple|这裡写的字是多馀的，不仅哪裡都不会显示，还会导致报错文本出现呦。}}。
不填写文本参数即可{{refn|name=multiple}}。
== 注释 ==
{{reflist}}
上述文字码会显示成：
这是多处标明同一项注脚的例子[1]。
这种方法可以表明，同一项注释作出了多项表述[1]。
不填写文本参数即可[1]。
<ref>标签；name属性“multiple”使用不同内容定义了多次
注意：
- name属性不能是单一的数字。
- name属性对大小写和繁简都敏感。
- 删除多项注脚的第一项标签的时候，应当特别留意，以免影响文章后段的一切注脚连结。
参注分组
为了让注释和参考文献的排列更加有条理，推荐将参考和注释分开来为两组。继续使用{{refn|文本}}来表示参考文献，而使用使用{{note|文本}}来表示注释（此处相当于{{refn|group=注|文本}}）。例如：
AAA{{refn|参考a}}BBB{{note|注b}}CCC{{refn|参考c}}
----
;参考文献注脚：
{{reflist}}
;注释注脚：
{{notelist}}
则会显示成：
以下为相关模板及其功能的参考：
| 参注分组 | 标注模板 | 对应的列表模板 | 标注效果 | 备注 |
|---|---|---|---|---|
| 参考 | <ref>..</ref>{{Ref}}={{Refn}}={{Refnest}}={{RefTag}} |
{{Reflist}}={{RefFoot}}={{refs}} | [1][2][3] | <ref>标签本身无法进行嵌套
|
| 注解 | {{Note}}={{NoteTag}} | {{Notelist}}={{NoteFoot}}={{notes}} | [注 1][注 2][注 3] |
也可以自定义分组的数量和名称。使用{{refn|group=分组名称|文本}}，group是该注脚的组别，显示成这样[分组名称 1]。而使用{{reflist|group=分组名称}}便可把该组的注脚显示。
以下例子使用了两组注脚：
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" />
则会显示成：
注意：
- group属性对大小写和繁简都敏感。
- 使用{{note}}或自定义分组时必须同时使用对应的列表模板，否则会报引用错误。
注脚文本写在列表区
如果希望在注脚列表区（通常位于注释章节）编辑注脚文本，而不是在条目正文的<ref>处书写，可以使用带name属性的<ref>标签。
即在需要注释的地方用<ref name="x1" />，同时在参考文献章节使用
<references> <ref name="x1">foo</ref> <ref name="x2">foo</ref> …… </references>
便实现注脚集中书写。
每一个<ref>的name值要取一个唯一的名字，除非是需要多处标明同一项注脚。
以下例子使用了两组注脚：
AAA<ref name="ref1" />BBB<ref name="ref2" />CCC<ref name="ref1" />
----
;注脚：
<references>
<ref name="ref1">foo</ref>
<ref name="ref2">bar</ref>
</references>
则会显示成：
相关模板
{{注解}}
该模板可以将需要注解的文字高亮化，并在鼠标悬停于文字时显示注解（PC版）或在右上角显示注解（移动版）。例如：
[[更新姬]]没有{{注解|欧派|胸部}}。更新姬没有欧派(注)胸部。
注意：
- 注解部分仅能使用纯文本而不能带有wikitext或HTML格式。
- 如果注解部分过长，在移动版的显示效果可能较差。
- 该模板的注解不会在
<references />中列出。
因此，一般来说请优先使用上文的ref形式，尤其是想在注释中使用格式或注释部分过长时。
{{refer}}
该模板为特性介于{{注解}}和<ref>标签之间的注解模板，需配合{{references}}使用。例如：
[[更新姬]]没有{{refer|欧派|胸部}}。 {{references}}更新姬没有欧派1。
1. 胸部
模板中还提供了更多可定制内容，用于不能使用原生注脚的情形。
Cite系列模板
源自维基百科的一系列来源注释模板，包括{{Cite web}}、{{Cite news}}、{{Cite book}}、{{Cite journal}}等，用在ref标签内部，具体用法详见各模板文档。这些模板可以以整齐、统一的格式显示来源信息，在来源较多或条目比较严肃时利于使用，不过需要填写的参数较为复杂，目前并不强制使用或推广。