帮助:注脚

来自理想城计划
（重定向自模板:Reflist/doc）
这个页面“帮助:注脚”是理想城计划的帮助文档
  • 本文用于介绍理想城计划中一些特定功能的操作方法；
  • 本文仅是一篇论述，不属于方针或指引。如果本指南与相关方针或指引发生冲突或存在不一致的情况，请以方针或指引的条文为准。

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

用法

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

例子如下：

科学家说，太阳是挺大的<ref>张三（2005年）：《太阳》，第23页，香港：学术出版社。</ref>。

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

== 注释 ==
{{reflist}}

显示效果：

科学家说，太阳是挺大的[1]。

不过，月亮就没有那么大了[2]。

注释
  1. ↑ 张三（2005年）：《太阳》，第23页，香港：学术出版社。
  2. ↑ 李四：《月亮的大小》，载《科学选辑》第46期，第78页，北京：科学研究社。

需要注意的是，使用本模板时若注释内容含有=、|等会被解析为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]。

注释
  1. ↑ 1.0 1.1 1.2 请谨记，多次使用同一项注脚，系统只会参照第一次的注脚文字。
引用错误：无效<ref>标签；name属性“multiple”使用不同内容定义了多次


注意：

  • name属性不能是单一的数字。
  • name属性对大小写和繁简都敏感。
  • 删除多项注脚的第一项标签的时候，应当特别留意，以免影响文章后段的一切注脚连结。

参注分组

为了让注释和参考文献的排列更加有条理，推荐将参考和注释分开来为两组。继续使用{{refn|文本}}来表示参考文献，而使用使用{{note|文本}}来表示注释（此处相当于{{refn|group=注|文本}}）。例如：

AAA{{refn|参考a}}BBB{{note|注b}}CCC{{refn|参考c}}
----
;参考文献注脚：
{{reflist}}
;注释注脚：
{{notelist}}

则会显示成：

AAA[1]BBB[注 1]CCC[2]

参考文献注脚：
  1. ↑ 参考a
  2. ↑ 参考c
注释注脚：
  1. ↑ 注b

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

参注分组 标注模板 对应的列表模板 标注效果 备注
参考 <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=分组名称}}便可把该组的注脚显示。

  1. ↑ 文本

以下例子使用了两组注脚：

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" />

则会显示成：

AAA[A 1]BBB[B 1]CCC[A 2]

A组注脚：
  1. ↑ 参考a
  2. ↑ 参考c
B组注脚：
  1. ↑ 注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>

则会显示成：

AAA[1]BBB[2]CCC[1]

注脚：
  1. ↑ 1.0 1.1 foo
  2. ↑ bar

相关模板

{{注解}}

该模板可以将需要注解的文字高亮化，并在鼠标悬停于文字时显示注解（PC版）或在右上角显示注解（移动版）。例如： 

-{}-[[更新姬]]没有{{注解|欧派|胸部}}。

更新姬没有欧派(注）胸部。

注意：

  • 注解部分仅能使用纯文本而不能带有wikitext或HTML格式。
  • 如果注解部分过长，在移动版的显示效果可能较差。
  • 该模板的注解不会在<references />中列出。

因此，一般来说请优先使用上文的ref形式，尤其是想在注释中使用格式或注释部分过长时。

{{refer}}

该模板为特性介于{{注解}}和<ref>标签之间的注解模板，需配合{{references}}使用。例如： 

-{}-[[更新姬]]没有{{refer|欧派|胸部}}。
{{references}}

更新姬没有欧派'"`UNIQ--finalizedvar-0--QINU`"'1'"`UNIQ--finalizedvar-1--QINU`"'。

Lua错误 在模块:Loop的第98行：必须设置自增/自减的变量名！

1. 胸部

模板中还提供了更多可定制内容，用于不能使用原生注脚的情形。

Cite系列模板

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

取自“https://test1.gjcloak.xyz/index.php?title=帮助:注脚&oldid=555”